/** @file\r
HOB related definitions in PI.\r
\r
- Copyright (c) 2006 - 2008, Intel Corporation \r
- All rights reserved. This program and the accompanying materials \r
- are licensed and made available under the terms and conditions of the BSD License \r
- which accompanies this distribution. The full text of the license may be found at \r
- http://opensource.org/licenses/bsd-license.php \r
+Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved<BR>\r
+This program and the accompanying materials are licensed and made available under \r
+the terms and conditions of the BSD License that accompanies this distribution. \r
+The full text of the license may be found at\r
+http://opensource.org/licenses/bsd-license.php. \r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
\r
@par Revision Reference:\r
- Version 1.0.\r
+ PI Version 1.0\r
\r
**/\r
\r
#ifndef __PI_HOB_H__\r
#define __PI_HOB_H__\r
\r
-#include <ProcessorBind.h>\r
-#include <Pi/PiBootMode.h>\r
-#include <Uefi/UefiBaseType.h>\r
-#include <Uefi/UefiMultiPhase.h>\r
-\r
//\r
// HobType of EFI_HOB_GENERIC_HEADER.\r
// \r
#define EFI_HOB_TYPE_CPU 0x0006\r
#define EFI_HOB_TYPE_MEMORY_POOL 0x0007\r
#define EFI_HOB_TYPE_FV2 0x0009\r
-#define EFI_HOB_TYPE_LOAD_PEIM 0x000A\r
+#define EFI_HOB_TYPE_LOAD_PEIM_UNUSED 0x000A\r
+#define EFI_HOB_TYPE_UEFI_CAPSULE 0x000B\r
#define EFI_HOB_TYPE_UNUSED 0xFFFE\r
#define EFI_HOB_TYPE_END_OF_HOB_LIST 0xFFFF\r
\r
/// All HOBs must contain this generic HOB header.\r
/// \r
typedef struct {\r
+ ///\r
+ /// Identifies the HOB data structure type.\r
+ ///\r
UINT16 HobType;\r
+ ///\r
+ /// The length in bytes of the HOB.\r
+ ///\r
UINT16 HobLength;\r
+ ///\r
+ /// This field must always be set to zero.\r
+ ///\r
UINT32 Reserved;\r
} EFI_HOB_GENERIC_HEADER;\r
\r
\r
///\r
-/// Value of version ofinEFI_HOB_HANDOFF_INFO_TABLE.\r
+/// Value of version in EFI_HOB_HANDOFF_INFO_TABLE.\r
/// \r
#define EFI_HOB_HANDOFF_TABLE_VERSION 0x0009\r
\r
/// This HOB must be the first one in the HOB list.\r
/// \r
typedef struct {\r
+ ///\r
+ /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_HANDOFF.\r
+ ///\r
EFI_HOB_GENERIC_HEADER Header;\r
+ ///\r
+ /// The version number pertaining to the PHIT HOB definition.\r
+ /// This value is four bytes in length to provide an 8-byte aligned entry \r
+ /// when it is combined with the 4-byte BootMode.\r
+ ///\r
UINT32 Version;\r
+ ///\r
+ /// The system boot mode as determined during the HOB producer phase.\r
+ ///\r
EFI_BOOT_MODE BootMode;\r
+ ///\r
+ /// The highest address location of memory that is allocated for use by the HOB producer\r
+ /// phase. This address must be 4-KB aligned to meet page restrictions of UEFI.\r
+ ///\r
EFI_PHYSICAL_ADDRESS EfiMemoryTop;\r
+ ///\r
+ /// The lowest address location of memory that is allocated for use by the HOB producer phase.\r
+ ///\r
EFI_PHYSICAL_ADDRESS EfiMemoryBottom;\r
+ ///\r
+ /// The highest address location of free memory that is currently available \r
+ /// for use by the HOB producer phase.\r
+ ///\r
EFI_PHYSICAL_ADDRESS EfiFreeMemoryTop;\r
+ ///\r
+ /// The lowest address location of free memory that is available for use by the HOB producer phase.\r
+ ///\r
EFI_PHYSICAL_ADDRESS EfiFreeMemoryBottom;\r
+ ///\r
+ /// The end of the HOB list.\r
+ ///\r
EFI_PHYSICAL_ADDRESS EfiEndOfHobList;\r
} EFI_HOB_HANDOFF_INFO_TABLE;\r
\r
/// \r
typedef struct {\r
///\r
- /// A GUID that defines the memory allocation region¡¯s type and purpose, as well as\r
+ /// A GUID that defines the memory allocation region's type and purpose, as well as\r
/// other fields within the memory allocation HOB. This GUID is used to define the\r
/// additional data within the HOB that may be present for the memory allocation HOB.\r
/// Type EFI_GUID is defined in InstallProtocolInterface() in the UEFI 2.0\r
/// \r
EFI_GUID Name;\r
\r
+ ///\r
/// The base address of memory allocated by this HOB. Type\r
/// EFI_PHYSICAL_ADDRESS is defined in AllocatePages() in the UEFI 2.0\r
/// specification.\r
+ ///\r
EFI_PHYSICAL_ADDRESS MemoryBaseAddress;\r
\r
/// \r
///\r
/// Describes all memory ranges used during the HOB producer \r
/// phase that exist outside the HOB list. This HOB type \r
-/// describes how memory is used, \r
-/// not the physical attributes of memory.\r
-/// \r
+/// describes how memory is used, not the physical attributes of memory.\r
+///\r
typedef struct {\r
+ ///\r
+ /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_MEMORY_ALLOCATION.\r
+ ///\r
EFI_HOB_GENERIC_HEADER Header;\r
+ ///\r
+ /// An instance of the EFI_HOB_MEMORY_ALLOCATION_HEADER that describes the\r
+ /// various attributes of the logical memory allocation.\r
+ ///\r
EFI_HOB_MEMORY_ALLOCATION_HEADER AllocDescriptor;\r
//\r
// Additional data pertaining to the "Name" Guid memory\r
\r
///\r
/// Describes the memory stack that is produced by the HOB producer \r
-/// phase and upon which all postmemory-installed executable\r
+/// phase and upon which all post-memory-installed executable\r
/// content in the HOB producer phase is executing.\r
/// \r
typedef struct {\r
+ ///\r
+ /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_MEMORY_ALLOCATION.\r
+ ///\r
EFI_HOB_GENERIC_HEADER Header;\r
+ ///\r
+ /// An instance of the EFI_HOB_MEMORY_ALLOCATION_HEADER that describes the\r
+ /// various attributes of the logical memory allocation.\r
+ ///\r
EFI_HOB_MEMORY_ALLOCATION_HEADER AllocDescriptor;\r
} EFI_HOB_MEMORY_ALLOCATION_STACK;\r
\r
/// register overflow store.\r
/// \r
typedef struct {\r
+ ///\r
+ /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_MEMORY_ALLOCATION.\r
+ ///\r
EFI_HOB_GENERIC_HEADER Header;\r
+ ///\r
+ /// An instance of the EFI_HOB_MEMORY_ALLOCATION_HEADER that describes the\r
+ /// various attributes of the logical memory allocation.\r
+ ///\r
EFI_HOB_MEMORY_ALLOCATION_HEADER AllocDescriptor;\r
} EFI_HOB_MEMORY_ALLOCATION_BSP_STORE;\r
\r
/// Defines the location and entry point of the HOB consumer phase.\r
///\r
typedef struct {\r
+ ///\r
+ /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_MEMORY_ALLOCATION.\r
+ ///\r
EFI_HOB_GENERIC_HEADER Header;\r
+ ///\r
+ /// An instance of the EFI_HOB_MEMORY_ALLOCATION_HEADER that describes the\r
+ /// various attributes of the logical memory allocation.\r
+ ///\r
EFI_HOB_MEMORY_ALLOCATION_HEADER MemoryAllocationHeader;\r
+ ///\r
+ /// The GUID specifying the values of the firmware file system name \r
+ /// that contains the HOB consumer phase component.\r
+ ///\r
EFI_GUID ModuleName;\r
+ ///\r
+ /// The address of the memory-mapped firmware volume \r
+ /// that contains the HOB consumer phase firmware file.\r
+ ///\r
EFI_PHYSICAL_ADDRESS EntryPoint;\r
} EFI_HOB_MEMORY_ALLOCATION_MODULE;\r
\r
///\r
-/// type of Recount type \r
+/// The resource type.\r
/// \r
typedef UINT32 EFI_RESOURCE_TYPE;\r
\r
#define EFI_RESOURCE_MAX_MEMORY_TYPE 0x00000007\r
\r
///\r
-/// type of recount attribute type\r
+/// A type of recount attribute type.\r
/// \r
typedef UINT32 EFI_RESOURCE_ATTRIBUTE_TYPE;\r
\r
/// host bus during the HOB producer phase.\r
/// \r
typedef struct {\r
+ ///\r
+ /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_RESOURCE_DESCRIPTOR.\r
+ ///\r
EFI_HOB_GENERIC_HEADER Header;\r
+ ///\r
+ /// A GUID representing the owner of the resource. This GUID is used by HOB\r
+ /// consumer phase components to correlate device ownership of a resource.\r
+ ///\r
EFI_GUID Owner;\r
+ ///\r
+ /// The resource type enumeration as defined by EFI_RESOURCE_TYPE.\r
+ ///\r
EFI_RESOURCE_TYPE ResourceType;\r
+ ///\r
+ /// Resource attributes as defined by EFI_RESOURCE_ATTRIBUTE_TYPE.\r
+ ///\r
EFI_RESOURCE_ATTRIBUTE_TYPE ResourceAttribute;\r
+ ///\r
+ /// The physical start address of the resource region. \r
+ ///\r
EFI_PHYSICAL_ADDRESS PhysicalStart;\r
+ ///\r
+ /// The number of bytes of the resource region.\r
+ ///\r
UINT64 ResourceLength;\r
} EFI_HOB_RESOURCE_DESCRIPTOR;\r
\r
/// maintain and manage HOBs with specific GUID.\r
/// \r
typedef struct {\r
+ ///\r
+ /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_GUID_EXTENSION.\r
+ ///\r
EFI_HOB_GENERIC_HEADER Header;\r
- EFI_GUID Name;\r
-\r
///\r
- /// Guid specific data goes here\r
+ /// A GUID that defines the contents of this HOB.\r
///\r
+ EFI_GUID Name;\r
+ //\r
+ // Guid specific data goes here\r
+ //\r
} EFI_HOB_GUID_TYPE;\r
\r
///\r
/// Details the location of firmware volumes that contain firmware files.\r
/// \r
typedef struct {\r
+ ///\r
+ /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_FV.\r
+ ///\r
EFI_HOB_GENERIC_HEADER Header;\r
+ ///\r
+ /// The physical memory-mapped base address of the firmware volume.\r
+ ///\r
EFI_PHYSICAL_ADDRESS BaseAddress;\r
+ ///\r
+ /// The length in bytes of the firmware volume.\r
+ ///\r
UINT64 Length;\r
} EFI_HOB_FIRMWARE_VOLUME;\r
\r
///\r
-/// Details the location of a firmware volume which was extracted \r
+/// Details the location of a firmware volume that was extracted \r
/// from a file within another firmware volume.\r
/// \r
typedef struct {\r
+ ///\r
+ /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_FV2.\r
+ ///\r
EFI_HOB_GENERIC_HEADER Header;\r
+ ///\r
+ /// The physical memory-mapped base address of the firmware volume.\r
+ ///\r
EFI_PHYSICAL_ADDRESS BaseAddress;\r
+ ///\r
+ /// The length in bytes of the firmware volume.\r
+ ///\r
UINT64 Length;\r
+ ///\r
+ /// The name of the firmware volume.\r
+ ///\r
EFI_GUID FvName;\r
+ ///\r
+ /// The name of the firmware file that contained this firmware volume.\r
+ ///\r
EFI_GUID FileName;\r
} EFI_HOB_FIRMWARE_VOLUME2;\r
\r
/// Describes processor information, such as address space and I/O space capabilities.\r
///\r
typedef struct {\r
+ ///\r
+ /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_CPU.\r
+ ///\r
EFI_HOB_GENERIC_HEADER Header;\r
+ ///\r
+ /// Identifies the maximum physical memory addressability of the processor.\r
+ ///\r
UINT8 SizeOfMemorySpace;\r
+ ///\r
+ /// Identifies the maximum physical I/O addressability of the processor.\r
+ ///\r
UINT8 SizeOfIoSpace;\r
+ ///\r
+ /// This field will always be set to zero.\r
+ ///\r
UINT8 Reserved[6];\r
} EFI_HOB_CPU;\r
\r
/// Describes pool memory allocations.\r
/// \r
typedef struct {\r
+ ///\r
+ /// The HOB generic header. Header.HobType = EFI_HOB_TYPE_MEMORY_POOL.\r
+ ///\r
EFI_HOB_GENERIC_HEADER Header;\r
} EFI_HOB_MEMORY_POOL;\r
\r
///\r
-/// Union of all the possible HOB Types\r
+/// Each UEFI capsule HOB details the location of a UEFI capsule. It includes a base address and length\r
+/// which is based upon memory blocks with a EFI_CAPSULE_HEADER and the associated\r
+/// CapsuleImageSize-based payloads. These HOB's shall be created by the PEI PI firmware\r
+/// sometime after the UEFI UpdateCapsule service invocation with the\r
+/// CAPSULE_FLAGS_POPULATE_SYSTEM_TABLE flag set in the EFI_CAPSULE_HEADER.\r
+///\r
+typedef struct {\r
+ ///\r
+ /// The HOB generic header where Header.HobType = EFI_HOB_TYPE_UEFI_CAPSULE.\r
+ ///\r
+ EFI_HOB_GENERIC_HEADER Header;\r
+ \r
+ ///\r
+ /// The physical memory-mapped base address of an UEFI capsule. This value is set to\r
+ /// point to the base of the contiguous memory of the UEFI capsule.\r
+ /// The length of the contiguous memory in bytes.\r
+ ///\r
+ EFI_PHYSICAL_ADDRESS BaseAddress;\r
+ UINT64 Length;\r
+} EFI_HOB_UEFI_CAPSULE;\r
+\r
+///\r
+/// Union of all the possible HOB Types.\r
///\r
typedef union {\r
EFI_HOB_GENERIC_HEADER *Header;\r
EFI_HOB_FIRMWARE_VOLUME2 *FirmwareVolume2;\r
EFI_HOB_CPU *Cpu;\r
EFI_HOB_MEMORY_POOL *Pool;\r
+ EFI_HOB_UEFI_CAPSULE *Capsule;\r
UINT8 *Raw;\r
} EFI_PEI_HOB_POINTERS;\r
\r
projects / mirror_edk2.git / blobdiff