summaryrefslogtreecommitdiff
path: root/Silicon/BroxtonSoC/BroxtonSiPkg/Txe/Library/PeiSecLib/SeCLib.c
blob: 7c2af1ed73d0f645f624aff9e6b036cc84c52fa5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
/** @file
  Implementation file for SeC functionality.

  Copyright (c) 2006 - 2016, Intel Corporation. All rights reserved.<BR>

  This program and the accompanying materials
  are licensed and made available under the terms and conditions of the BSD License
  which accompanies this distribution.  The full text of the license may be found at
  http://opensource.org/licenses/bsd-license.php.

  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

**/

#include <MkhiMsgs.h>
#include <Library/DebugLib.h>
#include <Library/HeciMsgLib.h>
#include <Library/PeiServicesLib.h>

/**
  Check if SeC is enabled

  @param[in] VOID              Parameter is VOID

  @retval EFI_SUCCESS          Command succeeded

**/
EFI_STATUS
SeCLibInit (
  VOID
  )
{
  EFI_STATUS  Status;

  Status = EFI_SUCCESS;

  return Status;
}

/**
  Send Get Firmware SKU Request to SEC.

  @param[in] FwCapsSku                 Return Data from Get Firmware Capabilities MKHI Request.

  @retval    EFI_UNSUPPORTED           Current SEC mode doesn't support this function.
  @retval    EFI_SUCCESS               Command succeeded.
  @retval    EFI_DEVICE_ERROR          HECI Device error, command aborts abnormally.
  @retval    EFI_TIMEOUT               HECI does not return the buffer before timeout.
  @retval    EFI_BUFFER_TOO_SMALL      Message Buffer is too small for the Acknowledge.

**/
EFI_STATUS
HeciGetFwCapsSku (
  SECFWCAPS_SKU       *FwCapsSku
  )
{
  EFI_STATUS               Status;
  GEN_GET_FW_CAPSKU        MsgGenGetFwCapsSku;
  GEN_GET_FW_CAPS_SKU_ACK  MsgGenGetFwCapsSkuAck;

  Status = PeiHeciGetFwCapsSkuMsg (FwCapsSku);
  if (EFI_ERROR (Status)) {
    return Status;
  }

  if (((MsgGenGetFwCapsSkuAck.MKHIHeader.Fields.Command) == FWCAPS_GET_RULE_CMD) &&
      ((MsgGenGetFwCapsSkuAck.MKHIHeader.Fields.IsResponse) == 1) &&
      (MsgGenGetFwCapsSkuAck.MKHIHeader.Fields.Result == 0)) {
    *FwCapsSku = MsgGenGetFwCapsSkuAck.Data.FWCapSku;
  }

  return EFI_SUCCESS;
}


/**
  This message is sent by the BIOS or IntelR MEBX prior to the End of Post (EOP)
  on the boot where host wants to get Ibex Peak platform type.
  One of usages is to utilize this command to determine if the platform runs in
  4M or 8M size firmware.

  @param[out] RuleData            PlatformBrand,
                                  IntelSeCFwImageType,
                                  SuperSku,
                                  PlatformTargetMarketType,
                                  PlatformTargetUsageType

  @retval EFI_UNSUPPORTED         Current SEC mode doesn't support this function.
  @retval EFI_SUCCESS             Command succeeded.
  @retval EFI_DEVICE_ERROR        HECI Device error, command aborts abnormally.
  @retval EFI_TIMEOUT             HECI does not return the buffer before timeout.
  @retval EFI_BUFFER_TOO_SMALL    Message Buffer is too small for the Acknowledge.

**/
EFI_STATUS
HeciGetPlatformType (
  OUT PLATFORM_TYPE_RULE_DATA   *RuleData
  )
{
  EFI_STATUS  Status;

  Status = PeiHeciGetPlatformTypeMsg (RuleData);
  if (EFI_ERROR (Status)) {
    return Status;
  }

  return EFI_SUCCESS;
}


/**
  Send Get Firmware Version Request to SEC.

  @param[in, out] MsgGenGetFwVersionAckData          Return themessage of FW version.

  @retval         EFI_UNSUPPORTED                    Current SEC mode doesn't support this function.
  @retval         EFI_SUCCESS                        Command succeeded.
  @retval         EFI_DEVICE_ERROR                   HECI Device error, command aborts abnormally.
  @retval         EFI_TIMEOUT                        HECI does not return the buffer before timeout.
  @retval         EFI_BUFFER_TOO_SMALL               Message Buffer is too smallfor the Acknowledge.

**/
EFI_STATUS
HeciGetFwVersion (
  IN OUT GEN_GET_FW_VER_ACK_DATA      *MsgGenGetFwVersionAckData
  )
{
  EFI_STATUS          Status;
  GEN_GET_FW_VER_ACK  MsgGenGetFwVersionAck;

  Status = PeiHeciGetFwVersionMsg (&MsgGenGetFwVersionAck);
  if (EFI_ERROR (Status)) {
    return Status;
  }

  if ((MsgGenGetFwVersionAck.MKHIHeader.Fields.Command == GEN_GET_FW_VERSION_CMD) &&
      (MsgGenGetFwVersionAck.MKHIHeader.Fields.IsResponse == 1) &&
      (MsgGenGetFwVersionAck.MKHIHeader.Fields.Result == 0)) {
    *MsgGenGetFwVersionAckData = MsgGenGetFwVersionAck.Data;
  }

  return EFI_SUCCESS;
}


/**
  Host client gets Firmware update info from SEC client.

  @param[in, out] SECCapability          Structure of FirmwareUpdateInfo.

  @retval         EFI_SUCCESS             Command succeeded.

**/
EFI_STATUS
HeciGetSeCFwInfo (
  IN OUT SEC_CAP *SECCapability
  )
{
  return EFI_SUCCESS;
}

/**
  Dummy return for SeC signal event use.

  @param[in] Event               The event that triggered this notification function.
  @param[in] ParentImageHandle   Pointer to the notification functions context.

  @retval    EFI_SUCCESS         Always return EFI_SUCCESS.

**/
EFI_STATUS
SeCEmptyEvent (
  EFI_EVENT           Event,
  void                *ParentImageHandle
  )
{
  return EFI_SUCCESS;
}