| /** @file |
| HOB related definitions in PI. |
| |
| Copyright (c) 2006 - 2017, 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 that 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 Revision Reference: |
| PI Version 1.6 |
| |
| **/ |
| |
| #ifndef __PI_HOB_H__ |
| #define __PI_HOB_H__ |
| |
| // |
| // HobType of EFI_HOB_GENERIC_HEADER. |
| // |
| #define EFI_HOB_TYPE_HANDOFF 0x0001 |
| #define EFI_HOB_TYPE_MEMORY_ALLOCATION 0x0002 |
| #define EFI_HOB_TYPE_RESOURCE_DESCRIPTOR 0x0003 |
| #define EFI_HOB_TYPE_GUID_EXTENSION 0x0004 |
| #define EFI_HOB_TYPE_FV 0x0005 |
| #define EFI_HOB_TYPE_CPU 0x0006 |
| #define EFI_HOB_TYPE_MEMORY_POOL 0x0007 |
| #define EFI_HOB_TYPE_FV2 0x0009 |
| #define EFI_HOB_TYPE_LOAD_PEIM_UNUSED 0x000A |
| #define EFI_HOB_TYPE_UEFI_CAPSULE 0x000B |
| #define EFI_HOB_TYPE_FV3 0x000C |
| #define EFI_HOB_TYPE_UNUSED 0xFFFE |
| #define EFI_HOB_TYPE_END_OF_HOB_LIST 0xFFFF |
| |
| /// |
| /// Describes the format and size of the data inside the HOB. |
| /// All HOBs must contain this generic HOB header. |
| /// |
| typedef struct { |
| /// |
| /// Identifies the HOB data structure type. |
| /// |
| UINT16 HobType; |
| /// |
| /// The length in bytes of the HOB. |
| /// |
| UINT16 HobLength; |
| /// |
| /// This field must always be set to zero. |
| /// |
| UINT32 Reserved; |
| } EFI_HOB_GENERIC_HEADER; |
| |
| |
| /// |
| /// Value of version in EFI_HOB_HANDOFF_INFO_TABLE. |
| /// |
| #define EFI_HOB_HANDOFF_TABLE_VERSION 0x0009 |
| |
| /// |
| /// Contains general state information used by the HOB producer phase. |
| /// This HOB must be the first one in the HOB list. |
| /// |
| typedef struct { |
| /// |
| /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_HANDOFF. |
| /// |
| EFI_HOB_GENERIC_HEADER Header; |
| /// |
| /// The version number pertaining to the PHIT HOB definition. |
| /// This value is four bytes in length to provide an 8-byte aligned entry |
| /// when it is combined with the 4-byte BootMode. |
| /// |
| UINT32 Version; |
| /// |
| /// The system boot mode as determined during the HOB producer phase. |
| /// |
| EFI_BOOT_MODE BootMode; |
| /// |
| /// The highest address location of memory that is allocated for use by the HOB producer |
| /// phase. This address must be 4-KB aligned to meet page restrictions of UEFI. |
| /// |
| EFI_PHYSICAL_ADDRESS EfiMemoryTop; |
| /// |
| /// The lowest address location of memory that is allocated for use by the HOB producer phase. |
| /// |
| EFI_PHYSICAL_ADDRESS EfiMemoryBottom; |
| /// |
| /// The highest address location of free memory that is currently available |
| /// for use by the HOB producer phase. |
| /// |
| EFI_PHYSICAL_ADDRESS EfiFreeMemoryTop; |
| /// |
| /// The lowest address location of free memory that is available for use by the HOB producer phase. |
| /// |
| EFI_PHYSICAL_ADDRESS EfiFreeMemoryBottom; |
| /// |
| /// The end of the HOB list. |
| /// |
| EFI_PHYSICAL_ADDRESS EfiEndOfHobList; |
| } EFI_HOB_HANDOFF_INFO_TABLE; |
| |
| /// |
| /// EFI_HOB_MEMORY_ALLOCATION_HEADER describes the |
| /// various attributes of the logical memory allocation. The type field will be used for |
| /// subsequent inclusion in the UEFI memory map. |
| /// |
| typedef struct { |
| /// |
| /// A GUID that defines the memory allocation region's type and purpose, as well as |
| /// other fields within the memory allocation HOB. This GUID is used to define the |
| /// additional data within the HOB that may be present for the memory allocation HOB. |
| /// Type EFI_GUID is defined in InstallProtocolInterface() in the UEFI 2.0 |
| /// specification. |
| /// |
| EFI_GUID Name; |
| |
| /// |
| /// The base address of memory allocated by this HOB. Type |
| /// EFI_PHYSICAL_ADDRESS is defined in AllocatePages() in the UEFI 2.0 |
| /// specification. |
| /// |
| EFI_PHYSICAL_ADDRESS MemoryBaseAddress; |
| |
| /// |
| /// The length in bytes of memory allocated by this HOB. |
| /// |
| UINT64 MemoryLength; |
| |
| /// |
| /// Defines the type of memory allocated by this HOB. The memory type definition |
| /// follows the EFI_MEMORY_TYPE definition. Type EFI_MEMORY_TYPE is defined |
| /// in AllocatePages() in the UEFI 2.0 specification. |
| /// |
| EFI_MEMORY_TYPE MemoryType; |
| |
| /// |
| /// Padding for Itanium processor family |
| /// |
| UINT8 Reserved[4]; |
| } EFI_HOB_MEMORY_ALLOCATION_HEADER; |
| |
| /// |
| /// Describes all memory ranges used during the HOB producer |
| /// phase that exist outside the HOB list. This HOB type |
| /// describes how memory is used, not the physical attributes of memory. |
| /// |
| typedef struct { |
| /// |
| /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_MEMORY_ALLOCATION. |
| /// |
| EFI_HOB_GENERIC_HEADER Header; |
| /// |
| /// An instance of the EFI_HOB_MEMORY_ALLOCATION_HEADER that describes the |
| /// various attributes of the logical memory allocation. |
| /// |
| EFI_HOB_MEMORY_ALLOCATION_HEADER AllocDescriptor; |
| // |
| // Additional data pertaining to the "Name" Guid memory |
| // may go here. |
| // |
| } EFI_HOB_MEMORY_ALLOCATION; |
| |
| |
| /// |
| /// Describes the memory stack that is produced by the HOB producer |
| /// phase and upon which all post-memory-installed executable |
| /// content in the HOB producer phase is executing. |
| /// |
| typedef struct { |
| /// |
| /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_MEMORY_ALLOCATION. |
| /// |
| EFI_HOB_GENERIC_HEADER Header; |
| /// |
| /// An instance of the EFI_HOB_MEMORY_ALLOCATION_HEADER that describes the |
| /// various attributes of the logical memory allocation. |
| /// |
| EFI_HOB_MEMORY_ALLOCATION_HEADER AllocDescriptor; |
| } EFI_HOB_MEMORY_ALLOCATION_STACK; |
| |
| /// |
| /// Defines the location of the boot-strap |
| /// processor (BSP) BSPStore ("Backing Store Pointer Store"). |
| /// This HOB is valid for the Itanium processor family only |
| /// register overflow store. |
| /// |
| typedef struct { |
| /// |
| /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_MEMORY_ALLOCATION. |
| /// |
| EFI_HOB_GENERIC_HEADER Header; |
| /// |
| /// An instance of the EFI_HOB_MEMORY_ALLOCATION_HEADER that describes the |
| /// various attributes of the logical memory allocation. |
| /// |
| EFI_HOB_MEMORY_ALLOCATION_HEADER AllocDescriptor; |
| } EFI_HOB_MEMORY_ALLOCATION_BSP_STORE; |
| |
| /// |
| /// Defines the location and entry point of the HOB consumer phase. |
| /// |
| typedef struct { |
| /// |
| /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_MEMORY_ALLOCATION. |
| /// |
| EFI_HOB_GENERIC_HEADER Header; |
| /// |
| /// An instance of the EFI_HOB_MEMORY_ALLOCATION_HEADER that describes the |
| /// various attributes of the logical memory allocation. |
| /// |
| EFI_HOB_MEMORY_ALLOCATION_HEADER MemoryAllocationHeader; |
| /// |
| /// The GUID specifying the values of the firmware file system name |
| /// that contains the HOB consumer phase component. |
| /// |
| EFI_GUID ModuleName; |
| /// |
| /// The address of the memory-mapped firmware volume |
| /// that contains the HOB consumer phase firmware file. |
| /// |
| EFI_PHYSICAL_ADDRESS EntryPoint; |
| } EFI_HOB_MEMORY_ALLOCATION_MODULE; |
| |
| /// |
| /// The resource type. |
| /// |
| typedef UINT32 EFI_RESOURCE_TYPE; |
| |
| // |
| // Value of ResourceType in EFI_HOB_RESOURCE_DESCRIPTOR. |
| // |
| #define EFI_RESOURCE_SYSTEM_MEMORY 0x00000000 |
| #define EFI_RESOURCE_MEMORY_MAPPED_IO 0x00000001 |
| #define EFI_RESOURCE_IO 0x00000002 |
| #define EFI_RESOURCE_FIRMWARE_DEVICE 0x00000003 |
| #define EFI_RESOURCE_MEMORY_MAPPED_IO_PORT 0x00000004 |
| #define EFI_RESOURCE_MEMORY_RESERVED 0x00000005 |
| #define EFI_RESOURCE_IO_RESERVED 0x00000006 |
| #define EFI_RESOURCE_MAX_MEMORY_TYPE 0x00000007 |
| |
| /// |
| /// A type of recount attribute type. |
| /// |
| typedef UINT32 EFI_RESOURCE_ATTRIBUTE_TYPE; |
| |
| // |
| // These types can be ORed together as needed. |
| // |
| // The following attributes are used to describe settings |
| // |
| #define EFI_RESOURCE_ATTRIBUTE_PRESENT 0x00000001 |
| #define EFI_RESOURCE_ATTRIBUTE_INITIALIZED 0x00000002 |
| #define EFI_RESOURCE_ATTRIBUTE_TESTED 0x00000004 |
| #define EFI_RESOURCE_ATTRIBUTE_READ_PROTECTED 0x00000080 |
| // |
| // This is typically used as memory cacheability attribute today. |
| // NOTE: Since PI spec 1.4, please use EFI_RESOURCE_ATTRIBUTE_READ_ONLY_PROTECTED |
| // as Physical write protected attribute, and EFI_RESOURCE_ATTRIBUTE_WRITE_PROTECTED |
| // means Memory cacheability attribute: The memory supports being programmed with |
| // a writeprotected cacheable attribute. |
| // |
| #define EFI_RESOURCE_ATTRIBUTE_WRITE_PROTECTED 0x00000100 |
| #define EFI_RESOURCE_ATTRIBUTE_EXECUTION_PROTECTED 0x00000200 |
| #define EFI_RESOURCE_ATTRIBUTE_PERSISTENT 0x00800000 |
| // |
| // The rest of the attributes are used to describe capabilities |
| // |
| #define EFI_RESOURCE_ATTRIBUTE_SINGLE_BIT_ECC 0x00000008 |
| #define EFI_RESOURCE_ATTRIBUTE_MULTIPLE_BIT_ECC 0x00000010 |
| #define EFI_RESOURCE_ATTRIBUTE_ECC_RESERVED_1 0x00000020 |
| #define EFI_RESOURCE_ATTRIBUTE_ECC_RESERVED_2 0x00000040 |
| #define EFI_RESOURCE_ATTRIBUTE_UNCACHEABLE 0x00000400 |
| #define EFI_RESOURCE_ATTRIBUTE_WRITE_COMBINEABLE 0x00000800 |
| #define EFI_RESOURCE_ATTRIBUTE_WRITE_THROUGH_CACHEABLE 0x00001000 |
| #define EFI_RESOURCE_ATTRIBUTE_WRITE_BACK_CACHEABLE 0x00002000 |
| #define EFI_RESOURCE_ATTRIBUTE_16_BIT_IO 0x00004000 |
| #define EFI_RESOURCE_ATTRIBUTE_32_BIT_IO 0x00008000 |
| #define EFI_RESOURCE_ATTRIBUTE_64_BIT_IO 0x00010000 |
| #define EFI_RESOURCE_ATTRIBUTE_UNCACHED_EXPORTED 0x00020000 |
| #define EFI_RESOURCE_ATTRIBUTE_READ_PROTECTABLE 0x00100000 |
| // |
| // This is typically used as memory cacheability attribute today. |
| // NOTE: Since PI spec 1.4, please use EFI_RESOURCE_ATTRIBUTE_READ_ONLY_PROTECTABLE |
| // as Memory capability attribute: The memory supports being protected from processor |
| // writes, and EFI_RESOURCE_ATTRIBUTE_WRITE_PROTEC TABLE means Memory cacheability attribute: |
| // The memory supports being programmed with a writeprotected cacheable attribute. |
| // |
| #define EFI_RESOURCE_ATTRIBUTE_WRITE_PROTECTABLE 0x00200000 |
| #define EFI_RESOURCE_ATTRIBUTE_EXECUTION_PROTECTABLE 0x00400000 |
| #define EFI_RESOURCE_ATTRIBUTE_PERSISTABLE 0x01000000 |
| |
| #define EFI_RESOURCE_ATTRIBUTE_READ_ONLY_PROTECTED 0x00040000 |
| #define EFI_RESOURCE_ATTRIBUTE_READ_ONLY_PROTECTABLE 0x00080000 |
| |
| // |
| // Physical memory relative reliability attribute. This |
| // memory provides higher reliability relative to other |
| // memory in the system. If all memory has the same |
| // reliability, then this bit is not used. |
| // |
| #define EFI_RESOURCE_ATTRIBUTE_MORE_RELIABLE 0x02000000 |
| |
| /// |
| /// Describes the resource properties of all fixed, |
| /// nonrelocatable resource ranges found on the processor |
| /// host bus during the HOB producer phase. |
| /// |
| typedef struct { |
| /// |
| /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_RESOURCE_DESCRIPTOR. |
| /// |
| EFI_HOB_GENERIC_HEADER Header; |
| /// |
| /// A GUID representing the owner of the resource. This GUID is used by HOB |
| /// consumer phase components to correlate device ownership of a resource. |
| /// |
| EFI_GUID Owner; |
| /// |
| /// The resource type enumeration as defined by EFI_RESOURCE_TYPE. |
| /// |
| EFI_RESOURCE_TYPE ResourceType; |
| /// |
| /// Resource attributes as defined by EFI_RESOURCE_ATTRIBUTE_TYPE. |
| /// |
| EFI_RESOURCE_ATTRIBUTE_TYPE ResourceAttribute; |
| /// |
| /// The physical start address of the resource region. |
| /// |
| EFI_PHYSICAL_ADDRESS PhysicalStart; |
| /// |
| /// The number of bytes of the resource region. |
| /// |
| UINT64 ResourceLength; |
| } EFI_HOB_RESOURCE_DESCRIPTOR; |
| |
| /// |
| /// Allows writers of executable content in the HOB producer phase to |
| /// maintain and manage HOBs with specific GUID. |
| /// |
| typedef struct { |
| /// |
| /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_GUID_EXTENSION. |
| /// |
| EFI_HOB_GENERIC_HEADER Header; |
| /// |
| /// A GUID that defines the contents of this HOB. |
| /// |
| EFI_GUID Name; |
| // |
| // Guid specific data goes here |
| // |
| } EFI_HOB_GUID_TYPE; |
| |
| /// |
| /// Details the location of firmware volumes that contain firmware files. |
| /// |
| typedef struct { |
| /// |
| /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_FV. |
| /// |
| EFI_HOB_GENERIC_HEADER Header; |
| /// |
| /// The physical memory-mapped base address of the firmware volume. |
| /// |
| EFI_PHYSICAL_ADDRESS BaseAddress; |
| /// |
| /// The length in bytes of the firmware volume. |
| /// |
| UINT64 Length; |
| } EFI_HOB_FIRMWARE_VOLUME; |
| |
| /// |
| /// Details the location of a firmware volume that was extracted |
| /// from a file within another firmware volume. |
| /// |
| typedef struct { |
| /// |
| /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_FV2. |
| /// |
| EFI_HOB_GENERIC_HEADER Header; |
| /// |
| /// The physical memory-mapped base address of the firmware volume. |
| /// |
| EFI_PHYSICAL_ADDRESS BaseAddress; |
| /// |
| /// The length in bytes of the firmware volume. |
| /// |
| UINT64 Length; |
| /// |
| /// The name of the firmware volume. |
| /// |
| EFI_GUID FvName; |
| /// |
| /// The name of the firmware file that contained this firmware volume. |
| /// |
| EFI_GUID FileName; |
| } EFI_HOB_FIRMWARE_VOLUME2; |
| |
| /// |
| /// Details the location of a firmware volume that was extracted |
| /// from a file within another firmware volume. |
| /// |
| typedef struct { |
| /// |
| /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_FV3. |
| /// |
| EFI_HOB_GENERIC_HEADER Header; |
| /// |
| /// The physical memory-mapped base address of the firmware volume. |
| /// |
| EFI_PHYSICAL_ADDRESS BaseAddress; |
| /// |
| /// The length in bytes of the firmware volume. |
| /// |
| UINT64 Length; |
| /// |
| /// The authentication status. |
| /// |
| UINT32 AuthenticationStatus; |
| /// |
| /// TRUE if the FV was extracted as a file within another firmware volume. |
| /// FALSE otherwise. |
| /// |
| BOOLEAN ExtractedFv; |
| /// |
| /// The name of the firmware volume. |
| /// Valid only if IsExtractedFv is TRUE. |
| /// |
| EFI_GUID FvName; |
| /// |
| /// The name of the firmware file that contained this firmware volume. |
| /// Valid only if IsExtractedFv is TRUE. |
| /// |
| EFI_GUID FileName; |
| } EFI_HOB_FIRMWARE_VOLUME3; |
| |
| /// |
| /// Describes processor information, such as address space and I/O space capabilities. |
| /// |
| typedef struct { |
| /// |
| /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_CPU. |
| /// |
| EFI_HOB_GENERIC_HEADER Header; |
| /// |
| /// Identifies the maximum physical memory addressability of the processor. |
| /// |
| UINT8 SizeOfMemorySpace; |
| /// |
| /// Identifies the maximum physical I/O addressability of the processor. |
| /// |
| UINT8 SizeOfIoSpace; |
| /// |
| /// This field will always be set to zero. |
| /// |
| UINT8 Reserved[6]; |
| } EFI_HOB_CPU; |
| |
| |
| /// |
| /// Describes pool memory allocations. |
| /// |
| typedef struct { |
| /// |
| /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_MEMORY_POOL. |
| /// |
| EFI_HOB_GENERIC_HEADER Header; |
| } EFI_HOB_MEMORY_POOL; |
| |
| /// |
| /// Each UEFI capsule HOB details the location of a UEFI capsule. It includes a base address and length |
| /// which is based upon memory blocks with a EFI_CAPSULE_HEADER and the associated |
| /// CapsuleImageSize-based payloads. These HOB's shall be created by the PEI PI firmware |
| /// sometime after the UEFI UpdateCapsule service invocation with the |
| /// CAPSULE_FLAGS_POPULATE_SYSTEM_TABLE flag set in the EFI_CAPSULE_HEADER. |
| /// |
| typedef struct { |
| /// |
| /// The HOB generic header where Header.HobType = EFI_HOB_TYPE_UEFI_CAPSULE. |
| /// |
| EFI_HOB_GENERIC_HEADER Header; |
| |
| /// |
| /// The physical memory-mapped base address of an UEFI capsule. This value is set to |
| /// point to the base of the contiguous memory of the UEFI capsule. |
| /// The length of the contiguous memory in bytes. |
| /// |
| EFI_PHYSICAL_ADDRESS BaseAddress; |
| UINT64 Length; |
| } EFI_HOB_UEFI_CAPSULE; |
| |
| /// |
| /// Union of all the possible HOB Types. |
| /// |
| typedef union { |
| EFI_HOB_GENERIC_HEADER *Header; |
| EFI_HOB_HANDOFF_INFO_TABLE *HandoffInformationTable; |
| EFI_HOB_MEMORY_ALLOCATION *MemoryAllocation; |
| EFI_HOB_MEMORY_ALLOCATION_BSP_STORE *MemoryAllocationBspStore; |
| EFI_HOB_MEMORY_ALLOCATION_STACK *MemoryAllocationStack; |
| EFI_HOB_MEMORY_ALLOCATION_MODULE *MemoryAllocationModule; |
| EFI_HOB_RESOURCE_DESCRIPTOR *ResourceDescriptor; |
| EFI_HOB_GUID_TYPE *Guid; |
| EFI_HOB_FIRMWARE_VOLUME *FirmwareVolume; |
| EFI_HOB_FIRMWARE_VOLUME2 *FirmwareVolume2; |
| EFI_HOB_FIRMWARE_VOLUME3 *FirmwareVolume3; |
| EFI_HOB_CPU *Cpu; |
| EFI_HOB_MEMORY_POOL *Pool; |
| EFI_HOB_UEFI_CAPSULE *Capsule; |
| UINT8 *Raw; |
| } EFI_PEI_HOB_POINTERS; |
| |
| |
| #endif |