[mirror_edk2.git] / SecurityPkg / Library / TcgStorageOpalLib / TcgStorageOpalCore.c

/** @file\r
  Public API for Opal Core library.\r
\r
Copyright (c) 2016 - 2018, 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 <Uefi.h>\r
#include <Library/BaseLib.h>\r
#include <Library/TimerLib.h>\r
#include <Library/BaseMemoryLib.h>\r
#include <Library/DebugLib.h>\r
#include <Library/TcgStorageOpalLib.h>\r
\r
#include "TcgStorageOpalLibInternal.h"\r
\r
#pragma pack(1)\r
typedef struct {\r
    UINT8 HardwareReset : 1;\r
    UINT8 Reserved : 7;\r
} TCG_BLOCK_SID_CLEAR_EVENTS;\r
#pragma pack()\r
\r
#define TRUSTED_COMMAND_TIMEOUT_NS      ((UINT64) 5 * ((UINT64)(1000000)) * 1000) // 5 seconds\r
#define BUFFER_SIZE                      512\r
\r
/**\r
  The function performs a Trusted Send of a Buffer containing a TCG_COM_PACKET.\r
\r
  @param[in]      Sscp                  The input Ssc Protocol.\r
  @param[in]      MediaId               The input Media id info used by Ssc Protocol.\r
  @param[in]      SecurityProtocol      Security Protocol\r
  @param[in]      SpSpecific            Security Protocol Specific\r
  @param[in]      TransferLength        Transfer Length of Buffer (in bytes) - always a multiple of 512\r
  @param[in]      Buffer                Address of Data to transfer\r
  @param[in]      BufferSize            Full Size of Buffer, including space that may be used for padding.\r
\r
**/\r
TCG_RESULT\r
OpalTrustedSend(\r
  EFI_STORAGE_SECURITY_COMMAND_PROTOCOL  *Sscp,\r
  UINT32                                 MediaId,\r
  UINT8                                  SecurityProtocol,\r
  UINT16                                 SpSpecific,\r
  UINTN                                  TransferLength,\r
  VOID                                   *Buffer,\r
  UINTN                                  BufferSize\r
  )\r
{\r
  UINTN       TransferLength512;\r
  EFI_STATUS  Status;\r
\r
  //\r
  // Round transferLength up to a 512-byte multiple\r
  //\r
  TransferLength512 = (TransferLength + 511) & ~(UINTN)511;\r
\r
  if (TransferLength512 > BufferSize) {\r
    return TcgResultFailureBufferTooSmall;\r
  }\r
\r
  ZeroMem((UINT8*)Buffer + TransferLength, TransferLength512 - TransferLength);\r
\r
  Status = Sscp->SendData(\r
               Sscp,\r
               MediaId,\r
               TRUSTED_COMMAND_TIMEOUT_NS,\r
               SecurityProtocol,\r
               SwapBytes16(SpSpecific),\r
               TransferLength512,\r
               Buffer\r
               );\r
\r
  return Status == EFI_SUCCESS ? TcgResultSuccess : TcgResultFailure;\r
}\r
\r
/**\r
\r
  The function performs a Trusted Receive of a Buffer containing a TCG_COM_PACKET.\r
\r
  @param[in]      Sscp                  The input Ssc Protocol.\r
  @param[in]      MediaId               The input Media id info used by Ssc Protocol.\r
  @param[in]      SecurityProtocol      Security Protocol\r
  @param[in]      SpSpecific            Security Protocol Specific\r
  @param[in]      Buffer                Address of Data to transfer\r
  @param[in]      BufferSize            Full Size of Buffer, including space that may be used for padding.\r
  @param[in]      EstimateTimeCost      Estimate the time needed.\r
\r
**/\r
TCG_RESULT\r
OpalTrustedRecv(\r
  EFI_STORAGE_SECURITY_COMMAND_PROTOCOL  *Sscp,\r
  UINT32                                 MediaId,\r
  UINT8                                  SecurityProtocol,\r
  UINT16                                 SpSpecific,\r
  VOID                                   *Buffer,\r
  UINTN                                  BufferSize,\r
  UINT32                                 EstimateTimeCost\r
  )\r
{\r
  UINTN           TransferLength512;\r
  UINT32          Tries;\r
  TCG_COM_PACKET  *ComPacket;\r
  UINT32          Length;\r
  UINT32          OutstandingData;\r
  EFI_STATUS      Status;\r
  UINTN           TransferSize;\r
\r
  //\r
  // Round Buffer Size down to a 512-byte multiple\r
  //\r
  TransferLength512 = BufferSize & ~(UINTN)511;\r
  Tries = 0;\r
  ComPacket = NULL;\r
  Length = 0;\r
  OutstandingData = 0;\r
\r
  if (TransferLength512 < sizeof(TCG_COM_PACKET)) {\r
    DEBUG ((DEBUG_INFO, "transferLength %u too small for ComPacket\n", TransferLength512));\r
    return TcgResultFailureBufferTooSmall;\r
  }\r
\r
  //\r
  // Some devices respond with Length = 0 and OutstandingData = 1 to indicate that processing is not yet completed,\r
  // so we need to retry the IF-RECV to get the actual Data.\r
  // See TCG Core Spec v2 Table 45 IF-RECV ComPacket Field Values Summary\r
  // This is an arbitrary number of retries, not from the spec.\r
  //\r
  // if user input estimate time cost(second level) value bigger than 10s, base on user input value to wait.\r
  // Else, Use a max timeout of 10 seconds to wait, 5000 tries * 2ms = 10s\r
  //\r
  if (EstimateTimeCost > 10) {\r
    Tries = EstimateTimeCost * 500; // 500 = 1000 * 1000 / 2000;\r
  } else {\r
    Tries = 5000;\r
  }\r
  while ((Tries--) > 0) {\r
    ZeroMem( Buffer, BufferSize );\r
    TransferSize = 0;\r
\r
    Status = Sscp->ReceiveData(\r
                 Sscp,\r
                 MediaId,\r
                 TRUSTED_COMMAND_TIMEOUT_NS,\r
                 SecurityProtocol,\r
                 SwapBytes16(SpSpecific),\r
                 TransferLength512,\r
                 Buffer,\r
                 &TransferSize\r
             );\r
    if (EFI_ERROR (Status)) {\r
      return TcgResultFailure;\r
    }\r
\r
    if (SecurityProtocol != TCG_OPAL_SECURITY_PROTOCOL_1 && SecurityProtocol != TCG_OPAL_SECURITY_PROTOCOL_2) {\r
      return TcgResultSuccess;\r
    }\r
\r
    if (SpSpecific == TCG_SP_SPECIFIC_PROTOCOL_LEVEL0_DISCOVERY) {\r
      return TcgResultSuccess;\r
    }\r
\r
    ComPacket = (TCG_COM_PACKET*) Buffer;\r
    Length = SwapBytes32(ComPacket->LengthBE);\r
    OutstandingData = SwapBytes32( ComPacket->OutstandingDataBE );\r
\r
    if (Length != 0 && OutstandingData == 0) {\r
      return TcgResultSuccess;\r
    }\r
\r
    //\r
    // Delay for 2 ms\r
    //\r
    MicroSecondDelay (2000);\r
  }\r
\r
  return TcgResultFailure;\r
}\r
\r
/**\r
  The function performs send, recv, check comIDs, check method status action.\r
\r
  @param[in]      Session           OPAL_SESSION related to this method..\r
  @param[in]      SendSize          Transfer Length of Buffer (in bytes) - always a multiple of 512\r
  @param[in]      Buffer            Address of Data to transfer\r
  @param[in]      BufferSize        Full Size of Buffer, including space that may be used for padding.\r
  @param[in]      ParseStruct       Structure used to parse received TCG response.\r
  @param[in]      MethodStatus      Method status of last action performed.  If action succeeded, it should be TCG_METHOD_STATUS_CODE_SUCCESS.\r
  @param[in]      EstimateTimeCost  Estimate the time need to for the method.\r
**/\r
TCG_RESULT\r
EFIAPI\r
OpalPerformMethod (\r
  OPAL_SESSION     *Session,\r
  UINT32           SendSize,\r
  VOID             *Buffer,\r
  UINT32           BufferSize,\r
  TCG_PARSE_STRUCT *ParseStruct,\r
  UINT8            *MethodStatus,\r
  UINT32           EstimateTimeCost\r
  )\r
{\r
  NULL_CHECK(Session);\r
  NULL_CHECK(MethodStatus);\r
\r
  ERROR_CHECK(OpalTrustedSend(\r
                  Session->Sscp,\r
                  Session->MediaId,\r
                  TCG_OPAL_SECURITY_PROTOCOL_1,\r
                  Session->OpalBaseComId,\r
                  SendSize,\r
                  Buffer,\r
                  BufferSize\r
              ));\r
\r
  ERROR_CHECK(OpalTrustedRecv(\r
                  Session->Sscp,\r
                  Session->MediaId,\r
                  TCG_OPAL_SECURITY_PROTOCOL_1,\r
                  Session->OpalBaseComId,\r
                  Buffer,\r
                  BufferSize,\r
                  EstimateTimeCost\r
              ));\r
\r
  ERROR_CHECK(TcgInitTcgParseStruct(ParseStruct, Buffer, BufferSize));\r
  ERROR_CHECK(TcgCheckComIds(ParseStruct, Session->OpalBaseComId, Session->ComIdExtension));\r
  ERROR_CHECK(TcgGetMethodStatus(ParseStruct, MethodStatus));\r
\r
  return TcgResultSuccess;\r
}\r
\r
/**\r
  Trig the block sid action.\r
\r
  @param[in]      Session            OPAL_SESSION related to this method..\r
  @param[in]      HardwareReset      Whether need to do hardware reset.\r
\r
**/\r
TCG_RESULT\r
EFIAPI\r
OpalBlockSid(\r
  OPAL_SESSION                           *Session,\r
  BOOLEAN                                HardwareReset\r
  )\r
{\r
  UINT8                      Buffer[BUFFER_SIZE];\r
  TCG_BLOCK_SID_CLEAR_EVENTS *ClearEvents;\r
\r
  NULL_CHECK(Session);\r
\r
  //\r
  // Set Hardware Reset bit\r
  //\r
  ClearEvents = (TCG_BLOCK_SID_CLEAR_EVENTS *) &Buffer[0];\r
\r
  ClearEvents->Reserved = 0;\r
  ClearEvents->HardwareReset = HardwareReset;\r
\r
  return(OpalTrustedSend(\r
                  Session->Sscp,\r
                  Session->MediaId,\r
                  TCG_OPAL_SECURITY_PROTOCOL_2,\r
                  TCG_BLOCKSID_COMID,   // hardcode ComID 0x0005\r
                  1,\r
                  Buffer,\r
                  BUFFER_SIZE\r
              ));\r
}\r
\r
/**\r
\r
  Reverts device using Admin SP Revert method.\r
\r
  @param[in]  AdminSpSession      OPAL_SESSION with OPAL_UID_ADMIN_SP as OPAL_ADMIN_SP_PSID_AUTHORITY to perform PSID revert.\r
\r
**/\r
TCG_RESULT\r
EFIAPI\r
OpalPsidRevert(\r
  OPAL_SESSION              *AdminSpSession\r
  )\r
{\r
  //\r
  // Now that base comid is known, start Session\r
  // we'll attempt to start Session as PSID authority\r
  // verify PSID Authority is defined in ADMIN SP authority table... is this possible?\r
  //\r
  TCG_CREATE_STRUCT  CreateStruct;\r
  TCG_PARSE_STRUCT   ParseStruct;\r
  UINT32             Size;\r
  UINT8              Buffer[BUFFER_SIZE];\r
  UINT8              MethodStatus;\r
\r
  NULL_CHECK(AdminSpSession);\r
\r
  //\r
  // Send Revert action on Admin SP\r
  //\r
  ERROR_CHECK(TcgInitTcgCreateStruct(&CreateStruct, Buffer, BUFFER_SIZE));\r
  ERROR_CHECK(TcgStartComPacket(&CreateStruct, AdminSpSession->OpalBaseComId, AdminSpSession->ComIdExtension));\r
  ERROR_CHECK(TcgStartPacket(&CreateStruct, AdminSpSession->TperSessionId, AdminSpSession->HostSessionId, 0x0, 0x0, 0x0));\r
  ERROR_CHECK(TcgStartSubPacket(&CreateStruct, 0x0));\r
  ERROR_CHECK(TcgStartMethodCall(&CreateStruct, OPAL_UID_ADMIN_SP, OPAL_ADMIN_SP_REVERT_METHOD));\r
  ERROR_CHECK(TcgStartParameters(&CreateStruct));\r
  ERROR_CHECK(TcgEndParameters(&CreateStruct));\r
  ERROR_CHECK(TcgEndMethodCall(&CreateStruct));\r
  ERROR_CHECK(TcgEndSubPacket(&CreateStruct));\r
  ERROR_CHECK(TcgEndPacket(&CreateStruct));\r
  ERROR_CHECK(TcgEndComPacket(&CreateStruct, &Size));\r
\r
  //\r
  // Send Revert Method Call\r
  //\r
  ERROR_CHECK(OpalPerformMethod(AdminSpSession, Size, Buffer, BUFFER_SIZE, &ParseStruct, &MethodStatus, 0));\r
  METHOD_STATUS_ERROR_CHECK(MethodStatus, TcgResultFailure);\r
\r
  return TcgResultSuccess;\r
}\r
\r
/**\r
\r
  Reverts device using Admin SP Revert method.\r
\r
  @param[in]  AdminSpSession      OPAL_SESSION with OPAL_UID_ADMIN_SP as OPAL_ADMIN_SP_PSID_AUTHORITY to perform PSID revert.\r
  @param[in]  EstimateTimeCost    Estimate the time needed.\r
\r
**/\r
TCG_RESULT\r
EFIAPI\r
OpalPyrite2PsidRevert(\r
  OPAL_SESSION              *AdminSpSession,\r
  UINT32                    EstimateTimeCost\r
  )\r
{\r
  //\r
  // Now that base comid is known, start Session\r
  // we'll attempt to start Session as PSID authority\r
  // verify PSID Authority is defined in ADMIN SP authority table... is this possible?\r
  //\r
  TCG_CREATE_STRUCT  CreateStruct;\r
  TCG_PARSE_STRUCT   ParseStruct;\r
  UINT32             Size;\r
  UINT8              Buffer[BUFFER_SIZE];\r
  UINT8              MethodStatus;\r
\r
\r
  NULL_CHECK(AdminSpSession);\r
\r
  //\r
  // Send Revert action on Admin SP\r
  //\r
  ERROR_CHECK(TcgInitTcgCreateStruct(&CreateStruct, Buffer, BUFFER_SIZE));\r
  ERROR_CHECK(TcgStartComPacket(&CreateStruct, AdminSpSession->OpalBaseComId, AdminSpSession->ComIdExtension));\r
  ERROR_CHECK(TcgStartPacket(&CreateStruct, AdminSpSession->TperSessionId, AdminSpSession->HostSessionId, 0x0, 0x0, 0x0));\r
  ERROR_CHECK(TcgStartSubPacket(&CreateStruct, 0x0));\r
  ERROR_CHECK(TcgStartMethodCall(&CreateStruct, OPAL_UID_ADMIN_SP, OPAL_ADMIN_SP_REVERT_METHOD));\r
  ERROR_CHECK(TcgStartParameters(&CreateStruct));\r
  ERROR_CHECK(TcgEndParameters(&CreateStruct));\r
  ERROR_CHECK(TcgEndMethodCall(&CreateStruct));\r
  ERROR_CHECK(TcgEndSubPacket(&CreateStruct));\r
  ERROR_CHECK(TcgEndPacket(&CreateStruct));\r
  ERROR_CHECK(TcgEndComPacket(&CreateStruct, &Size));\r
\r
  //\r
  // Send Revert Method Call\r
  //\r
  ERROR_CHECK(OpalPerformMethod(AdminSpSession, Size, Buffer, BUFFER_SIZE, &ParseStruct, &MethodStatus, EstimateTimeCost));\r
  METHOD_STATUS_ERROR_CHECK(MethodStatus, TcgResultFailure);\r
\r
  return TcgResultSuccess;\r
}\r
\r
/**\r
\r
  The function fills in the provided Buffer with the level 0 discovery Header\r
  of the device specified.\r
\r
  @param[in]        Session         OPAL_SESSION data.\r
  @param[in]        BufferSize      Size of Buffer provided (in bytes)\r
  @param[in]        BuffAddress     Buffer address to fill with Level 0 Discovery response\r
\r
**/\r
TCG_RESULT\r
EFIAPI\r
OpalRetrieveLevel0DiscoveryHeader(\r
  OPAL_SESSION     *Session,\r
  UINTN            BufferSize,\r
  VOID             *BuffAddress\r
  )\r
{\r
  return (OpalTrustedRecv(\r
              Session->Sscp,\r
              Session->MediaId,\r
              TCG_OPAL_SECURITY_PROTOCOL_1,   // SP\r
              TCG_SP_SPECIFIC_PROTOCOL_LEVEL0_DISCOVERY, // SP_Specific\r
              BuffAddress,\r
              BufferSize,\r
              0\r
            ));\r
}\r
\r
/**\r
\r
  The function fills in the provided Buffer with the supported protocol list\r
  of the device specified.\r
\r
  @param[in]        Session         OPAL_SESSION data.\r
  @param[in]        BufferSize      Size of Buffer provided (in bytes)\r
  @param[in]        BuffAddress     Buffer address to fill with security protocol list\r
\r
**/\r
TCG_RESULT\r
EFIAPI\r
OpalRetrieveSupportedProtocolList(\r
  OPAL_SESSION     *Session,\r
  UINTN            BufferSize,\r
  VOID             *BuffAddress\r
  )\r
{\r
  return (OpalTrustedRecv(\r
              Session->Sscp,\r
              Session->MediaId,\r
              TCG_SECURITY_PROTOCOL_INFO, // SP\r
              TCG_SP_SPECIFIC_PROTOCOL_LIST, // SP_Specific\r
              BuffAddress,\r
              BufferSize,\r
              0\r
          ));\r
}\r
\r
/**\r
  Starts a session with a security provider (SP).\r
\r
  If a session is started successfully, the caller must end the session with OpalEndSession when finished\r
  performing Opal actions.\r
\r
  @param[in/out]  Session                 OPAL_SESSION to initialize.\r
  @param[in]      SpId                    Security provider ID to start the session with.\r
  @param[in]      Write                   Whether the session should be read-only (FALSE) or read/write (TRUE).\r
  @param[in]      HostChallengeLength     Length of the host challenge.  Length should be 0 if hostChallenge is NULL\r
  @param[in]      HostChallenge           Host challenge for Host Signing Authority.  If NULL, then no Host Challenge will be sent.\r
  @param[in]      HostSigningAuthority    Host Signing Authority used for start session.  If NULL, then no Host Signing Authority will be sent.\r
  @param[in/out]  MethodStatus            Status of the StartSession method; only valid if TcgResultSuccess is returned.\r
\r
  @return TcgResultSuccess indicates that the function completed without any internal errors.\r
  The caller must inspect the MethodStatus field to determine whether the method completed successfully.\r
\r
**/\r
TCG_RESULT\r
EFIAPI\r
OpalStartSession(\r
  OPAL_SESSION     *Session,\r
  TCG_UID          SpId,\r
  BOOLEAN          Write,\r
  UINT32           HostChallengeLength,\r
  const VOID       *HostChallenge,\r
  TCG_UID          HostSigningAuthority,\r
  UINT8            *MethodStatus\r
  )\r
{\r
  TCG_CREATE_STRUCT CreateStruct;\r
  TCG_PARSE_STRUCT  ParseStruct;\r
  UINT32            Size;\r
  UINT8             Buf[BUFFER_SIZE];\r
  UINT16            ComIdExtension;\r
  UINT32            HostSessionId;\r
\r
  ComIdExtension = 0;\r
  HostSessionId  = 1;\r
\r
  NULL_CHECK(Session);\r
  NULL_CHECK(MethodStatus);\r
\r
  Session->ComIdExtension = ComIdExtension;\r
  Session->HostSessionId = HostSessionId;\r
\r
  ERROR_CHECK(TcgInitTcgCreateStruct(&CreateStruct, Buf, sizeof(Buf)));\r
  ERROR_CHECK(TcgCreateStartSession(\r
                    &CreateStruct,\r
                    &Size,\r
                    Session->OpalBaseComId,\r
                    ComIdExtension,\r
                    HostSessionId,\r
                    SpId,\r
                    Write,\r
                    HostChallengeLength,\r
                    HostChallenge,\r
                    HostSigningAuthority\r
                ));\r
  ERROR_CHECK(OpalPerformMethod(Session, Size, Buf, sizeof(Buf), &ParseStruct, MethodStatus, 0));\r
  if (*MethodStatus != TCG_METHOD_STATUS_CODE_SUCCESS) {\r
    return TcgResultSuccess; // return early if method failed - user must check MethodStatus\r
  }\r
\r
  if (TcgParseSyncSession(&ParseStruct, Session->OpalBaseComId, ComIdExtension, HostSessionId, &Session->TperSessionId) != TcgResultSuccess) {\r
    OpalEndSession(Session);\r
    return TcgResultFailure;\r
  }\r
\r
  return TcgResultSuccess;\r
}\r
\r
/**\r
  Close a session opened with OpalStartSession.\r
\r
  @param[in/out]  Session                 OPAL_SESSION to end.\r
\r
**/\r
TCG_RESULT\r
EFIAPI\r
OpalEndSession(\r
  OPAL_SESSION     *Session\r
  )\r
{\r
  UINT8             Buffer[BUFFER_SIZE];\r
  TCG_CREATE_STRUCT CreateStruct;\r
  UINT32            Size;\r
  TCG_PARSE_STRUCT  ParseStruct;\r
\r
  NULL_CHECK(Session);\r
  ERROR_CHECK(TcgInitTcgCreateStruct(&CreateStruct, Buffer, sizeof(Buffer)));\r
  ERROR_CHECK(TcgCreateEndSession(\r
                  &CreateStruct,\r
                  &Size,\r
                  Session->OpalBaseComId,\r
                  Session->ComIdExtension,\r
                  Session->HostSessionId,\r
                  Session->TperSessionId\r
                ));\r
\r
  ERROR_CHECK(OpalTrustedSend(\r
                  Session->Sscp,\r
                  Session->MediaId,\r
                  TCG_OPAL_SECURITY_PROTOCOL_1,\r
                  Session->OpalBaseComId,\r
                  Size,\r
                  Buffer,\r
                  sizeof(Buffer)\r
              ));\r
\r
  ERROR_CHECK(OpalTrustedRecv(\r
                  Session->Sscp,\r
                  Session->MediaId,\r
                  TCG_OPAL_SECURITY_PROTOCOL_1,\r
                  Session->OpalBaseComId,\r
                  Buffer,\r
                  sizeof(Buffer),\r
                  0\r
              ));\r
\r
  ERROR_CHECK(TcgInitTcgParseStruct(&ParseStruct, Buffer, sizeof(Buffer)));\r
  ERROR_CHECK(TcgCheckComIds(&ParseStruct, Session->OpalBaseComId, Session->ComIdExtension));\r
\r
  ERROR_CHECK(TcgGetNextEndOfSession(&ParseStruct));\r
  return TcgResultSuccess;\r
}\r
\r
/**\r
\r
  The function retrieves the MSID from the device specified\r
\r
  @param[in]  AdminSpSession      OPAL_SESSION with OPAL_UID_ADMIN_SP as OPAL_ADMIN_SP_PSID_AUTHORITY to perform PSID revert.\r
  @param[in]  MsidBufferSize      Allocated Buffer Size (in bytes) for MSID allocated by caller\r
  @param[in]  Msid                Variable Length byte sequence representing MSID of device\r
  @param[in]  MsidLength          Actual Length of MSID retrieved from device\r
\r
**/\r
TCG_RESULT\r
EFIAPI\r
OpalGetMsid(\r
  OPAL_SESSION    *AdminSpSession,\r
  UINT32          MsidBufferSize,\r
  UINT8           *Msid,\r
  UINT32          *MsidLength\r
  )\r
{\r
  //\r
  // now that base comid is known, start Session\r
  // we'll attempt to start Session as PSID authority\r
  // verify PSID Authority is defined in ADMIN SP authority table... is this possible?\r
  //\r
  TCG_CREATE_STRUCT CreateStruct;\r
  TCG_PARSE_STRUCT  ParseStruct;\r
  UINT32            Size;\r
  UINT8             MethodStatus;\r
  UINT32            Col;\r
  const VOID        *RecvMsid;\r
  UINT8             Buffer[BUFFER_SIZE];\r
\r
  NULL_CHECK(AdminSpSession);\r
  NULL_CHECK(Msid);\r
  NULL_CHECK(MsidLength);\r
\r
  ERROR_CHECK(TcgInitTcgCreateStruct(&CreateStruct, Buffer, BUFFER_SIZE));\r
  ERROR_CHECK(TcgStartComPacket(&CreateStruct, AdminSpSession->OpalBaseComId, AdminSpSession->ComIdExtension));\r
  ERROR_CHECK(TcgStartPacket(&CreateStruct, AdminSpSession->TperSessionId, AdminSpSession->HostSessionId, 0x0, 0x0, 0x0));\r
  ERROR_CHECK(TcgStartSubPacket(&CreateStruct, 0x0));\r
  ERROR_CHECK(TcgStartMethodCall(&CreateStruct, OPAL_UID_ADMIN_SP_C_PIN_MSID, TCG_UID_METHOD_GET));\r
  ERROR_CHECK(TcgStartParameters(&CreateStruct));\r
  ERROR_CHECK(TcgAddStartList(&CreateStruct));\r
  ERROR_CHECK(TcgAddStartName(&CreateStruct));\r
  ERROR_CHECK(TcgAddUINT8(&CreateStruct, TCG_CELL_BLOCK_START_COLUMN_NAME));\r
  ERROR_CHECK(TcgAddUINT8(&CreateStruct, OPAL_ADMIN_SP_PIN_COL));\r
  ERROR_CHECK(TcgAddEndName(&CreateStruct));\r
  ERROR_CHECK(TcgAddStartName(&CreateStruct));\r
  ERROR_CHECK(TcgAddUINT8(&CreateStruct, TCG_CELL_BLOCK_END_COLUMN_NAME));\r
  ERROR_CHECK(TcgAddUINT8(&CreateStruct, OPAL_ADMIN_SP_PIN_COL));\r
  ERROR_CHECK(TcgAddEndName(&CreateStruct));\r
  ERROR_CHECK(TcgAddEndList(&CreateStruct));\r
  ERROR_CHECK(TcgEndParameters(&CreateStruct));\r
  ERROR_CHECK(TcgEndMethodCall(&CreateStruct));\r
  ERROR_CHECK(TcgEndSubPacket(&CreateStruct));\r
  ERROR_CHECK(TcgEndPacket(&CreateStruct));\r
  ERROR_CHECK(TcgEndComPacket(&CreateStruct, &Size));\r
\r
  //\r
  // Send MSID Method Call\r
  //\r
  ERROR_CHECK(OpalPerformMethod(AdminSpSession, Size, Buffer, BUFFER_SIZE, &ParseStruct, &MethodStatus, 0));\r
  METHOD_STATUS_ERROR_CHECK(MethodStatus, TcgResultFailure);\r
\r
  ERROR_CHECK(TcgGetNextStartList(&ParseStruct));\r
  ERROR_CHECK(TcgGetNextStartList(&ParseStruct));\r
  ERROR_CHECK(TcgGetNextStartName(&ParseStruct));\r
  ERROR_CHECK(TcgGetNextUINT32(&ParseStruct, &Col));\r
  ERROR_CHECK(TcgGetNextByteSequence(&ParseStruct, &RecvMsid, MsidLength));\r
  ERROR_CHECK(TcgGetNextEndName(&ParseStruct));\r
  ERROR_CHECK(TcgGetNextEndList(&ParseStruct));\r
  ERROR_CHECK(TcgGetNextEndList(&ParseStruct));\r
  ERROR_CHECK(TcgGetNextEndOfData(&ParseStruct));\r
\r
  if (Col != OPAL_ADMIN_SP_PIN_COL) {\r
    DEBUG ((DEBUG_INFO, "ERROR: got col %u, expected %u\n", Col, OPAL_ADMIN_SP_PIN_COL));\r
    return TcgResultFailure;\r
  }\r
\r
  if (RecvMsid == NULL) {\r
    return TcgResultFailure;\r
  }\r
\r
  if (MsidBufferSize < *MsidLength) {\r
    DEBUG ((DEBUG_INFO, "Buffer too small MsidBufferSize: %d MsidLength: %d\n", MsidBufferSize, *MsidLength));\r
    return TcgResultFailureBufferTooSmall;\r
  }\r
\r
  //\r
  // copy msid into Buffer\r
  //\r
  CopyMem(Msid, RecvMsid, *MsidLength);\r
  return TcgResultSuccess;\r
}\r
\r
/**\r
\r
  The function retrieves the MSID from the device specified\r
\r
  @param[in]  AdminSpSession              OPAL_SESSION with OPAL_UID_ADMIN_SP as OPAL_ADMIN_SP_ANYBODY_AUTHORITY\r
  @param[out] ActiveDataRemovalMechanism  Active Data Removal Mechanism that the device will use for Revert/RevertSP calls.\r
\r
**/\r
TCG_RESULT\r
EFIAPI\r
OpalPyrite2GetActiveDataRemovalMechanism (\r
  IN  OPAL_SESSION    *AdminSpSession,\r
  OUT UINT8           *ActiveDataRemovalMechanism\r
  )\r
{\r
  TCG_CREATE_STRUCT CreateStruct;\r
  TCG_PARSE_STRUCT  ParseStruct;\r
  UINT32            Size;\r
  UINT8             MethodStatus;\r
  UINT32            Col;\r
  UINT8             RecvActiveDataRemovalMechanism;\r
  UINT8             Buffer[BUFFER_SIZE];\r
\r
  NULL_CHECK(AdminSpSession);\r
  NULL_CHECK(ActiveDataRemovalMechanism);\r
\r
  ERROR_CHECK(TcgInitTcgCreateStruct(&CreateStruct, Buffer, BUFFER_SIZE));\r
  ERROR_CHECK(TcgStartComPacket(&CreateStruct, AdminSpSession->OpalBaseComId, AdminSpSession->ComIdExtension));\r
  ERROR_CHECK(TcgStartPacket(&CreateStruct, AdminSpSession->TperSessionId, AdminSpSession->HostSessionId, 0x0, 0x0, 0x0));\r
  ERROR_CHECK(TcgStartSubPacket(&CreateStruct, 0x0));\r
  ERROR_CHECK(TcgStartMethodCall(&CreateStruct, OPAL_UID_ADMIN_SP_DATA_REMOVAL_MECHANISM, TCG_UID_METHOD_GET));\r
  ERROR_CHECK(TcgStartParameters(&CreateStruct));\r
  ERROR_CHECK(TcgAddStartList(&CreateStruct));\r
  ERROR_CHECK(TcgAddStartName(&CreateStruct));\r
  ERROR_CHECK(TcgAddUINT8(&CreateStruct, TCG_CELL_BLOCK_START_COLUMN_NAME));\r
  ERROR_CHECK(TcgAddUINT8(&CreateStruct, OPAL_ADMIN_SP_ACTIVE_DATA_REMOVAL_MECHANISM_COL));\r
  ERROR_CHECK(TcgAddEndName(&CreateStruct));\r
  ERROR_CHECK(TcgAddStartName(&CreateStruct));\r
  ERROR_CHECK(TcgAddUINT8(&CreateStruct, TCG_CELL_BLOCK_END_COLUMN_NAME));\r
  ERROR_CHECK(TcgAddUINT8(&CreateStruct, OPAL_ADMIN_SP_ACTIVE_DATA_REMOVAL_MECHANISM_COL));\r
  ERROR_CHECK(TcgAddEndName(&CreateStruct));\r
  ERROR_CHECK(TcgAddEndList(&CreateStruct));\r
  ERROR_CHECK(TcgEndParameters(&CreateStruct));\r
  ERROR_CHECK(TcgEndMethodCall(&CreateStruct));\r
  ERROR_CHECK(TcgEndSubPacket(&CreateStruct));\r
  ERROR_CHECK(TcgEndPacket(&CreateStruct));\r
  ERROR_CHECK(TcgEndComPacket(&CreateStruct, &Size));\r
\r
  //\r
  // Send Get Active Data Removal Mechanism Method Call\r
  //\r
  ERROR_CHECK(OpalPerformMethod(AdminSpSession, Size, Buffer, BUFFER_SIZE, &ParseStruct, &MethodStatus, 0));\r
  METHOD_STATUS_ERROR_CHECK(MethodStatus, TcgResultFailure);\r
\r
  ERROR_CHECK(TcgGetNextStartList(&ParseStruct));\r
  ERROR_CHECK(TcgGetNextStartList(&ParseStruct));\r
  ERROR_CHECK(TcgGetNextStartName(&ParseStruct));\r
  ERROR_CHECK(TcgGetNextUINT32(&ParseStruct, &Col));\r
  ERROR_CHECK(TcgGetNextUINT8(&ParseStruct, &RecvActiveDataRemovalMechanism));\r
  ERROR_CHECK(TcgGetNextEndName(&ParseStruct));\r
  ERROR_CHECK(TcgGetNextEndList(&ParseStruct));\r
  ERROR_CHECK(TcgGetNextEndList(&ParseStruct));\r
  ERROR_CHECK(TcgGetNextEndOfData(&ParseStruct));\r
\r
  if (Col != OPAL_ADMIN_SP_ACTIVE_DATA_REMOVAL_MECHANISM_COL) {\r
    DEBUG ((DEBUG_INFO, "ERROR: got col %u, expected %u\n", Col, OPAL_ADMIN_SP_ACTIVE_DATA_REMOVAL_MECHANISM_COL));\r
    return TcgResultFailure;\r
  }\r
\r
  if (RecvActiveDataRemovalMechanism >= ResearvedMechanism) {\r
    return TcgResultFailure;\r
  }\r
\r
  //\r
  // Copy active data removal mechanism into Buffer\r
  //\r
  CopyMem(ActiveDataRemovalMechanism, &RecvActiveDataRemovalMechanism, sizeof(RecvActiveDataRemovalMechanism));\r
  return TcgResultSuccess;\r
}\r
\r
/**\r
\r
  The function calls the Admin SP RevertSP method on the Locking SP.  If KeepUserData is True, then the optional parameter\r
  to keep the user Data is set to True, otherwise the optional parameter is not provided.\r
\r
  @param[in]      LockingSpSession    OPAL_SESSION with OPAL_UID_LOCKING_SP as OPAL_LOCKING_SP_ADMIN1_AUTHORITY to revertSP\r
  @param[in]      KeepUserData        Specifies whether or not to keep user Data when performing RevertSP action. True = keeps user Data.\r
  @param[in/out]  MethodStatus        Method status of last action performed.  If action succeeded, it should be TCG_METHOD_STATUS_CODE_SUCCESS.\r
\r
**/\r
TCG_RESULT\r
EFIAPI\r
OpalAdminRevert(\r
  OPAL_SESSION    *LockingSpSession,\r
  BOOLEAN         KeepUserData,\r
  UINT8           *MethodStatus\r
  )\r
{\r
  UINT8             Buf[BUFFER_SIZE];\r
  TCG_CREATE_STRUCT CreateStruct;\r
  UINT32            Size;\r
  TCG_PARSE_STRUCT  ParseStruct;\r
  TCG_RESULT        Ret;\r
\r
  NULL_CHECK(LockingSpSession);\r
  NULL_CHECK(MethodStatus);\r
\r
  //\r
  // ReadLocked or WriteLocked must be False (per Opal spec) to guarantee revertSP can keep user Data\r
  //\r
  if (KeepUserData) {\r
    //\r
    // set readlocked and writelocked to false\r
    //\r
    Ret = OpalUpdateGlobalLockingRange(\r
                        LockingSpSession,\r
                        FALSE,\r
                        FALSE,\r
                        MethodStatus);\r
\r
    if (Ret != TcgResultSuccess || *MethodStatus != TCG_METHOD_STATUS_CODE_SUCCESS) {\r
      //\r
      // bail out\r
      //\r
      return Ret;\r
    }\r
  }\r
\r
  ERROR_CHECK(TcgInitTcgCreateStruct(&CreateStruct, Buf, sizeof(Buf)));\r
  ERROR_CHECK(TcgStartComPacket(&CreateStruct, LockingSpSession->OpalBaseComId, LockingSpSession->ComIdExtension));\r
  ERROR_CHECK(TcgStartPacket(&CreateStruct, LockingSpSession->TperSessionId, LockingSpSession->HostSessionId, 0x0, 0x0, 0x0));\r
  ERROR_CHECK(TcgStartSubPacket(&CreateStruct, 0x0));\r
  ERROR_CHECK(TcgStartMethodCall(&CreateStruct, TCG_UID_THIS_SP, OPAL_LOCKING_SP_REVERTSP_METHOD));\r
  ERROR_CHECK(TcgStartParameters(&CreateStruct));\r
\r
  if (KeepUserData) {\r
    //\r
    // optional parameter to keep Data after revert\r
    //\r
    ERROR_CHECK(TcgAddStartName(&CreateStruct));\r
    ERROR_CHECK(TcgAddUINT32(&CreateStruct, 0x060000));      // weird Value but that's what spec says\r
    ERROR_CHECK(TcgAddBOOLEAN(&CreateStruct, KeepUserData));\r
    ERROR_CHECK(TcgAddEndName(&CreateStruct));\r
  }\r
\r
  ERROR_CHECK(TcgEndParameters(&CreateStruct));\r
  ERROR_CHECK(TcgEndMethodCall(&CreateStruct));\r
  ERROR_CHECK(TcgEndSubPacket(&CreateStruct));\r
  ERROR_CHECK(TcgEndPacket(&CreateStruct));\r
  ERROR_CHECK(TcgEndComPacket(&CreateStruct, &Size));\r
\r
  //\r
  // Send RevertSP method call\r
  //\r
  ERROR_CHECK(OpalPerformMethod(LockingSpSession, Size, Buf, sizeof(Buf), &ParseStruct, MethodStatus, 0));\r
\r
  //\r
  // Session is immediately ended by device after successful revertsp, so no need to end Session\r
  //\r
  if (*MethodStatus == TCG_METHOD_STATUS_CODE_SUCCESS) {\r
    //\r
    // Caller should take ownership again\r
    //\r
    return TcgResultSuccess;\r
  } else {\r
    //\r
    // End Session\r
    //\r
    METHOD_STATUS_ERROR_CHECK(*MethodStatus, TcgResultSuccess);     // exit with success on method failure - user must inspect MethodStatus\r
  }\r
\r
  return TcgResultSuccess;\r
}\r
\r
\r
/**\r
\r
  The function calls the Admin SP RevertSP method on the Locking SP.  If KeepUserData is True, then the optional parameter\r
  to keep the user Data is set to True, otherwise the optional parameter is not provided.\r
\r
  @param[in]      LockingSpSession    OPAL_SESSION with OPAL_UID_LOCKING_SP as OPAL_LOCKING_SP_ADMIN1_AUTHORITY to revertSP\r
  @param[in]      KeepUserData        Specifies whether or not to keep user Data when performing RevertSP action. True = keeps user Data.\r
  @param[in/out]  MethodStatus        Method status of last action performed.  If action succeeded, it should be TCG_METHOD_STATUS_CODE_SUCCESS.\r
  @param[in]      EstimateTimeCost    Estimate the time needed.\r
\r
**/\r
TCG_RESULT\r
EFIAPI\r
OpalPyrite2AdminRevert(\r
  OPAL_SESSION    *LockingSpSession,\r
  BOOLEAN         KeepUserData,\r
  UINT8           *MethodStatus,\r
  UINT32          EstimateTimeCost\r
  )\r
{\r
  UINT8             Buf[BUFFER_SIZE];\r
  TCG_CREATE_STRUCT CreateStruct;\r
  UINT32            Size;\r
  TCG_PARSE_STRUCT  ParseStruct;\r
  TCG_RESULT        Ret;\r
\r
  NULL_CHECK(LockingSpSession);\r
  NULL_CHECK(MethodStatus);\r
\r
  //\r
  // ReadLocked or WriteLocked must be False (per Opal spec) to guarantee revertSP can keep user Data\r
  //\r
  if (KeepUserData) {\r
    //\r
    // set readlocked and writelocked to false\r
    //\r
    Ret = OpalUpdateGlobalLockingRange(\r
                        LockingSpSession,\r
                        FALSE,\r
                        FALSE,\r
                        MethodStatus);\r
\r
    if (Ret != TcgResultSuccess || *MethodStatus != TCG_METHOD_STATUS_CODE_SUCCESS) {\r
      //\r
      // bail out\r
      //\r
      return Ret;\r
    }\r
  }\r
\r
  ERROR_CHECK(TcgInitTcgCreateStruct(&CreateStruct, Buf, sizeof(Buf)));\r
  ERROR_CHECK(TcgStartComPacket(&CreateStruct, LockingSpSession->OpalBaseComId, LockingSpSession->ComIdExtension));\r
  ERROR_CHECK(TcgStartPacket(&CreateStruct, LockingSpSession->TperSessionId, LockingSpSession->HostSessionId, 0x0, 0x0, 0x0));\r
  ERROR_CHECK(TcgStartSubPacket(&CreateStruct, 0x0));\r
  ERROR_CHECK(TcgStartMethodCall(&CreateStruct, TCG_UID_THIS_SP, OPAL_LOCKING_SP_REVERTSP_METHOD));\r
  ERROR_CHECK(TcgStartParameters(&CreateStruct));\r
\r
  if (KeepUserData) {\r
    //\r
    // optional parameter to keep Data after revert\r
    //\r
    ERROR_CHECK(TcgAddStartName(&CreateStruct));\r
    ERROR_CHECK(TcgAddUINT32(&CreateStruct, 0x060000));      // weird Value but that's what spec says\r
    ERROR_CHECK(TcgAddBOOLEAN(&CreateStruct, KeepUserData));\r
    ERROR_CHECK(TcgAddEndName(&CreateStruct));\r
  }\r
\r
  ERROR_CHECK(TcgEndParameters(&CreateStruct));\r
  ERROR_CHECK(TcgEndMethodCall(&CreateStruct));\r
  ERROR_CHECK(TcgEndSubPacket(&CreateStruct));\r
  ERROR_CHECK(TcgEndPacket(&CreateStruct));\r
  ERROR_CHECK(TcgEndComPacket(&CreateStruct, &Size));\r
\r
  //\r
  // Send RevertSP method call\r
  //\r
  ERROR_CHECK(OpalPerformMethod(LockingSpSession, Size, Buf, sizeof(Buf), &ParseStruct, MethodStatus, EstimateTimeCost));\r
\r
  //\r
  // Session is immediately ended by device after successful revertsp, so no need to end Session\r
  //\r
  if (*MethodStatus == TCG_METHOD_STATUS_CODE_SUCCESS) {\r
    //\r
    // Caller should take ownership again\r
    //\r
    return TcgResultSuccess;\r
  } else {\r
    //\r
    // End Session\r
    //\r
    METHOD_STATUS_ERROR_CHECK(*MethodStatus, TcgResultSuccess);     // exit with success on method failure - user must inspect MethodStatus\r
  }\r
\r
  return TcgResultSuccess;\r
}\r
\r
/**\r
\r
  The function activates the Locking SP.\r
  Once activated, per Opal spec, the ADMIN SP SID PIN is copied over to the ADMIN1 LOCKING SP PIN.\r
  If the Locking SP is already enabled, then TcgResultSuccess is returned and no action occurs.\r
\r
  @param[in]      AdminSpSession      OPAL_SESSION with OPAL_UID_ADMIN_SP as OPAL_ADMIN_SP_SID_AUTHORITY to activate Locking SP\r
  @param[in/out]  MethodStatus        Method status of last action performed.  If action succeeded, it should be TCG_METHOD_STATUS_CODE_SUCCESS.\r
\r
**/\r
TCG_RESULT\r
EFIAPI\r
OpalActivateLockingSp(\r
  OPAL_SESSION           *AdminSpSession,\r
  UINT8                  *MethodStatus\r
  )\r
{\r
  UINT8             Buf[BUFFER_SIZE];\r
  TCG_CREATE_STRUCT CreateStruct;\r
  UINT32            Size;\r
  TCG_PARSE_STRUCT  ParseStruct;\r
\r
  NULL_CHECK(AdminSpSession);\r
  NULL_CHECK(MethodStatus);\r
\r
  //\r
  // Call Activate method on Locking SP\r
  //\r
  ERROR_CHECK(TcgInitTcgCreateStruct(&CreateStruct, Buf, sizeof(Buf)));\r
  ERROR_CHECK(TcgStartComPacket(&CreateStruct, AdminSpSession->OpalBaseComId, AdminSpSession->ComIdExtension));\r
  ERROR_CHECK(TcgStartPacket(&CreateStruct, AdminSpSession->TperSessionId, AdminSpSession->HostSessionId, 0x0, 0x0, 0x0));\r
  ERROR_CHECK(TcgStartSubPacket(&CreateStruct, 0x0));\r
  ERROR_CHECK(TcgStartMethodCall(&CreateStruct, OPAL_UID_LOCKING_SP, OPAL_ADMIN_SP_ACTIVATE_METHOD));\r
  ERROR_CHECK(TcgStartParameters(&CreateStruct));\r
  ERROR_CHECK(TcgEndParameters(&CreateStruct));\r
  ERROR_CHECK(TcgEndMethodCall(&CreateStruct));\r
  ERROR_CHECK(TcgEndSubPacket(&CreateStruct));\r
  ERROR_CHECK(TcgEndPacket(&CreateStruct));\r
  ERROR_CHECK(TcgEndComPacket(&CreateStruct, &Size));\r
\r
  //\r
  // Send Activate method call\r
  //\r
  ERROR_CHECK(OpalPerformMethod(AdminSpSession, Size, Buf, sizeof(Buf), &ParseStruct, MethodStatus, 0));\r
  METHOD_STATUS_ERROR_CHECK(*MethodStatus, TcgResultSuccess); // exit with success on method failure - user must inspect MethodStatus\r
\r
  return TcgResultSuccess;\r
}\r
\r
/**\r
\r
  The function sets the PIN column of the specified cpinRowUid (authority) with the newPin Value.\r
\r
  @param[in/out]  Session                 OPAL_SESSION to set password\r
  @param[in]      CpinRowUid              UID of row (authority) to update PIN column\r
  @param[in]      NewPin                  New Pin to set for cpinRowUid specified\r
  @param[in]      NewPinLength            Length in bytes of newPin\r
  @param[in/out]  MethodStatus            Method status of last action performed.  If action succeeded, it should be TCG_METHOD_STATUS_CODE_SUCCESS.\r
\r
**/\r
TCG_RESULT\r
EFIAPI\r
OpalSetPassword(\r
  OPAL_SESSION   *Session,\r
  TCG_UID        CpinRowUid,\r
  const VOID     *NewPin,\r
  UINT32         NewPinLength,\r
  UINT8          *MethodStatus\r
  )\r
{\r
  UINT8             Buf[BUFFER_SIZE];\r
  TCG_CREATE_STRUCT CreateStruct;\r
  TCG_PARSE_STRUCT  ParseStruct;\r
  UINT32            Size;\r
\r
  NULL_CHECK(Session);\r
  NULL_CHECK(NewPin);\r
  NULL_CHECK(MethodStatus);\r
\r
  ERROR_CHECK(TcgInitTcgCreateStruct(&CreateStruct, Buf, sizeof(Buf)));\r
  ERROR_CHECK(TcgCreateSetCPin(\r
                         &CreateStruct,\r
                         &Size,\r
                         Session->OpalBaseComId,\r
                         Session->ComIdExtension,\r
                         Session->TperSessionId,\r
                         Session->HostSessionId,\r
                         CpinRowUid,\r
                         NewPin,\r
                         NewPinLength\r
                         ));\r
\r
  ERROR_CHECK(OpalPerformMethod(Session, Size, Buf, sizeof(Buf), &ParseStruct, MethodStatus, 0));\r
  // exit with success on method failure - user must inspect MethodStatus\r
  METHOD_STATUS_ERROR_CHECK(*MethodStatus, TcgResultSuccess);\r
\r
  return TcgResultSuccess;\r
}\r
\r
/**\r
\r
  The function sets the Enabled column to TRUE for the authorityUid provided and updates the PIN column for the cpinRowUid provided\r
  using the newPin provided.  AuthorityUid and cpinRowUid should describe the same authority.\r
\r
  @param[in]      LockingSpSession    OPAL_SESSION with OPAL_UID_LOCKING_SP as OPAL_LOCKING_SP_ADMIN1_AUTHORITY to update\r
  @param[in]      CpinRowUid          Row UID of C_PIN table of Locking SP to update PIN\r
  @param[in]      AuthorityUid        UID of Locking SP authority to update Pin column with\r
  @param[in]      NewPin              New Password used to set Pin column\r
  @param[in]      NewPinLength        Length in bytes of new password\r
  @param[in/out]  MethodStatus        Method status of last action performed.  If action succeeded, it should be TCG_METHOD_STATUS_CODE_SUCCESS.\r
\r
**/\r
TCG_RESULT\r
EFIAPI\r
OpalSetLockingSpAuthorityEnabledAndPin(\r
  OPAL_SESSION    *LockingSpSession,\r
  TCG_UID         CpinRowUid,\r
  TCG_UID         AuthorityUid,\r
  const VOID      *NewPin,\r
  UINT32          NewPinLength,\r
  UINT8           *MethodStatus\r
  )\r
{\r
  UINT8             Buf[BUFFER_SIZE];\r
  TCG_CREATE_STRUCT CreateStruct;\r
  TCG_PARSE_STRUCT  ParseStruct;\r
  UINT32            Size;\r
  TCG_UID           ActiveKey;\r
  TCG_RESULT        Ret;\r
\r
  NULL_CHECK(LockingSpSession);\r
  NULL_CHECK(NewPin);\r
  NULL_CHECK(MethodStatus);\r
\r
  ERROR_CHECK(TcgInitTcgCreateStruct(&CreateStruct, Buf, sizeof(Buf)));\r
  ERROR_CHECK(TcgSetAuthorityEnabled(\r
                  &CreateStruct,\r
                  &Size,\r
                  LockingSpSession->OpalBaseComId,\r
                  LockingSpSession->ComIdExtension,\r
                  LockingSpSession->TperSessionId,\r
                  LockingSpSession->HostSessionId,\r
                  AuthorityUid,\r
                  TRUE));\r
\r
  ERROR_CHECK(OpalPerformMethod(LockingSpSession, Size, Buf, sizeof(Buf), &ParseStruct, MethodStatus, 0));\r
\r
  if (*MethodStatus != TCG_METHOD_STATUS_CODE_SUCCESS) {\r
    DEBUG ((DEBUG_INFO, "Send Set Authority error\n"));\r
    return TcgResultFailure;\r
  }\r
\r
  ERROR_CHECK(TcgInitTcgCreateStruct(&CreateStruct, Buf, sizeof(Buf)));\r
\r
  ERROR_CHECK(TcgCreateSetCPin(\r
                  &CreateStruct,\r
                  &Size,\r
                  LockingSpSession->OpalBaseComId,\r
                  LockingSpSession->ComIdExtension,\r
                  LockingSpSession->TperSessionId,\r
                  LockingSpSession->HostSessionId,\r
                  CpinRowUid,\r
                  NewPin,\r
                  NewPinLength));\r
\r
  ERROR_CHECK(OpalPerformMethod(LockingSpSession, Size, Buf, sizeof(Buf), &ParseStruct, MethodStatus, 0));\r
\r
  //\r
  // allow user1 to set global range to unlocked/locked by modifying ACE_Locking_GlobalRange_SetRdLocked/SetWrLocked\r
  //\r
  ERROR_CHECK(TcgInitTcgCreateStruct(&CreateStruct, Buf, sizeof(Buf)));\r
  ERROR_CHECK(TcgCreateSetAce(\r
                  &CreateStruct,\r
                  &Size,\r
                  LockingSpSession->OpalBaseComId,\r
                  LockingSpSession->ComIdExtension,\r
                  LockingSpSession->TperSessionId,\r
                  LockingSpSession->HostSessionId,\r
                  OPAL_LOCKING_SP_ACE_LOCKING_GLOBALRANGE_SET_RDLOCKED,\r
                  OPAL_LOCKING_SP_USER1_AUTHORITY,\r
                  TCG_ACE_EXPRESSION_OR,\r
                  OPAL_LOCKING_SP_ADMINS_AUTHORITY\r
              ));\r
\r
  ERROR_CHECK(OpalPerformMethod(LockingSpSession, Size, Buf, sizeof(Buf), &ParseStruct, MethodStatus, 0));\r
\r
  if (*MethodStatus != TCG_METHOD_STATUS_CODE_SUCCESS) {\r
    DEBUG ((DEBUG_INFO, "Update ACE for RDLOCKED failed\n"));\r
    return TcgResultFailure;\r
  }\r
\r
  ERROR_CHECK(TcgInitTcgCreateStruct(&CreateStruct, Buf, sizeof(Buf)));\r
  ERROR_CHECK(TcgCreateSetAce(\r
                  &CreateStruct,\r
                  &Size,\r
                  LockingSpSession->OpalBaseComId,\r
                  LockingSpSession->ComIdExtension,\r
                  LockingSpSession->TperSessionId,\r
                  LockingSpSession->HostSessionId,\r
                  OPAL_LOCKING_SP_ACE_LOCKING_GLOBALRANGE_SET_WRLOCKED,\r
                  OPAL_LOCKING_SP_USER1_AUTHORITY,\r
                  TCG_ACE_EXPRESSION_OR,\r
                  OPAL_LOCKING_SP_ADMINS_AUTHORITY\r
              ));\r
\r
  ERROR_CHECK(OpalPerformMethod(LockingSpSession, Size, Buf, sizeof(Buf), &ParseStruct, MethodStatus, 0));\r
\r
  if (*MethodStatus != TCG_METHOD_STATUS_CODE_SUCCESS) {\r
    DEBUG ((DEBUG_INFO, "Update ACE for WRLOCKED failed\n"));\r
    return TcgResultFailure;\r
  }\r
\r
  ERROR_CHECK(TcgInitTcgCreateStruct(&CreateStruct, Buf, sizeof(Buf)));\r
  ERROR_CHECK(OpalCreateRetrieveGlobalLockingRangeActiveKey(LockingSpSession, &CreateStruct, &Size));\r
  ERROR_CHECK(OpalPerformMethod(LockingSpSession, Size, Buf, sizeof(Buf), &ParseStruct, MethodStatus, 0));\r
\r
  //\r
  // For Pyrite type SSC, it not supports Active Key. \r
  // So here add check logic before enable it.\r
  //\r
  Ret = OpalParseRetrieveGlobalLockingRangeActiveKey(&ParseStruct, &ActiveKey);\r
  if (Ret == TcgResultSuccess) {\r
    ERROR_CHECK(TcgInitTcgCreateStruct(&CreateStruct, Buf, sizeof(Buf)));\r
    ERROR_CHECK(TcgCreateSetAce(\r
                    &CreateStruct,\r
                    &Size,\r
                    LockingSpSession->OpalBaseComId,\r
                    LockingSpSession->ComIdExtension,\r
                    LockingSpSession->TperSessionId,\r
                    LockingSpSession->HostSessionId,\r
                    (ActiveKey == OPAL_LOCKING_SP_K_AES_256_GLOBALRANGE_KEY) ? OPAL_LOCKING_SP_ACE_K_AES_256_GLOBALRANGE_GENKEY : OPAL_LOCKING_SP_ACE_K_AES_128_GLOBALRANGE_GENKEY,\r
                    OPAL_LOCKING_SP_USER1_AUTHORITY,\r
                    TCG_ACE_EXPRESSION_OR,\r
                    OPAL_LOCKING_SP_ADMINS_AUTHORITY\r
                ));\r
\r
    ERROR_CHECK(OpalPerformMethod(LockingSpSession, Size, Buf, sizeof(Buf), &ParseStruct, MethodStatus, 0));\r
\r
    if (*MethodStatus != TCG_METHOD_STATUS_CODE_SUCCESS) {\r
      DEBUG ((DEBUG_INFO, "Update ACE for GLOBALRANGE_GENKEY failed\n"));\r
      //\r
      // Disable user1 if all permissions are not granted.\r
      //\r
      return TcgResultFailure;\r
    }\r
  }\r
\r
  ERROR_CHECK(TcgInitTcgCreateStruct(&CreateStruct, Buf, sizeof(Buf)));\r
  ERROR_CHECK(TcgCreateSetAce(\r
                  &CreateStruct,\r
                  &Size,\r
                  LockingSpSession->OpalBaseComId,\r
                  LockingSpSession->ComIdExtension,\r
                  LockingSpSession->TperSessionId,\r
                  LockingSpSession->HostSessionId,\r
                  OPAL_LOCKING_SP_ACE_LOCKING_GLOBALRANGE_GET_ALL,\r
                  OPAL_LOCKING_SP_USER1_AUTHORITY,\r
                  TCG_ACE_EXPRESSION_OR,\r
                  OPAL_LOCKING_SP_ADMINS_AUTHORITY\r
              ));\r
\r
  ERROR_CHECK(OpalPerformMethod(LockingSpSession, Size, Buf, sizeof(Buf), &ParseStruct, MethodStatus, 0));\r
\r
  if (*MethodStatus != TCG_METHOD_STATUS_CODE_SUCCESS) {\r
    DEBUG ((DEBUG_INFO, "Update ACE for OPAL_LOCKING_SP_ACE_LOCKING_GLOBALRANGE_GET_ALL failed\n"));\r
    return TcgResultFailure;\r
  }\r
\r
  return TcgResultSuccess;\r
}\r
\r
/**\r
\r
  The function sets the Enabled column to FALSE for the USER1 authority.\r
\r
  @param[in]      LockingSpSession    OPAL_SESSION with OPAL_UID_LOCKING_SP as OPAL_LOCKING_SP_ADMIN1_AUTHORITY to disable User1\r
  @param[in/out]  MethodStatus        Method status of last action performed.  If action succeeded, it should be TCG_METHOD_STATUS_CODE_SUCCESS.\r
\r
**/\r
TCG_RESULT\r
EFIAPI\r
OpalDisableUser(\r
  OPAL_SESSION     *LockingSpSession,\r
  UINT8            *MethodStatus\r
  )\r
{\r
  UINT8             Buf[BUFFER_SIZE];\r
  TCG_CREATE_STRUCT CreateStruct;\r
  TCG_PARSE_STRUCT  ParseStruct;\r
  UINT32            Size;\r
\r
  NULL_CHECK(LockingSpSession);\r
  NULL_CHECK(MethodStatus);\r
\r
  ERROR_CHECK(TcgInitTcgCreateStruct(&CreateStruct, Buf, sizeof(Buf)));\r
  ERROR_CHECK(TcgSetAuthorityEnabled(\r
                  &CreateStruct,\r
                  &Size,\r
                  LockingSpSession->OpalBaseComId,\r
                  LockingSpSession->ComIdExtension,\r
                  LockingSpSession->TperSessionId,\r
                  LockingSpSession->HostSessionId,\r
                  OPAL_LOCKING_SP_USER1_AUTHORITY,\r
                  FALSE));\r
\r
  ERROR_CHECK(OpalPerformMethod(LockingSpSession, Size, Buf, sizeof(Buf), &ParseStruct, MethodStatus, 0));\r
\r
  return TcgResultSuccess;\r
}\r
\r
/**\r
\r
  The function retrieves the active key of the global locking range\r
  and calls the GenKey method on the active key retrieved.\r
\r
  @param[in]      LockingSpSession    OPAL_SESSION with OPAL_UID_LOCKING_SP to generate key\r
  @param[in/out]  MethodStatus        Method status of last action performed.  If action succeeded, it should be TCG_METHOD_STATUS_CODE_SUCCESS.\r
\r
**/\r
TCG_RESULT\r
EFIAPI\r
OpalGlobalLockingRangeGenKey(\r
  OPAL_SESSION   *LockingSpSession,\r
  UINT8          *MethodStatus\r
  )\r
{\r
  UINT8             Buf[BUFFER_SIZE];\r
  TCG_CREATE_STRUCT CreateStruct;\r
  TCG_PARSE_STRUCT  ParseStruct;\r
  UINT32            Size;\r
  TCG_UID           ActiveKey;\r
\r
  NULL_CHECK(LockingSpSession);\r
  NULL_CHECK(MethodStatus);\r
\r
  ERROR_CHECK(TcgInitTcgCreateStruct(&CreateStruct, Buf, sizeof(Buf)));\r
  //\r
  // retrieve the activekey in order to know which globalrange key to generate\r
  //\r
  ERROR_CHECK(OpalCreateRetrieveGlobalLockingRangeActiveKey(LockingSpSession, &CreateStruct, &Size));\r
  ERROR_CHECK(OpalPerformMethod(LockingSpSession, Size, Buf, sizeof(Buf), &ParseStruct, MethodStatus, 0));\r
\r
  METHOD_STATUS_ERROR_CHECK(*MethodStatus, TcgResultSuccess);\r
\r
  ERROR_CHECK(OpalParseRetrieveGlobalLockingRangeActiveKey(&ParseStruct, &ActiveKey));\r
\r
  //\r
  // call genkey on ActiveKey UID\r
  //\r
  ERROR_CHECK(TcgInitTcgCreateStruct(&CreateStruct, Buf, sizeof(Buf)));\r
  ERROR_CHECK(TcgStartComPacket(&CreateStruct, LockingSpSession->OpalBaseComId, LockingSpSession->ComIdExtension));\r
  ERROR_CHECK(TcgStartPacket(&CreateStruct, LockingSpSession->TperSessionId, LockingSpSession->HostSessionId, 0x0, 0x0, 0x0));\r
  ERROR_CHECK(TcgStartSubPacket(&CreateStruct, 0x0));\r
  ERROR_CHECK(TcgStartMethodCall(&CreateStruct, ActiveKey, TCG_UID_METHOD_GEN_KEY));\r
  ERROR_CHECK(TcgStartParameters(&CreateStruct));\r
  ERROR_CHECK(TcgEndParameters(&CreateStruct));\r
  ERROR_CHECK(TcgEndMethodCall(&CreateStruct));\r
  ERROR_CHECK(TcgEndSubPacket(&CreateStruct));\r
  ERROR_CHECK(TcgEndPacket(&CreateStruct));\r
  ERROR_CHECK(TcgEndComPacket(&CreateStruct, &Size));\r
\r
  ERROR_CHECK(OpalPerformMethod(LockingSpSession, Size, Buf, sizeof(Buf), &ParseStruct, MethodStatus, 0));\r
\r
  return TcgResultSuccess;\r
}\r
\r
/**\r
\r
  The function updates the ReadLocked and WriteLocked columns of the Global Locking Range.\r
  This function is required for a user1 authority, since a user1 authority shall only have access to ReadLocked and WriteLocked columns\r
  (not ReadLockEnabled and WriteLockEnabled columns).\r
\r
  @param[in]      LockingSpSession    OPAL_SESSION with OPAL_UID_LOCKING_SP to generate key\r
  @param[in]      ReadLocked          Value to set ReadLocked column for Global Locking Range\r
  @param[in]      WriteLocked         Value to set WriteLocked column for Global Locking Range\r
  @param[in/out]  MethodStatus        Method status of last action performed.  If action succeeded, it should be TCG_METHOD_STATUS_CODE_SUCCESS.\r
\r
**/\r
TCG_RESULT\r
EFIAPI\r
OpalUpdateGlobalLockingRange(\r
  OPAL_SESSION             *LockingSpSession,\r
  BOOLEAN                  ReadLocked,\r
  BOOLEAN                  WriteLocked,\r
  UINT8                    *MethodStatus\r
  )\r
{\r
  UINT8             Buf[BUFFER_SIZE];\r
  TCG_CREATE_STRUCT CreateStruct;\r
  TCG_PARSE_STRUCT  ParseStruct;\r
  UINT32            Size;\r
\r
  NULL_CHECK(LockingSpSession);\r
  NULL_CHECK(MethodStatus);\r
\r
  ERROR_CHECK(TcgInitTcgCreateStruct(&CreateStruct, Buf, sizeof(Buf)));\r
\r
  //\r
  // set global locking range values\r
  //\r
  ERROR_CHECK(TcgStartComPacket(&CreateStruct, LockingSpSession->OpalBaseComId, LockingSpSession->ComIdExtension));\r
  ERROR_CHECK(TcgStartPacket(&CreateStruct, LockingSpSession->TperSessionId, LockingSpSession->HostSessionId, 0x0, 0x0, 0x0));\r
  ERROR_CHECK(TcgStartSubPacket(&CreateStruct, 0x0));\r
  ERROR_CHECK(TcgStartMethodCall(&CreateStruct, OPAL_LOCKING_SP_LOCKING_GLOBALRANGE, TCG_UID_METHOD_SET));\r
  ERROR_CHECK(TcgStartParameters(&CreateStruct));\r
  ERROR_CHECK(TcgAddStartName(&CreateStruct));\r
  ERROR_CHECK(TcgAddUINT8(&CreateStruct, 0x01));                       // "Values"\r
  ERROR_CHECK(TcgAddStartList(&CreateStruct));\r
\r
  ERROR_CHECK(TcgAddStartName(&CreateStruct));\r
  ERROR_CHECK(TcgAddUINT8(&CreateStruct, 0x07));                       // "ReadLocked"\r
  ERROR_CHECK(TcgAddBOOLEAN(&CreateStruct, ReadLocked));\r
  ERROR_CHECK(TcgAddEndName(&CreateStruct));\r
\r
  ERROR_CHECK(TcgAddStartName(&CreateStruct));\r
  ERROR_CHECK(TcgAddUINT8(&CreateStruct, 0x08));                       // "WriteLocked"\r
  ERROR_CHECK(TcgAddBOOLEAN(&CreateStruct, WriteLocked));\r
  ERROR_CHECK(TcgAddEndName(&CreateStruct));\r
\r
  ERROR_CHECK(TcgAddEndList(&CreateStruct));\r
  ERROR_CHECK(TcgAddEndName(&CreateStruct));\r
  ERROR_CHECK(TcgEndParameters(&CreateStruct));\r
  ERROR_CHECK(TcgEndMethodCall(&CreateStruct));\r
  ERROR_CHECK(TcgEndSubPacket(&CreateStruct));\r
  ERROR_CHECK(TcgEndPacket(&CreateStruct));\r
  ERROR_CHECK(TcgEndComPacket(&CreateStruct, &Size));\r
\r
  ERROR_CHECK(OpalPerformMethod(LockingSpSession, Size, Buf, sizeof(Buf), &ParseStruct, MethodStatus, 0));\r
  METHOD_STATUS_ERROR_CHECK(*MethodStatus, TcgResultSuccess);\r
\r
  return TcgResultSuccess;\r
}\r
\r
/**\r
\r
  The function updates the RangeStart, RangeLength, ReadLockedEnabled, WriteLockedEnabled, ReadLocked and WriteLocked columns\r
  of the specified Locking Range.  This function requires admin authority of a locking SP session.\r
\r
  @param[in]      LockingSpSession    OPAL_SESSION with OPAL_UID_LOCKING_SP to generate key\r
  @param[in]      LockingRangeUid     Locking range UID to set values\r
  @param[in]      RangeStart          Value to set RangeStart column for Locking Range\r
  @param[in]      RangeLength         Value to set RangeLength column for Locking Range\r
  @param[in]      ReadLockEnabled     Value to set readLockEnabled column for Locking Range\r
  @param[in]      WriteLockEnabled    Value to set writeLockEnabled column for Locking Range\r
  @param[in]      ReadLocked          Value to set ReadLocked column for Locking Range\r
  @param[in]      WriteLocked         Value to set WriteLocked column for Locking Range\r
  @param[in/out]  MethodStatus        Method status of last action performed.  If action succeeded, it should be TCG_METHOD_STATUS_CODE_SUCCESS.\r
\r
**/\r
TCG_RESULT\r
EFIAPI\r
OpalSetLockingRange(\r
  OPAL_SESSION      *LockingSpSession,\r
  TCG_UID           LockingRangeUid,\r
  UINT64            RangeStart,\r
  UINT64            RangeLength,\r
  BOOLEAN           ReadLockEnabled,\r
  BOOLEAN           WriteLockEnabled,\r
  BOOLEAN           ReadLocked,\r
  BOOLEAN           WriteLocked,\r
  UINT8             *MethodStatus\r
  )\r
{\r
  UINT8           Buf[BUFFER_SIZE];\r
  TCG_CREATE_STRUCT CreateStruct;\r
  TCG_PARSE_STRUCT  ParseStruct;\r
  UINT32          Size;\r
\r
  NULL_CHECK(LockingSpSession);\r
  NULL_CHECK(MethodStatus);\r
\r
  ERROR_CHECK(TcgInitTcgCreateStruct(&CreateStruct, Buf, sizeof(Buf)));\r
\r
  //\r
  // set locking range values\r
  //\r
  ERROR_CHECK(TcgStartComPacket(&CreateStruct, LockingSpSession->OpalBaseComId, LockingSpSession->ComIdExtension));\r
  ERROR_CHECK(TcgStartPacket(&CreateStruct, LockingSpSession->TperSessionId, LockingSpSession->HostSessionId, 0x0, 0x0, 0x0));\r
  ERROR_CHECK(TcgStartSubPacket(&CreateStruct, 0x0));\r
  ERROR_CHECK(TcgStartMethodCall(&CreateStruct, LockingRangeUid, TCG_UID_METHOD_SET));\r
  ERROR_CHECK(TcgStartParameters(&CreateStruct));\r
  ERROR_CHECK(TcgAddStartName(&CreateStruct));\r
  ERROR_CHECK(TcgAddUINT8(&CreateStruct, 0x01));                        // "Values"\r
  ERROR_CHECK(TcgAddStartList(&CreateStruct));\r
\r
  //\r
  // range start and range Length only apply to non-global locking ranges\r
  //\r
  if (LockingRangeUid != OPAL_LOCKING_SP_LOCKING_GLOBALRANGE) {\r
    ERROR_CHECK(TcgAddStartName(&CreateStruct));\r
    ERROR_CHECK(TcgAddUINT8(&CreateStruct, 0x03));                       // "RangeStart"\r
    ERROR_CHECK(TcgAddUINT64(&CreateStruct, RangeStart));\r
    ERROR_CHECK(TcgAddEndName(&CreateStruct));\r
\r
    ERROR_CHECK(TcgAddStartName(&CreateStruct));\r
    ERROR_CHECK(TcgAddUINT8(&CreateStruct, 0x04));                       // "RangeLength"\r
    ERROR_CHECK(TcgAddUINT64(&CreateStruct, RangeLength));\r
    ERROR_CHECK(TcgAddEndName(&CreateStruct));\r
  }\r
\r
  ERROR_CHECK(TcgAddStartName(&CreateStruct));\r
  ERROR_CHECK(TcgAddUINT8(&CreateStruct, 0x05));                       // "ReadLockEnabled"\r
  ERROR_CHECK(TcgAddBOOLEAN(&CreateStruct, ReadLockEnabled));\r
  ERROR_CHECK(TcgAddEndName(&CreateStruct));\r
\r
  ERROR_CHECK(TcgAddStartName(&CreateStruct));\r
  ERROR_CHECK(TcgAddUINT8(&CreateStruct, 0x06));                       // "WriteLockEnabled"\r
  ERROR_CHECK(TcgAddBOOLEAN(&CreateStruct, WriteLockEnabled));\r
  ERROR_CHECK(TcgAddEndName(&CreateStruct));\r
\r
  ERROR_CHECK(TcgAddStartName(&CreateStruct));\r
  ERROR_CHECK(TcgAddUINT8(&CreateStruct, 0x07));                       // "ReadLocked"\r
  ERROR_CHECK(TcgAddBOOLEAN(&CreateStruct, ReadLocked));\r
  ERROR_CHECK(TcgAddEndName(&CreateStruct));\r
\r
  ERROR_CHECK(TcgAddStartName(&CreateStruct));\r
  ERROR_CHECK(TcgAddUINT8(&CreateStruct, 0x08));                       // "WriteLocked"\r
  ERROR_CHECK(TcgAddBOOLEAN(&CreateStruct, WriteLocked));\r
  ERROR_CHECK(TcgAddEndName(&CreateStruct));\r
\r
  ERROR_CHECK(TcgAddEndList(&CreateStruct));\r
  ERROR_CHECK(TcgAddEndName(&CreateStruct));\r
  ERROR_CHECK(TcgEndParameters(&CreateStruct));\r
  ERROR_CHECK(TcgEndMethodCall(&CreateStruct));\r
  ERROR_CHECK(TcgEndSubPacket(&CreateStruct));\r
  ERROR_CHECK(TcgEndPacket(&CreateStruct));\r
  ERROR_CHECK(TcgEndComPacket(&CreateStruct, &Size));\r
\r
  ERROR_CHECK(OpalPerformMethod(LockingSpSession, Size, Buf, sizeof(Buf), &ParseStruct, MethodStatus, 0));\r
  // Exit with success on method failure - user must inspect MethodStatus\r
  METHOD_STATUS_ERROR_CHECK(*MethodStatus, TcgResultSuccess);\r
\r
  return TcgResultSuccess;\r
}\r
\r
/**\r
\r
  The function populates the CreateStruct with a payload that will retrieve the global locking range active key.\r
  It is intended to be called with a session that is already started with a valid credential.\r
  The function does not send the payload.\r
\r
  @param[in]      Session        OPAL_SESSION to populate command for, needs ComId\r
  @param[in/out]  CreateStruct   Structure to populate with encoded TCG command\r
  @param[in/out]  Size           Size in bytes of the command created.\r
\r
**/\r
TCG_RESULT\r
EFIAPI\r
OpalCreateRetrieveGlobalLockingRangeActiveKey(\r
  const OPAL_SESSION    *Session,\r
  TCG_CREATE_STRUCT     *CreateStruct,\r
  UINT32                *Size\r
  )\r
{\r
  NULL_CHECK(Session);\r
  NULL_CHECK(CreateStruct);\r
  NULL_CHECK(Size);\r
\r
  // Retrieve the activekey in order to know which globalrange key to generate\r
  ERROR_CHECK(TcgStartComPacket(CreateStruct, Session->OpalBaseComId, Session->ComIdExtension));\r
  ERROR_CHECK(TcgStartPacket(CreateStruct, Session->TperSessionId, Session->HostSessionId, 0x0, 0x0, 0x0));\r
  ERROR_CHECK(TcgStartSubPacket(CreateStruct, 0x0));\r
  ERROR_CHECK(TcgStartMethodCall(CreateStruct, OPAL_LOCKING_SP_LOCKING_GLOBALRANGE, TCG_UID_METHOD_GET));\r
  ERROR_CHECK(TcgStartParameters(CreateStruct));\r
  ERROR_CHECK(TcgAddStartList(CreateStruct));\r
  ERROR_CHECK(TcgAddStartName(CreateStruct));\r
  ERROR_CHECK(TcgAddUINT8(CreateStruct, TCG_CELL_BLOCK_START_COLUMN_NAME));\r
  ERROR_CHECK(TcgAddUINT8(CreateStruct, 0x0A));         // ActiveKey\r
  ERROR_CHECK(TcgAddEndName(CreateStruct));\r
  ERROR_CHECK(TcgAddStartName(CreateStruct));\r
  ERROR_CHECK(TcgAddUINT8(CreateStruct, TCG_CELL_BLOCK_END_COLUMN_NAME));\r
  ERROR_CHECK(TcgAddUINT8(CreateStruct, 0x0A));\r
  ERROR_CHECK(TcgAddEndName(CreateStruct));\r
  ERROR_CHECK(TcgAddEndList(CreateStruct));\r
  ERROR_CHECK(TcgEndParameters(CreateStruct));\r
  ERROR_CHECK(TcgEndMethodCall(CreateStruct));\r
  ERROR_CHECK(TcgEndSubPacket(CreateStruct));\r
  ERROR_CHECK(TcgEndPacket(CreateStruct));\r
  ERROR_CHECK(TcgEndComPacket(CreateStruct, Size));\r
\r
  return TcgResultSuccess;\r
}\r
\r
/**\r
\r
  The function acquires the activeKey specified for the Global Locking Range from the ParseStruct.\r
\r
  @param[in]      ParseStruct    Structure that contains the device's response with the activekey\r
  @param[in/out]  ActiveKey      The UID of the active key retrieved\r
\r
**/\r
TCG_RESULT\r
EFIAPI\r
OpalParseRetrieveGlobalLockingRangeActiveKey(\r
  TCG_PARSE_STRUCT  *ParseStruct,\r
  TCG_UID           *ActiveKey\r
  )\r
{\r
  UINT32 ColumnName;\r
\r
  NULL_CHECK(ParseStruct);\r
  NULL_CHECK(ActiveKey);\r
\r
  // parse response\r
  ERROR_CHECK(TcgGetNextStartList(ParseStruct));\r
  ERROR_CHECK(TcgGetNextStartList(ParseStruct));\r
  ERROR_CHECK(TcgGetNextStartName(ParseStruct));\r
  ERROR_CHECK(TcgGetNextUINT32(ParseStruct, &ColumnName));\r
  ERROR_CHECK(TcgGetNextTcgUid(ParseStruct, ActiveKey));\r
  ERROR_CHECK(TcgGetNextEndName(ParseStruct));\r
  ERROR_CHECK(TcgGetNextEndList(ParseStruct));\r
  ERROR_CHECK(TcgGetNextEndList(ParseStruct));\r
  ERROR_CHECK(TcgGetNextEndOfData(ParseStruct));\r
\r
  if (ColumnName != 0x0A) {\r
    DEBUG ((DEBUG_INFO, "Unexpected column name %u (exp 0x0A)\n", ColumnName));\r
    return TcgResultFailure;\r
  }\r
\r
  if (*ActiveKey != OPAL_LOCKING_SP_K_AES_256_GLOBALRANGE_KEY && *ActiveKey != OPAL_LOCKING_SP_K_AES_128_GLOBALRANGE_KEY) {\r
    DEBUG ((DEBUG_INFO, "Unexpected gen key %u (exp %u or %u)\n", *ActiveKey, OPAL_LOCKING_SP_K_AES_256_GLOBALRANGE_KEY, OPAL_LOCKING_SP_K_AES_128_GLOBALRANGE_KEY));\r
    return TcgResultFailure;\r
  }\r
\r
  return TcgResultSuccess;\r
}\r
\r
/**\r
\r
  The function retrieves the TryLimit column for the specified rowUid (authority).\r
\r
  @param[in]      LockingSpSession    OPAL_SESSION with OPAL_UID_LOCKING_SP to retrieve try limit\r
  @param[in]      RowUid              Row UID of the Locking SP C_PIN table to retrieve TryLimit column\r
  @param[in/out]  TryLimit            Value from TryLimit column\r
\r
**/\r
TCG_RESULT\r
EFIAPI\r
OpalGetTryLimit(\r
  OPAL_SESSION   *LockingSpSession,\r
  TCG_UID        RowUid,\r
  UINT32         *TryLimit\r
  )\r
{\r
  TCG_CREATE_STRUCT CreateStruct;\r
  TCG_PARSE_STRUCT  ParseStruct;\r
  UINT32            Size;\r
  UINT8             MethodStatus;\r
  UINT8             Buf[BUFFER_SIZE];\r
  UINT32            Col;\r
\r
  NULL_CHECK(LockingSpSession);\r
  NULL_CHECK(TryLimit);\r
\r
  ERROR_CHECK(TcgInitTcgCreateStruct(&CreateStruct, Buf, sizeof(Buf)));\r
  ERROR_CHECK(TcgStartComPacket(&CreateStruct, LockingSpSession->OpalBaseComId, LockingSpSession->ComIdExtension));\r
  ERROR_CHECK(TcgStartPacket(&CreateStruct, LockingSpSession->TperSessionId, LockingSpSession->HostSessionId, 0x0, 0x0, 0x0));\r
  ERROR_CHECK(TcgStartSubPacket(&CreateStruct, 0x0));\r
  ERROR_CHECK(TcgStartMethodCall(&CreateStruct, RowUid, TCG_UID_METHOD_GET));\r
  ERROR_CHECK(TcgStartParameters(&CreateStruct));\r
  ERROR_CHECK(TcgAddStartList(&CreateStruct));\r
  ERROR_CHECK(TcgAddStartName(&CreateStruct));\r
  ERROR_CHECK(TcgAddUINT8(&CreateStruct, TCG_CELL_BLOCK_START_COLUMN_NAME));\r
  ERROR_CHECK(TcgAddUINT8(&CreateStruct, OPAL_LOCKING_SP_C_PIN_TRYLIMIT_COL));\r
  ERROR_CHECK(TcgAddEndName(&CreateStruct));\r
  ERROR_CHECK(TcgAddStartName(&CreateStruct));\r
  ERROR_CHECK(TcgAddUINT8(&CreateStruct, TCG_CELL_BLOCK_END_COLUMN_NAME));\r
  ERROR_CHECK(TcgAddUINT8(&CreateStruct, OPAL_LOCKING_SP_C_PIN_TRYLIMIT_COL));\r
  ERROR_CHECK(TcgAddEndName(&CreateStruct));\r
  ERROR_CHECK(TcgAddEndList(&CreateStruct));\r
  ERROR_CHECK(TcgEndParameters(&CreateStruct));\r
  ERROR_CHECK(TcgEndMethodCall(&CreateStruct));\r
  ERROR_CHECK(TcgEndSubPacket(&CreateStruct));\r
  ERROR_CHECK(TcgEndPacket(&CreateStruct));\r
  ERROR_CHECK(TcgEndComPacket(&CreateStruct, &Size));\r
\r
  ERROR_CHECK(OpalPerformMethod(LockingSpSession, Size, Buf, sizeof(Buf), &ParseStruct, &MethodStatus, 0));\r
  METHOD_STATUS_ERROR_CHECK(MethodStatus, TcgResultFailure);\r
\r
  ERROR_CHECK(TcgGetNextStartList(&ParseStruct));\r
  ERROR_CHECK(TcgGetNextStartList(&ParseStruct));\r
  ERROR_CHECK(TcgGetNextStartName(&ParseStruct));\r
  ERROR_CHECK(TcgGetNextUINT32(&ParseStruct, &Col));\r
  ERROR_CHECK(TcgGetNextUINT32(&ParseStruct, TryLimit));\r
  ERROR_CHECK(TcgGetNextEndName(&ParseStruct));\r
  ERROR_CHECK(TcgGetNextEndList(&ParseStruct));\r
  ERROR_CHECK(TcgGetNextEndList(&ParseStruct));\r
  ERROR_CHECK(TcgGetNextEndOfData(&ParseStruct));\r
\r
  if (Col != OPAL_LOCKING_SP_C_PIN_TRYLIMIT_COL) {\r
    DEBUG ((DEBUG_INFO, "ERROR: got col %u, expected %u\n", Col, OPAL_LOCKING_SP_C_PIN_TRYLIMIT_COL));\r
    return TcgResultFailure;\r
  }\r
\r
  return TcgResultSuccess;\r
}\r
\r
/**\r
\r
  Get the support attribute info.\r
\r
  @param[in]      Session             OPAL_SESSION with OPAL_UID_LOCKING_SP to retrieve info.\r
  @param[out]     SupportedAttributes Return the support attribute info.\r
  @param[out]     OpalBaseComId       Return the base com id info.\r
\r
**/\r
TCG_RESULT\r
EFIAPI\r
OpalGetSupportedAttributesInfo(\r
  IN  OPAL_SESSION                 *Session,\r
  OUT OPAL_DISK_SUPPORT_ATTRIBUTE  *SupportedAttributes,\r
  OUT UINT16                       *OpalBaseComId\r
  )\r
{\r
  UINT8                              Buffer[BUFFER_SIZE];\r
  TCG_SUPPORTED_SECURITY_PROTOCOLS   *SupportedProtocols;\r
  TCG_LEVEL0_DISCOVERY_HEADER        *DiscoveryHeader;\r
  OPAL_LEVEL0_FEATURE_DESCRIPTOR     *Feat;\r
  OPAL_LEVEL0_FEATURE_DESCRIPTOR     *Feat2;\r
  UINTN                              Size;\r
  UINTN                              Size2;\r
\r
  NULL_CHECK(Session);\r
  NULL_CHECK(SupportedAttributes);\r
  NULL_CHECK(OpalBaseComId);\r
\r
  ZeroMem(Buffer, BUFFER_SIZE);\r
  ASSERT(sizeof(Buffer) >= sizeof(TCG_SUPPORTED_SECURITY_PROTOCOLS));\r
\r
  //\r
  // Retrieve supported protocols verify security protocol 1 is supported\r
  //\r
  SupportedProtocols = (TCG_SUPPORTED_SECURITY_PROTOCOLS*) Buffer;\r
\r
  //\r
  // Get list of supported protocols\r
  //\r
  if (OpalRetrieveSupportedProtocolList (Session, sizeof(TCG_SUPPORTED_SECURITY_PROTOCOLS), SupportedProtocols) == TcgResultFailure) {\r
    DEBUG ((DEBUG_INFO, "OpalRetrieveSupportedProtocolList failed\n"));\r
    return TcgResultFailure;\r
  }\r
\r
  SupportedAttributes->Sp1 = TcgIsProtocolSupported (SupportedProtocols, TCG_OPAL_SECURITY_PROTOCOL_1);\r
  SupportedAttributes->Sp2 = TcgIsProtocolSupported (SupportedProtocols, TCG_OPAL_SECURITY_PROTOCOL_2);\r
  SupportedAttributes->SpIeee1667 = TcgIsProtocolSupported (SupportedProtocols, TCG_SECURITY_PROTOCOL_IEEE_1667);\r
\r
  DEBUG ((DEBUG_INFO, "Supported Protocols: Sp1 %d Sp2: %d SpIeee1667 %d \n",\r
              SupportedAttributes->Sp1,\r
              SupportedAttributes->Sp2,\r
              SupportedAttributes->SpIeee1667\r
              ));\r
\r
  //\r
  // Perform level 0 discovery and assign desired feature info to Opal Disk structure\r
  //\r
  ZeroMem (Buffer, BUFFER_SIZE);\r
  if (OpalRetrieveLevel0DiscoveryHeader (Session, BUFFER_SIZE, Buffer) == TcgResultFailure) {\r
    DEBUG ((DEBUG_INFO, "OpalRetrieveLevel0DiscoveryHeader failed\n"));\r
    return TcgResultFailure;\r
  }\r
\r
  //\r
  // Check for required feature descriptors\r
  //\r
  DiscoveryHeader = (TCG_LEVEL0_DISCOVERY_HEADER*) Buffer;\r
\r
  Size = 0;\r
  Feat = (OPAL_LEVEL0_FEATURE_DESCRIPTOR*) TcgGetFeature (DiscoveryHeader, TCG_FEATURE_OPAL_SSC_V2_0_0, &Size);\r
  SupportedAttributes->OpalSsc2 = (Feat != NULL);\r
\r
  *OpalBaseComId = TCG_RESERVED_COMID;\r
\r
  //\r
  // Check Opal SCC V2 has valid settings for SID C_PIN on revert\r
  //\r
  if (SupportedAttributes->OpalSsc2 && Size >= sizeof (OPAL_SSCV2_FEATURE_DESCRIPTOR)) {\r
    //\r
    // Want opposite polarity b/c Value is greater than a bit, but we only care about non-zero vs zero\r
    //\r
    SupportedAttributes->InitCpinIndicator = (Feat->OpalSscV2.InitialCPINSIDPIN == 0);\r
    SupportedAttributes->CpinUponRevert = (Feat->OpalSscV2.CPINSIDPINRevertBehavior == 0);\r
    DEBUG ((DEBUG_INFO, "Opal SSC V2 InitCpinIndicator %d  CpinUponRevert %d \n",\r
             SupportedAttributes->InitCpinIndicator,\r
             SupportedAttributes->CpinUponRevert\r
            ));\r
    *OpalBaseComId = SwapBytes16 (Feat->OpalSscV2.BaseComdIdBE);\r
  }\r
\r
  Size = 0;\r
  Feat = (OPAL_LEVEL0_FEATURE_DESCRIPTOR*) TcgGetFeature (DiscoveryHeader, TCG_FEATURE_OPAL_SSC_LITE, &Size);\r
  SupportedAttributes->OpalSscLite = (Feat != NULL);\r
\r
  if (Feat != NULL && Size >= sizeof (OPAL_SSCLITE_FEATURE_DESCRIPTOR)) {\r
    if (*OpalBaseComId == TCG_RESERVED_COMID) {\r
      //\r
      // Pin values used always match up with ComId used\r
      //\r
      *OpalBaseComId = SwapBytes16 (Feat->OpalSscLite.BaseComdIdBE);\r
      SupportedAttributes->InitCpinIndicator = (Feat->OpalSscV2.InitialCPINSIDPIN == 0);\r
      SupportedAttributes->CpinUponRevert = (Feat->OpalSscV2.CPINSIDPINRevertBehavior == 0);\r
      DEBUG ((DEBUG_INFO, "Opal SSC Lite InitCpinIndicator %d  CpinUponRevert %d \n",\r
               SupportedAttributes->InitCpinIndicator,\r
               SupportedAttributes->CpinUponRevert\r
              ));\r
    }\r
  }\r
\r
  //\r
  // For some pyrite 2.0 device, it contains both pyrite 1.0 and 2.0 feature data.\r
  // so here try to get data from pyrite 2.0 feature data first.\r
  //\r
  Size = 0;\r
  Feat = (OPAL_LEVEL0_FEATURE_DESCRIPTOR*) TcgGetFeature (DiscoveryHeader, TCG_FEATURE_PYRITE_SSC, &Size);\r
  Size2 = 0;\r
  Feat2 = (OPAL_LEVEL0_FEATURE_DESCRIPTOR*) TcgGetFeature (DiscoveryHeader, TCG_FEATURE_PYRITE_SSC_V2_0_0, &Size2);\r
  if (Feat2 != NULL && Size2 >= sizeof (PYRITE_SSCV2_FEATURE_DESCRIPTOR)) {\r
    SupportedAttributes->PyriteSscV2 = TRUE;\r
    if (*OpalBaseComId == TCG_RESERVED_COMID) {\r
      *OpalBaseComId = SwapBytes16 (Feat2->PyriteSscV2.BaseComdIdBE);\r
      SupportedAttributes->InitCpinIndicator = (Feat2->PyriteSscV2.InitialCPINSIDPIN == 0);\r
      SupportedAttributes->CpinUponRevert = (Feat2->PyriteSscV2.CPINSIDPINRevertBehavior == 0);\r
      DEBUG ((DEBUG_INFO, "Pyrite SSC V2 InitCpinIndicator %d  CpinUponRevert %d \n",\r
               SupportedAttributes->InitCpinIndicator,\r
               SupportedAttributes->CpinUponRevert\r
              ));\r
    }\r
  } else {\r
    SupportedAttributes->PyriteSsc = (Feat != NULL);\r
    if (Feat != NULL && Size >= sizeof (PYRITE_SSC_FEATURE_DESCRIPTOR)) {\r
      if (*OpalBaseComId == TCG_RESERVED_COMID) {\r
        *OpalBaseComId = SwapBytes16 (Feat->PyriteSsc.BaseComdIdBE);\r
        SupportedAttributes->InitCpinIndicator = (Feat->PyriteSsc.InitialCPINSIDPIN == 0);\r
        SupportedAttributes->CpinUponRevert = (Feat->PyriteSsc.CPINSIDPINRevertBehavior == 0);\r
        DEBUG ((DEBUG_INFO, "Pyrite SSC InitCpinIndicator %d  CpinUponRevert %d \n",\r
                 SupportedAttributes->InitCpinIndicator,\r
                 SupportedAttributes->CpinUponRevert\r
                ));\r
      }\r
    }\r
  }\r
\r
  Size = 0;\r
  Feat = (OPAL_LEVEL0_FEATURE_DESCRIPTOR*) TcgGetFeature (DiscoveryHeader, TCG_FEATURE_OPAL_SSC_V1_0_0, &Size);\r
  SupportedAttributes->OpalSsc1 = (Feat != NULL);\r
  if (Feat != NULL && Size >= sizeof (OPAL_SSCV1_FEATURE_DESCRIPTOR)) {\r
    if (*OpalBaseComId == TCG_RESERVED_COMID) {\r
      *OpalBaseComId = SwapBytes16 (Feat->OpalSscV1.BaseComdIdBE);\r
    }\r
  }\r
\r
  Size = 0;\r
  Feat = (OPAL_LEVEL0_FEATURE_DESCRIPTOR*) TcgGetFeature (DiscoveryHeader, TCG_FEATURE_LOCKING, &Size);\r
  if (Feat != NULL && Size >= sizeof (TCG_LOCKING_FEATURE_DESCRIPTOR)) {\r
    SupportedAttributes->MediaEncryption = Feat->Locking.MediaEncryption;\r
    DEBUG ((DEBUG_INFO, "SupportedAttributes->MediaEncryption 0x%X \n", SupportedAttributes->MediaEncryption));\r
  }\r
\r
  Size = 0;\r
  Feat = (OPAL_LEVEL0_FEATURE_DESCRIPTOR*) TcgGetFeature (DiscoveryHeader, TCG_FEATURE_BLOCK_SID, &Size);\r
  if (Feat != NULL && Size >= sizeof (TCG_BLOCK_SID_FEATURE_DESCRIPTOR)) {\r
    SupportedAttributes->BlockSid = TRUE;\r
    DEBUG ((DEBUG_INFO, "BlockSid Supported!!! Current Status is 0x%X \n", Feat->BlockSid.SIDBlockedState));\r
  } else {\r
    DEBUG ((DEBUG_INFO, "BlockSid Unsupported!!!"));\r
  }\r
\r
  Size = 0;\r
  Feat = (OPAL_LEVEL0_FEATURE_DESCRIPTOR*) TcgGetFeature (DiscoveryHeader, TCG_FEATURE_DATA_REMOVAL, &Size);\r
  if (Feat != NULL && Size >= sizeof (DATA_REMOVAL_FEATURE_DESCRIPTOR)) {\r
    SupportedAttributes->DataRemoval = TRUE;\r
    DEBUG ((DEBUG_INFO, "DataRemoval Feature Supported!\n"));\r
    DEBUG ((DEBUG_INFO, "Operation Processing = 0x%x\n", Feat->DataRemoval.OperationProcessing));\r
    DEBUG ((DEBUG_INFO, "RemovalMechanism = 0x%x\n", Feat->DataRemoval.RemovalMechanism));\r
    DEBUG ((DEBUG_INFO, "BIT0 :: Format = 0x%x, Time = 0x%x\n", Feat->DataRemoval.FormatBit0, SwapBytes16 (Feat->DataRemoval.TimeBit0)));\r
    DEBUG ((DEBUG_INFO, "BIT1 :: Format = 0x%x, Time = 0x%x\n", Feat->DataRemoval.FormatBit1, SwapBytes16 (Feat->DataRemoval.TimeBit1)));\r
    DEBUG ((DEBUG_INFO, "BIT2 :: Format = 0x%x, Time = 0x%x\n", Feat->DataRemoval.FormatBit2, SwapBytes16 (Feat->DataRemoval.TimeBit2)));\r
    DEBUG ((DEBUG_INFO, "BIT3 :: Format = 0x%x, Time = 0x%x\n", Feat->DataRemoval.FormatBit3, SwapBytes16 (Feat->DataRemoval.TimeBit3)));\r
    DEBUG ((DEBUG_INFO, "BIT4 :: Format = 0x%x, Time = 0x%x\n", Feat->DataRemoval.FormatBit4, SwapBytes16 (Feat->DataRemoval.TimeBit4)));\r
  }\r
\r
  DEBUG ((DEBUG_INFO, "Base COMID 0x%04X \n", *OpalBaseComId));\r
\r
  return TcgResultSuccess;\r
}\r
\r
/**\r
\r
  Get the support attribute info.\r
\r
  @param[in]      Session             OPAL_SESSION with OPAL_UID_LOCKING_SP to retrieve info.\r
  @param[in/out]  LockingFeature      Return the Locking info.\r
\r
**/\r
TCG_RESULT\r
EFIAPI\r
OpalGetLockingInfo(\r
  OPAL_SESSION                     *Session,\r
  TCG_LOCKING_FEATURE_DESCRIPTOR   *LockingFeature\r
  )\r
{\r
  UINT8                              Buffer[BUFFER_SIZE];\r
  TCG_LEVEL0_DISCOVERY_HEADER        *DiscoveryHeader;\r
  OPAL_LEVEL0_FEATURE_DESCRIPTOR     *Feat;\r
  UINTN                              Size;\r
\r
  NULL_CHECK(Session);\r
  NULL_CHECK(LockingFeature);\r
\r
  ZeroMem(Buffer, BUFFER_SIZE);\r
  ASSERT(sizeof(Buffer) >= sizeof(TCG_SUPPORTED_SECURITY_PROTOCOLS));\r
\r
  if (OpalRetrieveLevel0DiscoveryHeader (Session, BUFFER_SIZE, Buffer) == TcgResultFailure) {\r
    DEBUG ((DEBUG_INFO, "OpalRetrieveLevel0DiscoveryHeader failed\n"));\r
    return TcgResultFailure;\r
  }\r
  DiscoveryHeader = (TCG_LEVEL0_DISCOVERY_HEADER*) Buffer;\r
\r
  Size = 0;\r
  Feat = (OPAL_LEVEL0_FEATURE_DESCRIPTOR*) TcgGetFeature (DiscoveryHeader, TCG_FEATURE_LOCKING, &Size);\r
  if (Feat != NULL && Size >= sizeof (TCG_LOCKING_FEATURE_DESCRIPTOR)) {\r
    CopyMem (LockingFeature, &Feat->Locking, sizeof (TCG_LOCKING_FEATURE_DESCRIPTOR));\r
  }\r
\r
  return TcgResultSuccess;\r
}\r
\r
/**\r
\r
  Get the descriptor for the specific feature code.\r
\r
  @param[in]      Session             OPAL_SESSION with OPAL_UID_LOCKING_SP to retrieve info.\r
  @param[in]      FeatureCode         The feature code user request.\r
  @param[in, out] DataSize            The data size.\r
  @param[out]     Data                The data buffer used to save the feature descriptor.\r
\r
**/\r
TCG_RESULT\r
EFIAPI\r
OpalGetFeatureDescriptor (\r
  IN     OPAL_SESSION              *Session,\r
  IN     UINT16                    FeatureCode,\r
  IN OUT UINTN                     *DataSize,\r
  OUT    VOID                      *Data\r
  )\r
{\r
  UINT8                              Buffer[BUFFER_SIZE];\r
  TCG_LEVEL0_DISCOVERY_HEADER        *DiscoveryHeader;\r
  OPAL_LEVEL0_FEATURE_DESCRIPTOR     *Feat;\r
  UINTN                              Size;\r
\r
  NULL_CHECK(Session);\r
  NULL_CHECK(DataSize);\r
  NULL_CHECK(Data);\r
\r
  ZeroMem(Buffer, BUFFER_SIZE);\r
  ASSERT(sizeof(Buffer) >= sizeof(TCG_SUPPORTED_SECURITY_PROTOCOLS));\r
\r
  if (OpalRetrieveLevel0DiscoveryHeader (Session, BUFFER_SIZE, Buffer) == TcgResultFailure) {\r
    DEBUG ((DEBUG_INFO, "OpalRetrieveLevel0DiscoveryHeader failed\n"));\r
    return TcgResultFailure;\r
  }\r
  DiscoveryHeader = (TCG_LEVEL0_DISCOVERY_HEADER*) Buffer;\r
\r
  Size = 0;\r
  Feat = (OPAL_LEVEL0_FEATURE_DESCRIPTOR*) TcgGetFeature (DiscoveryHeader, FeatureCode, &Size);\r
  if (Feat != NULL) {\r
    if (Size > *DataSize) {\r
      *DataSize = Size;\r
      return TcgResultFailureBufferTooSmall;\r
    }\r
\r
    *DataSize = Size;\r
    CopyMem (Data, Feat, Size);\r
  }\r
\r
  return TcgResultSuccess;\r
}\r
\r
/**\r
\r
  The function determines whether or not all of the requirements for the Opal Feature (not full specification)\r
  are met by the specified device.\r
\r
  @param[in]      SupportedAttributes     Opal device attribute.\r
\r
**/\r
BOOLEAN\r
EFIAPI\r
OpalFeatureSupported(\r
  OPAL_DISK_SUPPORT_ATTRIBUTE      *SupportedAttributes\r
  )\r
{\r
  NULL_CHECK(SupportedAttributes);\r
\r
  if (SupportedAttributes->Sp1 == 0) {\r
    return FALSE;\r
  }\r
\r
  if (SupportedAttributes->OpalSscLite == 0 &&\r
      SupportedAttributes->OpalSsc1 == 0 &&\r
      SupportedAttributes->OpalSsc2 == 0 &&\r
      SupportedAttributes->PyriteSsc == 0 &&\r
      SupportedAttributes->PyriteSscV2 == 0\r
     ) {\r
    return FALSE;\r
  }\r
\r
  return TRUE;\r
}\r
\r
/**\r
\r
  The function returns whether or not the device is Opal Enabled.\r
  TRUE means that the device is partially or fully locked.\r
  This will perform a Level 0 Discovery and parse the locking feature descriptor\r
\r
  @param[in]      SupportedAttributes     Opal device attribute.\r
  @param[in]      LockingFeature          Opal device locking status.\r
\r
\r
**/\r
BOOLEAN\r
EFIAPI\r
OpalFeatureEnabled(\r
  OPAL_DISK_SUPPORT_ATTRIBUTE      *SupportedAttributes,\r
  TCG_LOCKING_FEATURE_DESCRIPTOR   *LockingFeature\r
  )\r
{\r
  NULL_CHECK(SupportedAttributes);\r
  NULL_CHECK(LockingFeature);\r
\r
  if (!OpalFeatureSupported (SupportedAttributes)) {\r
    return FALSE;\r
  }\r
\r
  if (LockingFeature->LockingSupported && LockingFeature->LockingEnabled) {\r
    return TRUE;\r
  }\r
\r
  return FALSE;\r
}\r
\r
/**\r
\r
  The function returns whether or not the device is Opal Locked.\r
  TRUE means that the device is partially or fully locked.\r
  This will perform a Level 0 Discovery and parse the locking feature descriptor\r
\r
  @param[in]      SupportedAttributes     Opal device attribute.\r
  @param[in]      LockingFeature          Opal device locking status.\r
\r
**/\r
BOOLEAN\r
OpalDeviceLocked(\r
  OPAL_DISK_SUPPORT_ATTRIBUTE      *SupportedAttributes,\r
  TCG_LOCKING_FEATURE_DESCRIPTOR   *LockingFeature\r
  )\r
{\r
  NULL_CHECK(SupportedAttributes);\r
  NULL_CHECK(LockingFeature);\r
\r
  if (!OpalFeatureEnabled (SupportedAttributes, LockingFeature)) {\r
    return FALSE;\r
  }\r
\r
  return LockingFeature->Locked;\r
}\r
\r