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
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
|
/** @file
EFI HECI Protocol
@copyright
Copyright (c) 1999 - 2012 Intel Corporation. All rights reserved
This software and associated documentation (if any) is furnished
under a license and may only be used or copied in accordance
with the terms of the license. Except as permitted by such
license, no part of this software or documentation may be
reproduced, stored in a retrieval system, or transmitted in any
form or by any means without the express written consent of
Intel Corporation.
This file contains a 'Sample Driver' and is licensed as such
under the terms of your license agreement with Intel or your
vendor. This file may be modified by the user, subject to
the additional terms of the license agreement
**/
#ifndef _EFI_HECI_H
#define _EFI_HECI_H
#include "MeState.h"
///
/// HECI protocol provided for DXE phase
/// This protocol provides an interface to communicate with Intel ME subsystem via HECI
///
#define HECI_PROTOCOL_GUID \
{ \
0xcfb33810, 0x6e87, 0x4284, 0xb2, 0x3, 0xa6, 0x6a, 0xbe, 0x7, 0xf6, 0xe8 \
}
#define EFI_HECI_PROTOCOL_GUID HECI_PROTOCOL_GUID
EFI_FORWARD_DECLARATION (EFI_HECI_PROTOCOL);
/**
Function sends one messsage through the HECI circular buffer and waits
for the corresponding ACK message.
@param[in][out] Message Pointer to the message buffer.
@param[in] SendLength Length of the message in bytes.
@param[in][out] RecLength Length of the message response in bytes.
@param[in] HostAddress Address of the sending entity.
@param[in] MeAddress Address of the ME entity that should receive the message.
@exception EFI_SUCCESS Command succeeded
@exception EFI_DEVICE_ERROR HECI Device error, command aborts abnormally
@exception EFI_TIMEOUT HECI does not return the buffer before timeout
@exception EFI_BUFFER_TOO_SMALL Message Buffer is too small for the Acknowledge
@exception EFI_UNSUPPORTED Current ME mode doesn't support send message through HECI
**/
typedef
EFI_STATUS
(EFIAPI *EFI_HECI_SENDWACK) (
IN OUT UINT32 *Message,
IN OUT UINT32 Length,
IN OUT UINT32 *RecLength,
IN UINT8 HostAddress,
IN UINT8 MEAddress
)
;
/**
Read the HECI Message from Intel ME with size in Length into
buffer MessageBody. Set Blocking to BLOCKING and code will
wait until one message packet is received. When set to
NON_BLOCKING, if the circular buffer is empty at the time, the
code will not wait for the message packet.
@param[in] Blocking Used to determine if the read is BLOCKING or NON_BLOCKING.
@param[in][out] MessageBody Pointer to a buffer used to receive a message.
@param[in][out] Length Pointer to the length of the buffer on input and the length
of the message on return. (in bytes)
@retval EFI_SUCCESS One message packet read.
@retval EFI_DEVICE_ERROR Failed to initialize HECI or zero-length message packet read
@retval EFI_TIMEOUT HECI is not ready for communication
@retval EFI_BUFFER_TOO_SMALL The caller's buffer was not large enough
**/
typedef
EFI_STATUS
(EFIAPI *EFI_HECI_READ_MESSAGE) (
IN UINT32 Blocking,
IN UINT32 *MessageBody,
IN OUT UINT32 *Length
)
;
/**
Function sends one messsage (of any length) through the HECI circular buffer.
@param[in] Message Pointer to the message data to be sent.
@param[in] Length Length of the message in bytes.
@param[in] HostAddress The address of the host processor.
@param[in] MeAddress Address of the ME subsystem the message is being sent to.
@retval EFI_SUCCESS One message packet sent.
@retval EFI_DEVICE_ERROR Failed to initialize HECI
@retval EFI_TIMEOUT HECI is not ready for communication
@exception EFI_UNSUPPORTED Current ME mode doesn't support send message through HECI
**/
typedef
EFI_STATUS
(EFIAPI *EFI_HECI_SEND_MESSAGE) (
IN UINT32 *Message,
IN UINT32 Length,
IN UINT8 HostAddress,
IN UINT8 MEAddress
)
;
/**
Reset the HECI Controller with algorithm defined in the RS -
Intel(R) Management Engine - Host Embedded Controller
Interface Hardware Programming Specification (HPS)
@param[in] none
@retval EFI_TIMEOUT HECI does not return the buffer before timeout
@retval EFI_SUCCESS Interface reset
**/
typedef
EFI_STATUS
(EFIAPI *EFI_HECI_RESET) (
VOID
)
;
/**
Initialize the HECI Controller with algorithm defined in the
RS - Intel(R) Management Engine - Host Embedded Controller
Interface Hardware Programming Specification (HPS).
Determines if the HECI device is present and, if present,
initializes it for use by the BIOS.
@param[in] None.
@retval EFI_SUCCESS HECI device is present and initialized
@retval EFI_TIMEOUT HECI does not return the buffer before timeout
**/
typedef
EFI_STATUS
(EFIAPI *EFI_HECI_INIT) (
VOID
)
;
/**
Re-initialize the HECI Controller with algorithm defined in the RS - Intel(R) Management Engine
- Host Embedded Controller Interface Hardware Programming Specification (HPS).
Heci Re-initializes it for Host
@param[in] None.
@retval EFI_TIMEOUT HECI does not return the buffer before timeout
@retval EFI_STATUS Status code returned by ResetHeciInterface
**/
typedef
EFI_STATUS
(EFIAPI *EFI_HECI_REINIT) (
VOID
)
;
/**
Reset Intel ME and timeout if Ready is not set after Delay timeout
@param[in] Delay Timeout value in microseconds
@retval EFI_TIMEOUT HECI does not return the buffer before timeout
@retval EFI_SUCCESS Me is ready
**/
typedef
EFI_STATUS
(EFIAPI *EFI_HECI_RESET_WAIT) (
IN UINT32 Delay
)
;
/**
Get an abstract Intel ME State from Firmware Status Register.
This is used to control BIOS flow for different Intel ME
functions.
The ME status information is obtained by sending HECI messages
to Intel ME and is used both by the platform code and
reference code. This will optimize boot time because system
BIOS only sends each HECI message once. It is recommended to
send the HECI messages to Intel ME only when ME mode is normal
(Except for HMRFPO Disable Message) and ME State is NORMAL or
RECOVERY (Suitable for AT and Kernel Messaging only).
@param[out] MeStatus Pointer for abstract status report,
see MeState.h - Abstract ME status definitions.
@retval EFI_SUCCESS MeStatus copied
@retval EFI_INVALID_PARAMETER Pointer of MeStatus is invalid
**/
typedef
EFI_STATUS
(EFIAPI *EFI_HECI_GET_ME_STATUS) (
OUT UINT32 *Status
)
;
/**
Get an abstract ME operation mode from firmware status
register. This is used to control BIOS flow for different
Intel ME functions.
@param[out] MeMode Pointer for ME Mode report,
see MeState.h - Abstract ME Mode definitions.
@retval EFI_SUCCESS MeMode copied
@retval EFI_INVALID_PARAMETER Pointer of MeMode is invalid
**/
typedef
EFI_STATUS
(EFIAPI *EFI_HECI_GET_ME_MODE) (
OUT UINT32 *Mode
)
;
///
/// HECI protocol provided for DXE phase
/// The interface functions are for sending/receiving HECI messages between host and Intel ME subsystem.
/// There is also support to control HECI Initialization and get Intel ME status.
///
struct _EFI_HECI_PROTOCOL {
EFI_HECI_SENDWACK SendwACK; ///< Send HECI message and wait for respond
EFI_HECI_READ_MESSAGE ReadMsg; ///< Receive HECI message
EFI_HECI_SEND_MESSAGE SendMsg; ///< Send HECI message
EFI_HECI_RESET ResetHeci; ///< Reset HECI device
EFI_HECI_INIT InitHeci; ///< Initialize HECI device
EFI_HECI_RESET_WAIT MeResetWait; ///< Intel ME Reset Wait Timer
EFI_HECI_REINIT ReInitHeci; ///< Re-initialize HECI
EFI_HECI_GET_ME_STATUS GetMeStatus; ///< Get Intel ME Status register
EFI_HECI_GET_ME_MODE GetMeMode; ///< Get Intel ME mode
};
extern EFI_GUID gEfiHeciProtocolGuid;
#endif // _EFI_HECI_H
|