]> git.proxmox.com Git - mirror_edk2.git/blame - MdePkg/Include/IndustryStandard/UefiTcgPlatform.h
Add TPM2 definition in trusted computing group.
[mirror_edk2.git] / MdePkg / Include / IndustryStandard / UefiTcgPlatform.h
CommitLineData
c311f86b 1/** @file\r
267669ba
LG
2 TCG EFI Platform Definition in TCG_EFI_Platform_1_20_Final\r
3\r
59b226d6 4 Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>\r
9df063a0 5 This program and the accompanying materials\r
267669ba
LG
6 are licensed and made available under the terms and conditions of the BSD License\r
7 which accompanies this distribution. The full text of the license may be found at\r
8 http://opensource.org/licenses/bsd-license.php\r
9\r
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
12\r
13**/\r
14\r
15#ifndef __UEFI_TCG_PLATFORM_H__\r
22a25d24 16#define __UEFI_TCG_PLATFORM_H__\r
267669ba
LG
17\r
18#include <IndustryStandard/Tpm12.h>\r
59b226d6 19#include <IndustryStandard/Tpm20.h>\r
a979fca9 20#include <Uefi.h>\r
1fd83dd2 21\r
267669ba
LG
22//\r
23// Standard event types\r
24//\r
25#define EV_POST_CODE ((TCG_EVENTTYPE) 0x00000001)\r
59b226d6 26#define EV_NO_ACTION ((TCG_EVENTTYPE) 0x00000003)\r
267669ba
LG
27#define EV_SEPARATOR ((TCG_EVENTTYPE) 0x00000004)\r
28#define EV_S_CRTM_CONTENTS ((TCG_EVENTTYPE) 0x00000007)\r
29#define EV_S_CRTM_VERSION ((TCG_EVENTTYPE) 0x00000008)\r
04a89420 30#define EV_CPU_MICROCODE ((TCG_EVENTTYPE) 0x00000009)\r
f5a859d6 31#define EV_TABLE_OF_DEVICES ((TCG_EVENTTYPE) 0x0000000B)\r
267669ba
LG
32\r
33//\r
34// EFI specific event types\r
35//\r
36#define EV_EFI_EVENT_BASE ((TCG_EVENTTYPE) 0x80000000)\r
37#define EV_EFI_VARIABLE_DRIVER_CONFIG (EV_EFI_EVENT_BASE + 1)\r
38#define EV_EFI_VARIABLE_BOOT (EV_EFI_EVENT_BASE + 2)\r
39#define EV_EFI_BOOT_SERVICES_APPLICATION (EV_EFI_EVENT_BASE + 3)\r
40#define EV_EFI_BOOT_SERVICES_DRIVER (EV_EFI_EVENT_BASE + 4)\r
41#define EV_EFI_RUNTIME_SERVICES_DRIVER (EV_EFI_EVENT_BASE + 5)\r
42#define EV_EFI_GPT_EVENT (EV_EFI_EVENT_BASE + 6)\r
43#define EV_EFI_ACTION (EV_EFI_EVENT_BASE + 7)\r
44#define EV_EFI_PLATFORM_FIRMWARE_BLOB (EV_EFI_EVENT_BASE + 8)\r
45#define EV_EFI_HANDOFF_TABLES (EV_EFI_EVENT_BASE + 9)\r
59b226d6 46#define EV_EFI_VARIABLE_AUTHORITY (EV_EFI_EVENT_BASE + 0xE0)\r
267669ba 47\r
267669ba
LG
48#define EFI_CALLING_EFI_APPLICATION \\r
49 "Calling EFI Application from Boot Option"\r
50#define EFI_RETURNING_FROM_EFI_APPLICATOIN \\r
51 "Returning from EFI Application from Boot Option"\r
52#define EFI_EXIT_BOOT_SERVICES_INVOCATION \\r
53 "Exit Boot Services Invocation"\r
54#define EFI_EXIT_BOOT_SERVICES_FAILED \\r
55 "Exit Boot Services Returned with Failure"\r
56#define EFI_EXIT_BOOT_SERVICES_SUCCEEDED \\r
57 "Exit Boot Services Returned with Success"\r
58\r
2096185d 59\r
60#define EV_POSTCODE_INFO_POST_CODE "POST CODE"\r
61#define POST_CODE_STR_LEN (sizeof(EV_POSTCODE_INFO_POST_CODE) - 1)\r
62\r
63#define EV_POSTCODE_INFO_SMM_CODE "SMM CODE"\r
64#define SMM_CODE_STR_LEN (sizeof(EV_POSTCODE_INFO_SMM_CODE) - 1)\r
65\r
66#define EV_POSTCODE_INFO_ACPI_DATA "ACPI DATA"\r
67#define ACPI_DATA_LEN (sizeof(EV_POSTCODE_INFO_ACPI_DATA) - 1)\r
68\r
69#define EV_POSTCODE_INFO_BIS_CODE "BIS CODE"\r
70#define BIS_CODE_LEN (sizeof(EV_POSTCODE_INFO_BIS_CODE) - 1)\r
71\r
72#define EV_POSTCODE_INFO_UEFI_PI "UEFI PI"\r
73#define UEFI_PI_LEN (sizeof(EV_POSTCODE_INFO_UEFI_PI) - 1)\r
74\r
75#define EV_POSTCODE_INFO_OPROM "Embedded Option ROM"\r
76#define OPROM_LEN (sizeof(EV_POSTCODE_INFO_OPROM) - 1)\r
77\r
59b226d6
JY
78#define FIRMWARE_DEBUGGER_EVENT_STRING "UEFI Debug Mode"\r
79#define FIRMWARE_DEBUGGER_EVENT_STRING_LEN (sizeof(FIRMWARE_DEBUGGER_EVENT_STRING) - 1)\r
80\r
267669ba
LG
81//\r
82// Set structure alignment to 1-byte\r
83//\r
a04ad3f0 84#pragma pack (1)\r
267669ba
LG
85\r
86typedef UINT32 TCG_EVENTTYPE;\r
992f22b9
LG
87typedef TPM_PCRINDEX TCG_PCRINDEX;\r
88typedef TPM_DIGEST TCG_DIGEST;\r
fb5148a0 89///\r
3ed785e9 90/// Event Log Entry Structure Definition\r
fb5148a0 91///\r
267669ba 92typedef struct tdTCG_PCR_EVENT {\r
3ed785e9 93 TCG_PCRINDEX PCRIndex; ///< PCRIndex event extended to\r
94 TCG_EVENTTYPE EventType; ///< TCG EFI event type\r
95 TCG_DIGEST Digest; ///< Value extended into PCRIndex\r
96 UINT32 EventSize; ///< Size of the event data\r
97 UINT8 Event[1]; ///< The event data\r
267669ba
LG
98} TCG_PCR_EVENT;\r
99\r
3ed785e9 100#define TSS_EVENT_DATA_MAX_SIZE 256\r
101\r
fb5148a0 102///\r
103/// TCG_PCR_EVENT_HDR\r
104///\r
267669ba
LG
105typedef struct tdTCG_PCR_EVENT_HDR {\r
106 TCG_PCRINDEX PCRIndex;\r
107 TCG_EVENTTYPE EventType;\r
108 TCG_DIGEST Digest;\r
109 UINT32 EventSize;\r
110} TCG_PCR_EVENT_HDR;\r
111\r
fb5148a0 112///\r
113/// EFI_PLATFORM_FIRMWARE_BLOB\r
114///\r
115/// BlobLength should be of type UINTN but we use UINT64 here\r
116/// because PEI is 32-bit while DXE is 64-bit on x64 platforms\r
117///\r
267669ba
LG
118typedef struct tdEFI_PLATFORM_FIRMWARE_BLOB {\r
119 EFI_PHYSICAL_ADDRESS BlobBase;\r
120 UINT64 BlobLength;\r
121} EFI_PLATFORM_FIRMWARE_BLOB;\r
122\r
fb5148a0 123///\r
124/// EFI_IMAGE_LOAD_EVENT\r
125///\r
126/// This structure is used in EV_EFI_BOOT_SERVICES_APPLICATION,\r
127/// EV_EFI_BOOT_SERVICES_DRIVER and EV_EFI_RUNTIME_SERVICES_DRIVER\r
128///\r
267669ba
LG
129typedef struct tdEFI_IMAGE_LOAD_EVENT {\r
130 EFI_PHYSICAL_ADDRESS ImageLocationInMemory;\r
131 UINTN ImageLengthInMemory;\r
132 UINTN ImageLinkTimeAddress;\r
133 UINTN LengthOfDevicePath;\r
134 EFI_DEVICE_PATH_PROTOCOL DevicePath[1];\r
135} EFI_IMAGE_LOAD_EVENT;\r
136\r
fb5148a0 137///\r
138/// EFI_HANDOFF_TABLE_POINTERS\r
139///\r
140/// This structure is used in EV_EFI_HANDOFF_TABLES event to facilitate\r
141/// the measurement of given configuration tables.\r
142///\r
267669ba 143typedef struct tdEFI_HANDOFF_TABLE_POINTERS {\r
3ed785e9 144 UINTN NumberOfTables;\r
267669ba
LG
145 EFI_CONFIGURATION_TABLE TableEntry[1];\r
146} EFI_HANDOFF_TABLE_POINTERS;\r
147\r
fb5148a0 148///\r
149/// EFI_VARIABLE_DATA\r
150///\r
151/// This structure serves as the header for measuring variables. The name of the\r
152/// variable (in Unicode format) should immediately follow, then the variable\r
153/// data.\r
154///\r
267669ba
LG
155typedef struct tdEFI_VARIABLE_DATA {\r
156 EFI_GUID VariableName;\r
157 UINTN UnicodeNameLength;\r
158 UINTN VariableDataLength;\r
159 CHAR16 UnicodeName[1];\r
3ed785e9 160 INT8 VariableData[1]; ///< Driver or platform-specific data\r
267669ba
LG
161} EFI_VARIABLE_DATA;\r
162\r
59b226d6
JY
163//\r
164// For TrEE1.0 compatibility\r
165//\r
166typedef struct {\r
167 EFI_GUID VariableName;\r
168 UINT64 UnicodeNameLength; // The TCG Definition used UINTN\r
169 UINT64 VariableDataLength; // The TCG Definition used UINTN\r
170 CHAR16 UnicodeName[1];\r
171 INT8 VariableData[1];\r
172} EFI_VARIABLE_DATA_TREE;\r
173\r
267669ba
LG
174typedef struct tdEFI_GPT_DATA {\r
175 EFI_PARTITION_TABLE_HEADER EfiPartitionHeader;\r
176 UINTN NumberOfPartitions; \r
177 EFI_PARTITION_ENTRY Partitions[1];\r
178} EFI_GPT_DATA;\r
179\r
59b226d6
JY
180//\r
181// Crypto Agile Log Entry Format\r
182//\r
183typedef struct tdTCG_PCR_EVENT2 {\r
184 TCG_PCRINDEX PCRIndex;\r
185 TCG_EVENTTYPE EventType;\r
186 TPML_DIGEST_VALUES Digest;\r
187 UINT32 EventSize;\r
188 UINT8 Event[1];\r
189} TCG_PCR_EVENT2;\r
190\r
191//\r
192// Log Header Entry Data\r
193//\r
194typedef struct {\r
195 //\r
196 // TCG defined hashing algorithm ID.\r
197 //\r
198 UINT16 algorithmId;\r
199 //\r
200 // The size of the digest for the respective hashing algorithm.\r
201 //\r
202 UINT16 digestSize;\r
203} TCG_EfiSpecIdEventAlgorithmSize;\r
204\r
205#define TCG_EfiSpecIDEventStruct_SIGNATURE_02 "Spec ID Event02"\r
206#define TCG_EfiSpecIDEventStruct_SIGNATURE_03 "Spec ID Event03"\r
207\r
208#define TCG_EfiSpecIDEventStruct_SPEC_VERSION_MAJOR_TPM12 1\r
209#define TCG_EfiSpecIDEventStruct_SPEC_VERSION_MINOR_TPM12 2\r
210#define TCG_EfiSpecIDEventStruct_SPEC_ERRATA_TPM12 2\r
211\r
212#define TCG_EfiSpecIDEventStruct_SPEC_VERSION_MAJOR_TPM2 2\r
213#define TCG_EfiSpecIDEventStruct_SPEC_VERSION_MINOR_TPM2 0\r
214#define TCG_EfiSpecIDEventStruct_SPEC_ERRATA_TPM2 0\r
215\r
216typedef struct {\r
217 UINT8 signature[16];\r
218 //\r
219 // The value for the Platform Class.\r
220 // The enumeration is defined in the TCG ACPI Specification Client Common Header.\r
221 //\r
222 UINT32 platformClass;\r
223 //\r
224 // The TCG EFI Platform Specification minor version number this BIOS supports.\r
225 // Any BIOS supporting version (1.22) MUST set this value to 02h.\r
226 // Any BIOS supporting version (2.0) SHALL set this value to 0x00.\r
227 //\r
228 UINT8 specVersionMinor;\r
229 //\r
230 // The TCG EFI Platform Specification major version number this BIOS supports.\r
231 // Any BIOS supporting version (1.22) MUST set this value to 01h.\r
232 // Any BIOS supporting version (2.0) SHALL set this value to 0x02.\r
233 //\r
234 UINT8 specVersionMajor;\r
235 //\r
236 // The TCG EFI Platform Specification errata for this specification this BIOS supports.\r
237 // Any BIOS supporting version and errata (1.22) MUST set this value to 02h.\r
238 // Any BIOS supporting version and errata (2.0) SHALL set this value to 0x00.\r
239 //\r
240 UINT8 specErrata;\r
241 //\r
242 // Specifies the size of the UINTN fields used in various data structures used in this specification.\r
243 // 0x01 indicates UINT32 and 0x02 indicates UINT64.\r
244 //\r
245 UINT8 uintnSize;\r
246 //\r
247 // This field is added in "Spec ID Event03".\r
248 // The number of hashing algorithms used in this event log (except the first event).\r
249 // All events in this event log use all hashing algorithms defined here.\r
250 //\r
251//UINT32 numberOfAlgorithms;\r
252 //\r
253 // This field is added in "Spec ID Event03".\r
254 // An array of size numberOfAlgorithms of value pairs.\r
255 //\r
256//TCG_EfiSpecIdEventAlgorithmSize digestSize[numberOfAlgorithms];\r
257 //\r
258 // Size in bytes of the VendorInfo field.\r
259 // Maximum value SHALL be FFh bytes.\r
260 //\r
261//UINT8 vendorInfoSize;\r
262 //\r
263 // Provided for use by the BIOS implementer.\r
264 // The value might be used, for example, to provide more detailed information about the specific BIOS such as BIOS revision numbers, etc.\r
265 // The values within this field are not standardized and are implementer-specific.\r
266 // Platform-specific or -unique information SHALL NOT be provided in this field.\r
267 //\r
268//UINT8 vendorInfo[vendorInfoSize];\r
269} TCG_EfiSpecIDEventStruct;\r
270\r
267669ba
LG
271//\r
272// Restore original structure alignment\r
273//\r
a04ad3f0 274#pragma pack ()\r
267669ba
LG
275\r
276#endif\r
277\r
278\r