2 HOB related definitions in PI.
4 Copyright (c) 2006 - 2008, Intel Corporation
5 All rights reserved. This program and the accompanying materials
6 are licensed and made available under the terms and conditions of the BSD License
7 which accompanies this distribution. The full text of the license may be found at
8 http://opensource.org/licenses/bsd-license.php
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
13 @par Revision Reference:
21 #include <ProcessorBind.h>
22 #include <Pi/PiBootMode.h>
23 #include <Uefi/UefiBaseType.h>
24 #include <Uefi/UefiMultiPhase.h>
27 // HobType of EFI_HOB_GENERIC_HEADER.
29 #define EFI_HOB_TYPE_HANDOFF 0x0001
30 #define EFI_HOB_TYPE_MEMORY_ALLOCATION 0x0002
31 #define EFI_HOB_TYPE_RESOURCE_DESCRIPTOR 0x0003
32 #define EFI_HOB_TYPE_GUID_EXTENSION 0x0004
33 #define EFI_HOB_TYPE_FV 0x0005
34 #define EFI_HOB_TYPE_CPU 0x0006
35 #define EFI_HOB_TYPE_MEMORY_POOL 0x0007
36 #define EFI_HOB_TYPE_FV2 0x0009
37 #define EFI_HOB_TYPE_LOAD_PEIM 0x000A
38 #define EFI_HOB_TYPE_UNUSED 0xFFFE
39 #define EFI_HOB_TYPE_END_OF_HOB_LIST 0xFFFF
42 /// Describes the format and size of the data inside the HOB.
43 /// All HOBs must contain this generic HOB header.
47 /// Identifies the HOB data structure type.
51 /// The length in bytes of the HOB.
55 /// This field must always be set to zero.
58 } EFI_HOB_GENERIC_HEADER
;
62 /// Value of version ofinEFI_HOB_HANDOFF_INFO_TABLE.
64 #define EFI_HOB_HANDOFF_TABLE_VERSION 0x0009
67 /// Contains general state information used by the HOB producer phase.
68 /// This HOB must be the first one in the HOB list.
72 /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_HANDOFF.
74 EFI_HOB_GENERIC_HEADER Header
;
76 /// The version number pertaining to the PHIT HOB definition.
77 /// This value is 4 bytes in length to provide an 8-byte aligned entry
78 /// when it is combined with the 4-byte BootMode.
82 /// The system boot mode as determined during the HOB producer phase.
84 EFI_BOOT_MODE BootMode
;
86 /// The highest address location of memory that is allocated for use by the HOB producer
87 /// phase. This address must be 4-KB aligned to meet page restrictions of UEFI.
89 EFI_PHYSICAL_ADDRESS EfiMemoryTop
;
91 /// The lowest address location of memory that is allocated for use by the HOB producer phase.
93 EFI_PHYSICAL_ADDRESS EfiMemoryBottom
;
95 /// The highest address location of free memory that is currently available
96 /// for use by the HOB producer phase.
98 EFI_PHYSICAL_ADDRESS EfiFreeMemoryTop
;
100 /// The lowest address location of free memory that is available for use by the HOB producer phase.
102 EFI_PHYSICAL_ADDRESS EfiFreeMemoryBottom
;
104 /// The end of the HOB list.
106 EFI_PHYSICAL_ADDRESS EfiEndOfHobList
;
107 } EFI_HOB_HANDOFF_INFO_TABLE
;
110 /// EFI_HOB_MEMORY_ALLOCATION_HEADER describes the
111 /// various attributes of the logical memory allocation. The type field will be used for
112 /// subsequent inclusion in the UEFI memory map.
116 /// A GUID that defines the memory allocation region's type and purpose, as well as
117 /// other fields within the memory allocation HOB. This GUID is used to define the
118 /// additional data within the HOB that may be present for the memory allocation HOB.
119 /// Type EFI_GUID is defined in InstallProtocolInterface() in the UEFI 2.0
125 /// The base address of memory allocated by this HOB. Type
126 /// EFI_PHYSICAL_ADDRESS is defined in AllocatePages() in the UEFI 2.0
129 EFI_PHYSICAL_ADDRESS MemoryBaseAddress
;
132 /// The length in bytes of memory allocated by this HOB.
137 /// Defines the type of memory allocated by this HOB. The memory type definition
138 /// follows the EFI_MEMORY_TYPE definition. Type EFI_MEMORY_TYPE is defined
139 /// in AllocatePages() in the UEFI 2.0 specification.
141 EFI_MEMORY_TYPE MemoryType
;
144 /// Padding for Itanium processor family
147 } EFI_HOB_MEMORY_ALLOCATION_HEADER
;
150 /// Describes all memory ranges used during the HOB producer
151 /// phase that exist outside the HOB list. This HOB type
152 /// describes how memory is used, not the physical attributes of memory.
156 /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_MEMORY_ALLOCATION.
158 EFI_HOB_GENERIC_HEADER Header
;
160 /// An instance of the EFI_HOB_MEMORY_ALLOCATION_HEADER that describes the
161 /// various attributes of the logical memory allocation.
163 EFI_HOB_MEMORY_ALLOCATION_HEADER AllocDescriptor
;
165 // Additional data pertaining to the "Name" Guid memory
168 } EFI_HOB_MEMORY_ALLOCATION
;
172 /// Describes the memory stack that is produced by the HOB producer
173 /// phase and upon which all postmemory-installed executable
174 /// content in the HOB producer phase is executing.
178 /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_MEMORY_ALLOCATION.
180 EFI_HOB_GENERIC_HEADER Header
;
182 /// An instance of the EFI_HOB_MEMORY_ALLOCATION_HEADER that describes the
183 /// various attributes of the logical memory allocation.
185 EFI_HOB_MEMORY_ALLOCATION_HEADER AllocDescriptor
;
186 } EFI_HOB_MEMORY_ALLOCATION_STACK
;
189 /// Defines the location of the boot-strap
190 /// processor (BSP) BSPStore ("Backing Store Pointer Store").
191 /// This HOB is valid for the Itanium processor family only
192 /// register overflow store.
196 /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_MEMORY_ALLOCATION.
198 EFI_HOB_GENERIC_HEADER Header
;
200 /// An instance of the EFI_HOB_MEMORY_ALLOCATION_HEADER that describes the
201 /// various attributes of the logical memory allocation.
203 EFI_HOB_MEMORY_ALLOCATION_HEADER AllocDescriptor
;
204 } EFI_HOB_MEMORY_ALLOCATION_BSP_STORE
;
207 /// Defines the location and entry point of the HOB consumer phase.
211 /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_MEMORY_ALLOCATION.
213 EFI_HOB_GENERIC_HEADER Header
;
215 /// An instance of the EFI_HOB_MEMORY_ALLOCATION_HEADER that describes the
216 /// various attributes of the logical memory allocation.
218 EFI_HOB_MEMORY_ALLOCATION_HEADER MemoryAllocationHeader
;
220 /// The GUID specifying the values of the firmware file system name
221 /// that contains the HOB consumer phase component.
225 /// The address of the memory-mapped firmware volume
226 /// that contains the HOB consumer phase firmware file.
228 EFI_PHYSICAL_ADDRESS EntryPoint
;
229 } EFI_HOB_MEMORY_ALLOCATION_MODULE
;
234 typedef UINT32 EFI_RESOURCE_TYPE
;
237 // Value of ResourceType in EFI_HOB_RESOURCE_DESCRIPTOR.
239 #define EFI_RESOURCE_SYSTEM_MEMORY 0x00000000
240 #define EFI_RESOURCE_MEMORY_MAPPED_IO 0x00000001
241 #define EFI_RESOURCE_IO 0x00000002
242 #define EFI_RESOURCE_FIRMWARE_DEVICE 0x00000003
243 #define EFI_RESOURCE_MEMORY_MAPPED_IO_PORT 0x00000004
244 #define EFI_RESOURCE_MEMORY_RESERVED 0x00000005
245 #define EFI_RESOURCE_IO_RESERVED 0x00000006
246 #define EFI_RESOURCE_MAX_MEMORY_TYPE 0x00000007
249 /// type of recount attribute type
251 typedef UINT32 EFI_RESOURCE_ATTRIBUTE_TYPE
;
254 // These types can be ORed together as needed.
256 // The first three enumerations describe settings
258 #define EFI_RESOURCE_ATTRIBUTE_PRESENT 0x00000001
259 #define EFI_RESOURCE_ATTRIBUTE_INITIALIZED 0x00000002
260 #define EFI_RESOURCE_ATTRIBUTE_TESTED 0x00000004
262 // The rest of the settings describe capabilities
264 #define EFI_RESOURCE_ATTRIBUTE_SINGLE_BIT_ECC 0x00000008
265 #define EFI_RESOURCE_ATTRIBUTE_MULTIPLE_BIT_ECC 0x00000010
266 #define EFI_RESOURCE_ATTRIBUTE_ECC_RESERVED_1 0x00000020
267 #define EFI_RESOURCE_ATTRIBUTE_ECC_RESERVED_2 0x00000040
268 #define EFI_RESOURCE_ATTRIBUTE_READ_PROTECTED 0x00000080
269 #define EFI_RESOURCE_ATTRIBUTE_WRITE_PROTECTED 0x00000100
270 #define EFI_RESOURCE_ATTRIBUTE_EXECUTION_PROTECTED 0x00000200
271 #define EFI_RESOURCE_ATTRIBUTE_UNCACHEABLE 0x00000400
272 #define EFI_RESOURCE_ATTRIBUTE_WRITE_COMBINEABLE 0x00000800
273 #define EFI_RESOURCE_ATTRIBUTE_WRITE_THROUGH_CACHEABLE 0x00001000
274 #define EFI_RESOURCE_ATTRIBUTE_WRITE_BACK_CACHEABLE 0x00002000
275 #define EFI_RESOURCE_ATTRIBUTE_16_BIT_IO 0x00004000
276 #define EFI_RESOURCE_ATTRIBUTE_32_BIT_IO 0x00008000
277 #define EFI_RESOURCE_ATTRIBUTE_64_BIT_IO 0x00010000
278 #define EFI_RESOURCE_ATTRIBUTE_UNCACHED_EXPORTED 0x00020000
281 /// Describes the resource properties of all fixed,
282 /// nonrelocatable resource ranges found on the processor
283 /// host bus during the HOB producer phase.
287 /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_RESOURCE_DESCRIPTOR.
289 EFI_HOB_GENERIC_HEADER Header
;
291 /// A GUID representing the owner of the resource. This GUID is used by HOB
292 /// consumer phase components to correlate device ownership of a resource.
296 /// Resource type enumeration as defined by EFI_RESOURCE_TYPE.
298 EFI_RESOURCE_TYPE ResourceType
;
300 /// Resource attributes as defined by EFI_RESOURCE_ATTRIBUTE_TYPE.
302 EFI_RESOURCE_ATTRIBUTE_TYPE ResourceAttribute
;
304 /// Physical start address of the resource region.
306 EFI_PHYSICAL_ADDRESS PhysicalStart
;
308 /// Number of bytes of the resource region.
310 UINT64 ResourceLength
;
311 } EFI_HOB_RESOURCE_DESCRIPTOR
;
314 /// Allows writers of executable content in the HOB producer phase to
315 /// maintain and manage HOBs with specific GUID.
319 /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_GUID_EXTENSION.
321 EFI_HOB_GENERIC_HEADER Header
;
323 /// A GUID that defines the contents of this HOB.
327 // Guid specific data goes here
332 /// Details the location of firmware volumes that contain firmware files.
336 /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_FV.
338 EFI_HOB_GENERIC_HEADER Header
;
340 /// The physical memory-mapped base address of the firmware volume.
342 EFI_PHYSICAL_ADDRESS BaseAddress
;
344 /// The length in bytes of the firmware volume.
347 } EFI_HOB_FIRMWARE_VOLUME
;
350 /// Details the location of a firmware volume which was extracted
351 /// from a file within another firmware volume.
355 /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_FV2.
357 EFI_HOB_GENERIC_HEADER Header
;
359 /// The physical memory-mapped base address of the firmware volume.
361 EFI_PHYSICAL_ADDRESS BaseAddress
;
363 /// The length in bytes of the firmware volume.
367 /// The name of the firmware volume.
371 /// The name of the firmware file which contained this firmware volume.
374 } EFI_HOB_FIRMWARE_VOLUME2
;
378 /// Describes processor information, such as address space and I/O space capabilities.
382 /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_CPU.
384 EFI_HOB_GENERIC_HEADER Header
;
386 /// Identifies the maximum physical memory addressability of the processor.
388 UINT8 SizeOfMemorySpace
;
390 /// Identifies the maximum physical I/O addressability of the processor.
394 /// This field will always be set to zero.
401 /// Describes pool memory allocations.
405 /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_MEMORY_POOL.
407 EFI_HOB_GENERIC_HEADER Header
;
408 } EFI_HOB_MEMORY_POOL
;
411 /// Union of all the possible HOB Types
414 EFI_HOB_GENERIC_HEADER
*Header
;
415 EFI_HOB_HANDOFF_INFO_TABLE
*HandoffInformationTable
;
416 EFI_HOB_MEMORY_ALLOCATION
*MemoryAllocation
;
417 EFI_HOB_MEMORY_ALLOCATION_BSP_STORE
*MemoryAllocationBspStore
;
418 EFI_HOB_MEMORY_ALLOCATION_STACK
*MemoryAllocationStack
;
419 EFI_HOB_MEMORY_ALLOCATION_MODULE
*MemoryAllocationModule
;
420 EFI_HOB_RESOURCE_DESCRIPTOR
*ResourceDescriptor
;
421 EFI_HOB_GUID_TYPE
*Guid
;
422 EFI_HOB_FIRMWARE_VOLUME
*FirmwareVolume
;
423 EFI_HOB_FIRMWARE_VOLUME2
*FirmwareVolume2
;
425 EFI_HOB_MEMORY_POOL
*Pool
;
427 } EFI_PEI_HOB_POINTERS
;