[mirror_edk2.git] / BaseTools / Source / C / Include / Common / PiFirmwareVolume.h

/** @file\r
  The firmware volume related definitions in PI.\r
\r
  @par Revision Reference:\r
  Version 1.2C\r
\r
  Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>\r
\r
  This program and the accompanying materials are licensed and made available\r
  under the terms and conditions of the BSD License which accompanies this\r
  distribution.  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
\r
**/\r
\r
#ifndef __PI_FIRMWAREVOLUME_H__\r
#define __PI_FIRMWAREVOLUME_H__\r
\r
//\r
// EFI_FV_FILE_ATTRIBUTES\r
//\r
typedef UINT32  EFI_FV_FILE_ATTRIBUTES;\r
\r
//\r
// Value of EFI_FV_FILE_ATTRIBUTES.\r
// \r
#define EFI_FV_FILE_ATTRIB_ALIGNMENT      0x0000001F\r
#define EFI_FV_FILE_ATTRIB_FIXED          0x00000100\r
#define EFI_FV_FILE_ATTRIB_MEMORY_MAPPED  0x00000200\r
\r
typedef UINT32  EFI_FVB_ATTRIBUTES_2;\r
\r
// \r
// Attributes bit definitions\r
// \r
#define EFI_FVB2_READ_DISABLED_CAP  0x00000001\r
#define EFI_FVB2_READ_ENABLED_CAP   0x00000002\r
#define EFI_FVB2_READ_STATUS        0x00000004\r
#define EFI_FVB2_WRITE_DISABLED_CAP 0x00000008\r
#define EFI_FVB2_WRITE_ENABLED_CAP  0x00000010\r
#define EFI_FVB2_WRITE_STATUS       0x00000020\r
#define EFI_FVB2_LOCK_CAP           0x00000040\r
#define EFI_FVB2_LOCK_STATUS        0x00000080\r
#define EFI_FVB2_STICKY_WRITE       0x00000200\r
#define EFI_FVB2_MEMORY_MAPPED      0x00000400\r
#define EFI_FVB2_ERASE_POLARITY     0x00000800\r
#define EFI_FVB2_READ_LOCK_CAP      0x00001000\r
#define EFI_FVB2_READ_LOCK_STATUS   0x00002000\r
#define EFI_FVB2_WRITE_LOCK_CAP     0x00004000\r
#define EFI_FVB2_WRITE_LOCK_STATUS  0x00008000\r
#define EFI_FVB2_ALIGNMENT          0x001F0000\r
#define EFI_FVB2_WEAK_ALIGNMENT     0x80000000\r
#define EFI_FVB2_ALIGNMENT_1        0x00000000\r
#define EFI_FVB2_ALIGNMENT_2        0x00010000\r
#define EFI_FVB2_ALIGNMENT_4        0x00020000\r
#define EFI_FVB2_ALIGNMENT_8        0x00030000\r
#define EFI_FVB2_ALIGNMENT_16       0x00040000\r
#define EFI_FVB2_ALIGNMENT_32       0x00050000\r
#define EFI_FVB2_ALIGNMENT_64       0x00060000\r
#define EFI_FVB2_ALIGNMENT_128      0x00070000\r
#define EFI_FVB2_ALIGNMENT_256      0x00080000\r
#define EFI_FVB2_ALIGNMENT_512      0x00090000\r
#define EFI_FVB2_ALIGNMENT_1K       0x000A0000\r
#define EFI_FVB2_ALIGNMENT_2K       0x000B0000\r
#define EFI_FVB2_ALIGNMENT_4K       0x000C0000\r
#define EFI_FVB2_ALIGNMENT_8K       0x000D0000\r
#define EFI_FVB2_ALIGNMENT_16K      0x000E0000\r
#define EFI_FVB2_ALIGNMENT_32K      0x000F0000\r
#define EFI_FVB2_ALIGNMENT_64K      0x00100000\r
#define EFI_FVB2_ALIGNMENT_128K     0x00110000\r
#define EFI_FVB2_ALIGNMENT_256K     0x00120000\r
#define EFI_FVB2_ALIGNMENT_512K     0x00130000\r
#define EFI_FVB2_ALIGNMENT_1M       0x00140000\r
#define EFI_FVB2_ALIGNMENT_2M       0x00150000\r
#define EFI_FVB2_ALIGNMENT_4M       0x00160000\r
#define EFI_FVB2_ALIGNMENT_8M       0x00170000\r
#define EFI_FVB2_ALIGNMENT_16M      0x00180000\r
#define EFI_FVB2_ALIGNMENT_32M      0x00190000\r
#define EFI_FVB2_ALIGNMENT_64M      0x001A0000\r
#define EFI_FVB2_ALIGNMENT_128M     0x001B0000\r
#define EFI_FVB2_ALIGNMENT_256M     0x001C0000\r
#define EFI_FVB2_ALIGNMENT_512M     0x001D0000\r
#define EFI_FVB2_ALIGNMENT_1G       0x001E0000\r
#define EFI_FVB2_ALIGNMENT_2G       0x001F0000\r
\r
\r
typedef struct {\r
  UINT32 NumBlocks;\r
  UINT32 Length;\r
} EFI_FV_BLOCK_MAP_ENTRY;\r
\r
//\r
// Describes the features and layout of the firmware volume.\r
//\r
typedef struct {\r
  UINT8                     ZeroVector[16];\r
  EFI_GUID                  FileSystemGuid;\r
  UINT64                    FvLength;\r
  UINT32                    Signature;\r
  EFI_FVB_ATTRIBUTES_2      Attributes;\r
  UINT16                    HeaderLength;\r
  UINT16                    Checksum;\r
  UINT16                    ExtHeaderOffset;\r
  UINT8                     Reserved[1];\r
  UINT8                     Revision;\r
  EFI_FV_BLOCK_MAP_ENTRY    BlockMap[1];\r
} EFI_FIRMWARE_VOLUME_HEADER;\r
\r
#define EFI_FVH_SIGNATURE SIGNATURE_32 ('_', 'F', 'V', 'H')\r
\r
///\r
/// Firmware Volume Header Revision definition\r
///\r
#define EFI_FVH_REVISION  0x02\r
\r
//\r
// Extension header pointed by ExtHeaderOffset of volume header.\r
// \r
typedef struct {\r
  EFI_GUID  FvName;\r
  UINT32    ExtHeaderSize;\r
} EFI_FIRMWARE_VOLUME_EXT_HEADER;\r
\r
typedef struct {\r
  UINT16    ExtEntrySize;\r
  UINT16    ExtEntryType;\r
} EFI_FIRMWARE_VOLUME_EXT_ENTRY;\r
\r
#define EFI_FV_EXT_TYPE_OEM_TYPE  0x01\r
typedef struct {\r
  EFI_FIRMWARE_VOLUME_EXT_ENTRY Hdr;\r
  UINT32    TypeMask;\r
\r
  //\r
  // Array of GUIDs. \r
  // Each GUID represents an OEM file type.\r
  // \r
  // EFI_GUID  Types[1];\r
  //\r
} EFI_FIRMWARE_VOLUME_EXT_ENTRY_OEM_TYPE;\r
\r
#define EFI_FV_EXT_TYPE_GUID_TYPE 0x0002\r
typedef struct {\r
  EFI_FIRMWARE_VOLUME_EXT_ENTRY     Hdr;\r
  EFI_GUID                          FormatType;\r
\r
  //\r
  // An arry of bytes of length Length.\r
  //\r
  // UINT8                             Data[1];\r
  //\r
} EFI_FIRMWARE_VOLUME_EXT_ENTRY_GUID_TYPE;\r
\r
#define EFI_FV_EXT_TYPE_USED_SIZE_TYPE 0x03\r
typedef struct {\r
  EFI_FIRMWARE_VOLUME_EXT_ENTRY Hdr;\r
  UINT32 UsedSize;\r
} EFI_FIRMWARE_VOLUME_EXT_ENTRY_USED_SIZE_TYPE;\r
\r
#endif\r
Commit	Line	Data
30fdf114 LG	1	/** @file\r
	2	The firmware volume related definitions in PI.\r
	3	\r
97fa0ee9 YL	4	@par Revision Reference:\r
	5	Version 1.2C\r
	6	\r
	7	Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>\r
30fdf114 LG	8	\r
	9	This program and the accompanying materials are licensed and made available\r
	10	under the terms and conditions of the BSD License which accompanies this\r
97fa0ee9	11	distribution. The full text of the license may be found at\r
30fdf114 LG	12	http://opensource.org/licenses/bsd-license.php\r
	13	\r
	14	THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
	15	WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
	16	\r
30fdf114 LG	17	**/\r
	18	\r
	19	#ifndef __PI_FIRMWAREVOLUME_H__\r
	20	#define __PI_FIRMWAREVOLUME_H__\r
	21	\r
	22	//\r
	23	// EFI_FV_FILE_ATTRIBUTES\r
	24	//\r
	25	typedef UINT32 EFI_FV_FILE_ATTRIBUTES;\r
	26	\r
	27	//\r
	28	// Value of EFI_FV_FILE_ATTRIBUTES.\r
	29	// \r
	30	#define EFI_FV_FILE_ATTRIB_ALIGNMENT 0x0000001F\r
	31	#define EFI_FV_FILE_ATTRIB_FIXED 0x00000100\r
	32	#define EFI_FV_FILE_ATTRIB_MEMORY_MAPPED 0x00000200\r
	33	\r
2bcc713e	34	typedef UINT32 EFI_FVB_ATTRIBUTES_2;\r
30fdf114 LG	35	\r
	36	// \r
	37	// Attributes bit definitions\r
	38	// \r
	39	#define EFI_FVB2_READ_DISABLED_CAP 0x00000001\r
	40	#define EFI_FVB2_READ_ENABLED_CAP 0x00000002\r
	41	#define EFI_FVB2_READ_STATUS 0x00000004\r
	42	#define EFI_FVB2_WRITE_DISABLED_CAP 0x00000008\r
	43	#define EFI_FVB2_WRITE_ENABLED_CAP 0x00000010\r
	44	#define EFI_FVB2_WRITE_STATUS 0x00000020\r
	45	#define EFI_FVB2_LOCK_CAP 0x00000040\r
	46	#define EFI_FVB2_LOCK_STATUS 0x00000080\r
	47	#define EFI_FVB2_STICKY_WRITE 0x00000200\r
	48	#define EFI_FVB2_MEMORY_MAPPED 0x00000400\r
	49	#define EFI_FVB2_ERASE_POLARITY 0x00000800\r
	50	#define EFI_FVB2_READ_LOCK_CAP 0x00001000\r
	51	#define EFI_FVB2_READ_LOCK_STATUS 0x00002000\r
	52	#define EFI_FVB2_WRITE_LOCK_CAP 0x00004000\r
	53	#define EFI_FVB2_WRITE_LOCK_STATUS 0x00008000\r
	54	#define EFI_FVB2_ALIGNMENT 0x001F0000\r
e8a47801	55	#define EFI_FVB2_WEAK_ALIGNMENT 0x80000000\r
30fdf114 LG	56	#define EFI_FVB2_ALIGNMENT_1 0x00000000\r
	57	#define EFI_FVB2_ALIGNMENT_2 0x00010000\r
	58	#define EFI_FVB2_ALIGNMENT_4 0x00020000\r
	59	#define EFI_FVB2_ALIGNMENT_8 0x00030000\r
	60	#define EFI_FVB2_ALIGNMENT_16 0x00040000\r
	61	#define EFI_FVB2_ALIGNMENT_32 0x00050000\r
	62	#define EFI_FVB2_ALIGNMENT_64 0x00060000\r
	63	#define EFI_FVB2_ALIGNMENT_128 0x00070000\r
	64	#define EFI_FVB2_ALIGNMENT_256 0x00080000\r
	65	#define EFI_FVB2_ALIGNMENT_512 0x00090000\r
	66	#define EFI_FVB2_ALIGNMENT_1K 0x000A0000\r
	67	#define EFI_FVB2_ALIGNMENT_2K 0x000B0000\r
	68	#define EFI_FVB2_ALIGNMENT_4K 0x000C0000\r
	69	#define EFI_FVB2_ALIGNMENT_8K 0x000D0000\r
	70	#define EFI_FVB2_ALIGNMENT_16K 0x000E0000\r
	71	#define EFI_FVB2_ALIGNMENT_32K 0x000F0000\r
	72	#define EFI_FVB2_ALIGNMENT_64K 0x00100000\r
	73	#define EFI_FVB2_ALIGNMENT_128K 0x00110000\r
	74	#define EFI_FVB2_ALIGNMENT_256K 0x00120000\r
2bcc713e	75	#define EFI_FVB2_ALIGNMENT_512K 0x00130000\r
30fdf114 LG	76	#define EFI_FVB2_ALIGNMENT_1M 0x00140000\r
	77	#define EFI_FVB2_ALIGNMENT_2M 0x00150000\r
	78	#define EFI_FVB2_ALIGNMENT_4M 0x00160000\r
	79	#define EFI_FVB2_ALIGNMENT_8M 0x00170000\r
	80	#define EFI_FVB2_ALIGNMENT_16M 0x00180000\r
	81	#define EFI_FVB2_ALIGNMENT_32M 0x00190000\r
	82	#define EFI_FVB2_ALIGNMENT_64M 0x001A0000\r
	83	#define EFI_FVB2_ALIGNMENT_128M 0x001B0000\r
	84	#define EFI_FVB2_ALIGNMENT_256M 0x001C0000\r
	85	#define EFI_FVB2_ALIGNMENT_512M 0x001D0000\r
	86	#define EFI_FVB2_ALIGNMENT_1G 0x001E0000\r
	87	#define EFI_FVB2_ALIGNMENT_2G 0x001F0000\r
	88	\r
	89	\r
	90	typedef struct {\r
	91	UINT32 NumBlocks;\r
	92	UINT32 Length;\r
	93	} EFI_FV_BLOCK_MAP_ENTRY;\r
	94	\r
	95	//\r
	96	// Describes the features and layout of the firmware volume.\r
	97	//\r
	98	typedef struct {\r
	99	UINT8 ZeroVector[16];\r
	100	EFI_GUID FileSystemGuid;\r
	101	UINT64 FvLength;\r
	102	UINT32 Signature;\r
2bcc713e	103	EFI_FVB_ATTRIBUTES_2 Attributes;\r
30fdf114 LG	104	UINT16 HeaderLength;\r
	105	UINT16 Checksum;\r
	106	UINT16 ExtHeaderOffset;\r
	107	UINT8 Reserved[1];\r
	108	UINT8 Revision;\r
	109	EFI_FV_BLOCK_MAP_ENTRY BlockMap[1];\r
	110	} EFI_FIRMWARE_VOLUME_HEADER;\r
	111	\r
2bc3256c	112	#define EFI_FVH_SIGNATURE SIGNATURE_32 ('_', 'F', 'V', 'H')\r
30fdf114 LG	113	\r
	114	///\r
	115	/// Firmware Volume Header Revision definition\r
	116	///\r
	117	#define EFI_FVH_REVISION 0x02\r
	118	\r
	119	//\r
	120	// Extension header pointed by ExtHeaderOffset of volume header.\r
	121	// \r
	122	typedef struct {\r
	123	EFI_GUID FvName;\r
	124	UINT32 ExtHeaderSize;\r
	125	} EFI_FIRMWARE_VOLUME_EXT_HEADER;\r
	126	\r
	127	typedef struct {\r
	128	UINT16 ExtEntrySize;\r
	129	UINT16 ExtEntryType;\r
	130	} EFI_FIRMWARE_VOLUME_EXT_ENTRY;\r
	131	\r
	132	#define EFI_FV_EXT_TYPE_OEM_TYPE 0x01\r
	133	typedef struct {\r
	134	EFI_FIRMWARE_VOLUME_EXT_ENTRY Hdr;\r
	135	UINT32 TypeMask;\r
	136	\r
	137	//\r
	138	// Array of GUIDs. \r
	139	// Each GUID represents an OEM file type.\r
	140	// \r
2bcc713e LG	141	// EFI_GUID Types[1];\r
2bcc713e LG	142	//\r
30fdf114 LG	143	} EFI_FIRMWARE_VOLUME_EXT_ENTRY_OEM_TYPE;\r
30fdf114 LG	144	\r
2bcc713e LG	145	#define EFI_FV_EXT_TYPE_GUID_TYPE 0x0002\r
	146	typedef struct {\r
	147	EFI_FIRMWARE_VOLUME_EXT_ENTRY Hdr;\r
	148	EFI_GUID FormatType;\r
	149	\r
	150	//\r
	151	// An arry of bytes of length Length.\r
	152	//\r
	153	// UINT8 Data[1];\r
	154	//\r
	155	} EFI_FIRMWARE_VOLUME_EXT_ENTRY_GUID_TYPE;\r
30fdf114	156	\r
9425b349 YF	157	#define EFI_FV_EXT_TYPE_USED_SIZE_TYPE 0x03\r
	158	typedef struct {\r
	159	EFI_FIRMWARE_VOLUME_EXT_ENTRY Hdr;\r
	160	UINT32 UsedSize;\r
	161	} EFI_FIRMWARE_VOLUME_EXT_ENTRY_USED_SIZE_TYPE;\r
	162	\r
30fdf114	163	#endif\r