summaryrefslogtreecommitdiff
path: root/ReferenceCode/ME/BiosExtension/Efi/BiosExtensionLoader/Dxe/UsbProvision.h
blob: 74f8c08aac87424df7c5092a5c9ae84ac8960fa3 (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
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
244
245
246
247
248
249
/** @file
  Include for USB Key Provisioning for AMT.

@copyright
  Copyright (c) 2005 - 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 an 'Intel Peripheral Driver' and uniquely
  identified as "Intel Reference Module" and is
  licensed for Intel CPUs and chipsets under the terms of your
  license agreement with Intel or your vendor.  This file may
  be modified by the user, subject to additional terms of the
  license agreement
**/
#ifndef _USB_PROVISION_H_
#define _USB_PROVISION_H_

//
// External include files do NOT need to be explicitly specified in real EDKII
// environment
//
#include "Pci22.h"

#include EFI_PROTOCOL_CONSUMER (PciRootBridgeIo)
#include EFI_PROTOCOL_CONSUMER (DiskInfo)
#include EFI_PROTOCOL_CONSUMER (SimpleFileSystem)
#include EFI_PROTOCOL_CONSUMER (FileInfo)
#include EFI_PROTOCOL_CONSUMER (BlockIo)

#pragma pack(1)

typedef struct {
  EFI_GUID  FileTypeUUID;
  UINT16    RecordChunkCount;
  UINT16    RecordHeaderByteCount;
  UINT32    RecordNumber;
  UINT8     MajorVersion;
  UINT8     MinorVersion;
  UINT16    FileFlags;
  UINT32    DataRecordCount;
  UINT32    DataRecordsConsumed;
  UINT16    DataRecordChunkCount;
  UINT16    Reserved2;
  UINT16    ModuleList[(127 - 9) * 2];
} FILE_HEADER_RECORD;

///
/// File Flags definition (V2 and above)
///
#define FILE_FLAGS_DONT_CONSUME_RECORDS 0x01

//
// FileTypeUUID
//
#define FILE_TYPE_UUID \
  { \
    0x71FB16B5, 0xCB87, 0x4AF9, 0xB4, 0x41, 0xCA, 0x7B, 0x38, 0x35, 0x78, 0xF9 \
  }

#define FILE_TYPE_UUID_2X \
  { \
    0x5881B296, 0x6BCF, 0x4C72, 0x8B, 0x91, 0xA1, 0x5E, 0x51, 0x2E, 0x99, 0xC4 \
  }

#define FILE_TYPE_UUID_3 \
  { \
    0xC6F6F7A7, 0xC489, 0x47F6, 0x93, 0xED, 0xE2, 0xE5, 0x02, 0x0D, 0xA5, 0x1D \
  }

#define FILE_TYPE_UUID_4 \
  { \
    0x5234A9AA, 0x29E1, 0x44A9, 0x8D, 0x4D, 0x08, 0x1C, 0x07, 0xB9, 0x63, 0x53 \
  }

//
// MajorVersion
//
#define MAJOR_VERSION     0x01  ///< Check this value
#define MINOR_VERSION     0x00  ///< Check this value
#define MAJOR_VERSION_20  0x02
#define MINOR_VERSION_20  0x00
#define MAJOR_VERSION_21  0x02
#define MINOR_VERSION_21  0x01
#define MAJOR_VERSION_30  0x03
#define MINOR_VERSION_30  0x00
#define MAJOR_VERSION_40  0x04
#define MINOR_VERSION_40  0x00

#define VERSION_10        0x0001
#define VERSION_20        0x0002
#define VERSION_21        0x0102
#define VERSION_30        0x0003

typedef struct {
  UINT32  RecordTypeIdentifier;
  UINT32  RecordFlags;
  UINT32  Reserved1[2];
  UINT16  RecordChunkCount;
  UINT16  RecordHeaderByteCount;
  UINT32  RecordNumber;
} DATA_RECORD_HEADER;

//
// RecordTypeIdentifier
//
#define DATA_RECORD_TYPE_INVALID      0
#define DATA_RECORD_TYPE_DATA_RECORD  1

///
/// RecordFlags
///
#define DATA_RECORD_FLAG_VALID  1

typedef struct {
  UINT16  ModuleIdentifier;
  UINT16  VariableIdentifier;
  UINT16  VariableLenght;
  UINT16  Reserved1;
  VOID    *VariableValue;
} DATA_RECORD_ENTRY;

//
// ModuleIdentifier
//
#define MODULE_IDENTIFIER_INVALID       0
#define MODULE_IDENTIFIER_ME_KERNEL     1
#define MODULE_IDENTIFIER_INTEL_AMT_CM  2

//
// VariableIdentifier
// MODULE_IDENTIFIER_ME_KERNEL
//
#define VARIABLE_IDENTIFIER_ME_KERNEL_INVALID               0
#define VARIABLE_IDENTIFIER_ME_KERNEL_CURRENT_MEBX_PASSWORD 1
#define VARIABLE_IDENTIFIER_ME_KERNEL_NEW_MEBX_PASSWORD     2

//
// MODULE_IDENTIFIER_INTEL_AMT_CM
//
#define VARIABLE_IDENTIFIER_INTEL_AMT_CM_INVALID  0
#define VARIABLE_IDENTIFIER_INTEL_AMT_CM_PID      1
#define VARIABLE_IDENTIFIER_INTEL_AMT_CM_PPS      2

typedef struct {
  UINT32  USBKeyLocationInfo;
  UINT32  Reserved1[3];
} USB_KEY_PROVISIONING;

//
// DISK Definition
//
///
/// PART_RECORD
///
typedef struct _PART_RECORD {
  UINT8   BootIndicator;
  UINT8   StartHead;
  UINT8   StartSector;
  UINT8   StartCylinder;
  UINT8   PartitionType;
  UINT8   EndHead;
  UINT8   EndSector;
  UINT8   EndCylinder;
  UINT32  StartLba;
  UINT32  SizeInLba;
} PART_RECORD;

///
/// MBR Partition table
///
typedef struct _MBR {
  UINT8       CodeArea[440];
  UINT32      OptionalDiskSig;
  UINT16      Reserved;
  PART_RECORD PartRecord[4];
  UINT16      Sig;
} MASTER_BOOT_RECORD;

typedef struct _BPB_RECORD {
  UINT8   BS_JmpBoot[3];
  UINT8   BS_OEMName[8];
  UINT16  BPB_BytePerSec;
  UINT8   BPB_SecPerClus;
  UINT16  BPB_RsvdSecCnt;
  UINT8   BPB_NumFATs;
  UINT16  BPB_RootEntCnt;
  UINT16  BPB_TotSec16;
  UINT8   BPB_Media;
  UINT16  BPB_FATSz16;
  UINT16  BPB_SecPerTrk;
  UINT16  BPB_NumHeads;
  UINT32  BPB_Hiddsec;
  UINT32  BPB_TotSec32;
} BPB_RECORD;

#pragma pack()

#define CHUNK_SIZE                      512

#define USB_PROVISIONING_DATA_FILE_NAME L"\\setup.bin"

#define USB_DATA_RECORD_CONSUMED_OFFSET EFI_FIELD_OFFSET (FILE_HEADER_RECORD, DataRecordsConsumed)

/**
  Remove Consumed Data Record in USB Key Provisioning Data File

  @param[in] None.

  @retval None
**/
VOID
UsbConsumedDataRecordRemove (
  VOID
  )
;

/**
  Restore Consumed Data Record in USB Key Provisioning Data File

  @param[in] None.

  @retval None
**/
VOID
UsbConsumedDataRecordRestore (
  VOID
  )
;

/**
  Check USB Key Provisioning Data

  @param[in] None.

  @retval None
**/
VOID
UsbKeyProvisioning (
  VOID
  )
;

#endif // _USB_PROVISION_H_