Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
4beb3b6
commit 6a56c29
Showing
41 changed files
with
3,414 additions
and
299 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,200 @@ | ||
/** @file | ||
Microcode Definitions. | ||
Microcode Definitions based on contents of the | ||
Intel(R) 64 and IA-32 Architectures Software Developer's Manual | ||
Volume 3A, Section 9.11 Microcode Definitions | ||
Copyright (c) 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. | ||
@par Specification Reference: | ||
Intel(R) 64 and IA-32 Architectures Software Developer's Manual, Volume 3A, | ||
June 2016, Chapter 9 Processor Management and Initialization, Section 9-11. | ||
**/ | ||
|
||
#ifndef __MICROCODE_H__ | ||
#define __MICROCODE_H__ | ||
|
||
/// | ||
/// CPU Microcode Date in BCD format | ||
/// | ||
typedef union { | ||
struct { | ||
UINT32 Year:16; | ||
UINT32 Day:8; | ||
UINT32 Month:8; | ||
} Bits; | ||
UINT32 Uint32; | ||
} CPU_MICROCODE_DATE; | ||
|
||
/// | ||
/// CPU Microcode Processor Signature format | ||
/// | ||
typedef union { | ||
struct { | ||
UINT32 Stepping:4; | ||
UINT32 Model:4; | ||
UINT32 Family:4; | ||
UINT32 Type:2; | ||
UINT32 Reserved1:2; | ||
UINT32 ExtendedModel:4; | ||
UINT32 ExtendedFamily:8; | ||
UINT32 Reserved2:4; | ||
} Bits; | ||
UINT32 Uint32; | ||
} CPU_MICROCODE_PROCESSOR_SIGNATURE; | ||
|
||
#pragma pack (1) | ||
|
||
/// | ||
/// Microcode Update Format definition | ||
/// | ||
typedef struct { | ||
/// | ||
/// Version number of the update header | ||
/// | ||
UINT32 HeaderVersion; | ||
/// | ||
/// Unique version number for the update, the basis for the update | ||
/// signature provided by the processor to indicate the current update | ||
/// functioning within the processor. Used by the BIOS to authenticate | ||
/// the update and verify that the processor loads successfully. The | ||
/// value in this field cannot be used for processor stepping identification | ||
/// alone. This is a signed 32-bit number. | ||
/// | ||
UINT32 UpdateRevision; | ||
/// | ||
/// Date of the update creation in binary format: mmddyyyy (e.g. | ||
/// 07/18/98 is 07181998H). | ||
/// | ||
CPU_MICROCODE_DATE Date; | ||
/// | ||
/// Extended family, extended model, type, family, model, and stepping | ||
/// of processor that requires this particular update revision (e.g., | ||
/// 00000650H). Each microcode update is designed specifically for a | ||
/// given extended family, extended model, type, family, model, and | ||
/// stepping of the processor. | ||
/// The BIOS uses the processor signature field in conjunction with the | ||
/// CPUID instruction to determine whether or not an update is | ||
/// appropriate to load on a processor. The information encoded within | ||
/// this field exactly corresponds to the bit representations returned by | ||
/// the CPUID instruction. | ||
/// | ||
CPU_MICROCODE_PROCESSOR_SIGNATURE ProcessorSignature; | ||
/// | ||
/// Checksum of Update Data and Header. Used to verify the integrity of | ||
/// the update header and data. Checksum is correct when the | ||
/// summation of all the DWORDs (including the extended Processor | ||
/// Signature Table) that comprise the microcode update result in | ||
/// 00000000H. | ||
/// | ||
UINT32 Checksum; | ||
/// | ||
/// Version number of the loader program needed to correctly load this | ||
/// update. The initial version is 00000001H | ||
/// | ||
UINT32 LoaderRevision; | ||
/// | ||
/// Platform type information is encoded in the lower 8 bits of this 4- | ||
/// byte field. Each bit represents a particular platform type for a given | ||
/// CPUID. The BIOS uses the processor flags field in conjunction with | ||
/// the platform Id bits in MSR (17H) to determine whether or not an | ||
/// update is appropriate to load on a processor. Multiple bits may be set | ||
/// representing support for multiple platform IDs. | ||
/// | ||
UINT32 ProcessorFlags; | ||
/// | ||
/// Specifies the size of the encrypted data in bytes, and must be a | ||
/// multiple of DWORDs. If this value is 00000000H, then the microcode | ||
/// update encrypted data is 2000 bytes (or 500 DWORDs). | ||
/// | ||
UINT32 DataSize; | ||
/// | ||
/// Specifies the total size of the microcode update in bytes. It is the | ||
/// summation of the header size, the encrypted data size and the size of | ||
/// the optional extended signature table. This value is always a multiple | ||
/// of 1024. | ||
/// | ||
UINT32 TotalSize; | ||
/// | ||
/// Reserved fields for future expansion. | ||
/// | ||
UINT8 Reserved[12]; | ||
} CPU_MICROCODE_HEADER; | ||
|
||
/// | ||
/// Extended Signature Table Header Field Definitions | ||
/// | ||
typedef struct { | ||
/// | ||
/// Specifies the number of extended signature structures (Processor | ||
/// Signature[n], processor flags[n] and checksum[n]) that exist in this | ||
/// microcode update | ||
/// | ||
UINT32 ExtendedSignatureCount; | ||
/// | ||
/// Checksum of update extended processor signature table. Used to | ||
/// verify the integrity of the extended processor signature table. | ||
/// Checksum is correct when the summation of the DWORDs that | ||
/// comprise the extended processor signature table results in | ||
/// 00000000H. | ||
/// | ||
UINT32 ExtendedChecksum; | ||
/// | ||
/// Reserved fields. | ||
/// | ||
UINT8 Reserved[12]; | ||
} CPU_MICROCODE_EXTENDED_TABLE_HEADER; | ||
|
||
/// | ||
/// Extended Signature Table Field Definitions | ||
/// | ||
typedef struct { | ||
/// | ||
/// Extended family, extended model, type, family, model, and stepping | ||
/// of processor that requires this particular update revision (e.g., | ||
/// 00000650H). Each microcode update is designed specifically for a | ||
/// given extended family, extended model, type, family, model, and | ||
/// stepping of the processor. | ||
/// The BIOS uses the processor signature field in conjunction with the | ||
/// CPUID instruction to determine whether or not an update is | ||
/// appropriate to load on a processor. The information encoded within | ||
/// this field exactly corresponds to the bit representations returned by | ||
/// the CPUID instruction. | ||
/// | ||
CPU_MICROCODE_PROCESSOR_SIGNATURE ProcessorSignature; | ||
/// | ||
/// Platform type information is encoded in the lower 8 bits of this 4- | ||
/// byte field. Each bit represents a particular platform type for a given | ||
/// CPUID. The BIOS uses the processor flags field in conjunction with | ||
/// the platform Id bits in MSR (17H) to determine whether or not an | ||
/// update is appropriate to load on a processor. Multiple bits may be set | ||
/// representing support for multiple platform IDs. | ||
/// | ||
UINT32 ProcessorFlag; | ||
/// | ||
/// Used by utility software to decompose a microcode update into | ||
/// multiple microcode updates where each of the new updates is | ||
/// constructed without the optional Extended Processor Signature | ||
/// Table. | ||
/// To calculate the Checksum, substitute the Primary Processor | ||
/// Signature entry and the Processor Flags entry with the | ||
/// corresponding Extended Patch entry. Delete the Extended Processor | ||
/// Signature Table entries. The Checksum is correct when the | ||
/// summation of all DWORDs that comprise the created Extended | ||
/// Processor Patch results in 00000000H. | ||
/// | ||
UINT32 Checksum; | ||
} CPU_MICROCODE_EXTENDED_TABLE; | ||
|
||
#pragma pack () | ||
|
||
#endif |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,85 @@ | ||
/** @file | ||
Lilu & OpenCore specific GUIDs for UEFI Variable Storage, version 1.0. | ||
Copyright (c) 2019, vit9696. 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. | ||
**/ | ||
|
||
#ifndef OC_VARIABLES_H | ||
#define OC_VARIABLES_H | ||
|
||
// | ||
// Variable used for OpenCore log storage (if enabled). | ||
// | ||
#define OC_LOG_VARIABLE_NAME L"boot-log" | ||
|
||
// | ||
// Variable used for OpenCore boot path (if enabled). | ||
// | ||
#define OC_LOG_VARIABLE_PATH L"boot-path" | ||
|
||
// | ||
// Variable used for OpenCore request to redirect NVRAM Boot variable write. | ||
// Boot Services only. | ||
// See: https://github.com/acidanthera/bugtracker/issues/308. | ||
// | ||
#define OC_BOOT_REDIRECT_VARIABLE_NAME L"boot-redirect" | ||
|
||
// | ||
// Variable used for exposing OpenCore Security -> LoadPolicy. | ||
// Boot Services only. | ||
// | ||
#define OC_LOAD_POLICY_VARIABLE_NAME L"load-policy" | ||
|
||
// | ||
// Variable used for exposing OpenCore Security -> ScanPolicy. | ||
// Boot Services only. | ||
// | ||
#define OC_SCAN_POLICY_VARIABLE_NAME L"scan-policy" | ||
|
||
// | ||
// Variable used to report OpenCore version in the following format: | ||
// REL-001-2019-01-01. This follows versioning style of Lilu and plugins. | ||
// | ||
#define OC_VERSION_VARIABLE_NAME L"opencore-version" | ||
|
||
// | ||
// 4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102 | ||
// This GUID is specifically used for normal variable access by Lilu kernel extension and its plugins. | ||
// | ||
#define OC_VENDOR_VARIABLE_GUID \ | ||
{ 0x4D1FDA02, 0x38C7, 0x4A6A, { 0x9C, 0xC6, 0x4B, 0xCC, 0xA8, 0xB3, 0x01, 0x02 } } | ||
|
||
// | ||
// E09B9297-7928-4440-9AAB-D1F8536FBF0A | ||
// This GUID is specifically used for reading variables by Lilu kernel extension and its plugins. | ||
// Any writes to this GUID should be prohibited via EFI_RUNTIME_SERVICES after EXIT_BOOT_SERVICES. | ||
// The expected return code on variable write is EFI_SECURITY_VIOLATION. | ||
// | ||
#define OC_READ_ONLY_VARIABLE_GUID \ | ||
{ 0xE09B9297, 0x7928, 0x4440, { 0x9A, 0xAB, 0xD1, 0xF8, 0x53, 0x6F, 0xBF, 0x0A } } | ||
|
||
// | ||
// F0B9AF8F-2222-4840-8A37-ECF7CC8C12E1 | ||
// This GUID is specifically used for reading variables by Lilu and plugins. | ||
// Any reads from this GUID should be prohibited via EFI_RUNTIME_SERVICES after EXIT_BOOT_SERVICES. | ||
// The expected return code on variable read is EFI_SECURITY_VIOLATION. | ||
// | ||
#define OC_WRITE_ONLY_VARIABLE_GUID \ | ||
{ 0xF0B9AF8F, 0x2222, 0x4840, { 0x8A, 0x37, 0xEC, 0xF7, 0xCC, 0x8C, 0x12, 0xE1 } } | ||
|
||
// | ||
// External global variables with GUID values. | ||
// | ||
extern EFI_GUID gOcVendorVariableGuid; | ||
extern EFI_GUID gOcReadOnlyVariableGuid; | ||
extern EFI_GUID gOcWriteOnlyVariableGuid; | ||
|
||
#endif // OC_VARIABLES_H |
Oops, something went wrong.