2 Intel FSP Header File definition from Intel Firmware Support Package External
3 Architecture Specification v2.0.
5 Copyright (c) 2014 - 2016, Intel Corporation. All rights reserved.<BR>
6 This program and the accompanying materials
7 are licensed and made available under the terms and conditions of the BSD License
8 which accompanies this distribution. The full text of the license may be found at
9 http://opensource.org/licenses/bsd-license.php.
11 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
12 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
16 #ifndef __FSP_HEADER_FILE_H__
17 #define __FSP_HEADER_FILE_H__
19 #define FSP_HEADER_REVISION_3 3
21 #define FSPE_HEADER_REVISION_1 1
22 #define FSPP_HEADER_REVISION_1 1
25 /// Fixed FSP header offset in the FSP image
27 #define FSP_INFO_HEADER_OFF 0x94
29 #define OFFSET_IN_FSP_INFO_HEADER(x) (UINT32)&((FSP_INFO_HEADER *)(UINTN)0)->x
31 #define FSP_INFO_HEADER_SIGNATURE SIGNATURE_32 ('F', 'S', 'P', 'H')
36 /// FSP Information Header as described in FSP v2.0 Spec section 5.1.1.
40 /// Byte 0x00: Signature ('FSPH') for the FSP Information Header.
44 /// Byte 0x04: Length of the FSP Information Header.
48 /// Byte 0x08: Reserved.
52 /// Byte 0x0A: Indicates compliance with a revision of this specification in the BCD format.
56 /// Byte 0x0B: Revision of the FSP Information Header.
60 /// Byte 0x0C: Revision of the FSP binary.
64 /// Byte 0x10: Signature string that will help match the FSP Binary to a supported HW configuration.
68 /// Byte 0x18: Size of the entire FSP binary.
72 /// Byte 0x1C: FSP binary preferred base address.
76 /// Byte 0x20: Attribute for the FSP binary.
78 UINT16 ImageAttribute
;
80 /// Byte 0x22: Attributes of the FSP Component.
82 UINT16 ComponentAttribute
;
84 /// Byte 0x24: Offset of the FSP configuration region.
86 UINT32 CfgRegionOffset
;
88 /// Byte 0x28: Size of the FSP configuration region.
92 /// Byte 0x2C: Reserved2.
96 /// Byte 0x30: The offset for the API to setup a temporary stack till the memory is initialized.
98 UINT32 TempRamInitEntryOffset
;
100 /// Byte 0x34: Reserved3.
104 /// Byte 0x38: The offset for the API to inform the FSP about the different stages in the boot process.
106 UINT32 NotifyPhaseEntryOffset
;
108 /// Byte 0x3C: The offset for the API to initialize the memory.
110 UINT32 FspMemoryInitEntryOffset
;
112 /// Byte 0x40: The offset for the API to tear down temporary RAM.
114 UINT32 TempRamExitEntryOffset
;
116 /// Byte 0x44: The offset for the API to initialize the CPU and chipset.
118 UINT32 FspSiliconInitEntryOffset
;
122 /// Signature of the FSP Extended Header
124 #define FSP_INFO_EXTENDED_HEADER_SIGNATURE SIGNATURE_32 ('F', 'S', 'P', 'E')
127 /// FSP Information Extended Header as described in FSP v2.0 Spec section 5.1.2.
131 /// Byte 0x00: Signature ('FSPE') for the FSP Extended Information Header.
135 /// Byte 0x04: Length of the table in bytes, including all additional FSP producer defined data.
139 /// Byte 0x08: FSP producer defined revision of the table.
143 /// Byte 0x09: Reserved for future use.
147 /// Byte 0x0A: FSP producer identification string
149 CHAR8 FspProducerId
[6];
151 /// Byte 0x10: FSP producer implementation revision number. Larger numbers are assumed to be newer revisions.
153 UINT32 FspProducerRevision
;
155 /// Byte 0x14: Size of the FSP producer defined data (n) in bytes.
157 UINT32 FspProducerDataSize
;
159 /// Byte 0x18: FSP producer defined data of size (n) defined by FspProducerDataSize.
161 } FSP_INFO_EXTENDED_HEADER
;
164 // A generic table search algorithm for additional tables can be implemented with a
165 // signature search algorithm until a terminator signature 'FSPP' is found.
167 #define FSP_FSPP_SIGNATURE SIGNATURE_32 ('F', 'S', 'P', 'P')
168 #define FSP_PATCH_TABLE_SIGNATURE FSP_FSPP_SIGNATURE
171 /// FSP Patch Table as described in FSP v2.0 Spec section 5.1.5.
175 /// Byte 0x00: FSP Patch Table Signature "FSPP".
179 /// Byte 0x04: Size including the PatchData.
183 /// Byte 0x06: Revision is set to 0x01.
185 UINT8 HeaderRevision
;
187 /// Byte 0x07: Reserved for future use.
191 /// Byte 0x08: Number of entries to Patch.
193 UINT32 PatchEntryNum
;
195 /// Byte 0x0C: Patch Data.
197 //UINT32 PatchData[];
202 extern EFI_GUID gFspHeaderFileGuid
;