[mirror_edk2.git] / DuetPkg / FvbRuntimeService / FwBlockService.h

/**@file\r
Copyright (c) 2007, 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
                                                                                          \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
Module Name:\r
\r
  FwBlockService.h\r
  \r
Abstract:\r
\r
  Firmware volume block driver for Intel Firmware Hub (FWH) device\r
\r
**/\r
#ifndef _FW_BLOCK_SERVICE_H\r
#define _FW_BLOCK_SERVICE_H\r
\r
//\r
// The package level header files this module uses\r
//\r
#include <PiDxe.h>\r
\r
//\r
// The protocols, PPI and GUID defintions for this module\r
//\r
#include <Guid/EventGroup.h>\r
#include <Guid/FirmwareFileSystem2.h>\r
#include <Protocol/FvbExtension.h>\r
#include <Protocol/FirmwareVolumeBlock.h>\r
#include <Guid/AlternateFvBlock.h>\r
#include <Protocol/DevicePath.h>\r
#include <Protocol/SimpleFileSystem.h>\r
#include <Protocol/BlockIo.h>\r
#include <Library/DevicePathLib.h>\r
#include <Guid/SystemNvDataGuid.h>\r
#include <Guid/FlashMapHob.h>\r
#include <Guid/HobList.h>\r
#include <Guid/AlternateFvBlock.h>\r
#include <Protocol/FvbExtension.h>\r
\r
//\r
// The Library classes this module consumes\r
//\r
#include <Library/UefiLib.h>\r
#include <Library/UefiDriverEntryPoint.h>\r
#include <Library/BaseLib.h>\r
#include <Library/DxeServicesTableLib.h>\r
#include <Library/UefiRuntimeLib.h>\r
#include <Library/DebugLib.h>\r
#include <Library/HobLib.h>\r
#include <Library/BaseMemoryLib.h>\r
#include <Library/MemoryAllocationLib.h>\r
#include <Library/UefiBootServicesTableLib.h>\r
#include <Library/PcdLib.h>\r
\r
\r
#define FWH_READ_LOCK                   (1 << 2)\r
#define FWH_LOCK_DOWN                   (1 << 1)\r
#define FWH_WRITE_LOCK                  1\r
#define FWH_WRITE_STATE_STATUS          (1 << 7)\r
#define FWH_ERASE_STATUS                (1 << 5)\r
#define FWH_PROGRAM_STATUS              (1 << 4)\r
#define FWH_VPP_STATUS                  (1 << 3)\r
#define STALL_TIME                      5\r
#define FWH_ERASE_STATUS_BITS           (FWH_ERASE_STATUS || FWH_VPP_STATUS)\r
#define FWH_WRITE_STATUS_BITS           (FWH_WRITE_STATUS || FWH_VPP_STATUS)\r
\r
//\r
// BugBug: Add documentation here for data structure!!!!\r
//\r
#define FVB_PHYSICAL  0\r
#define FVB_VIRTUAL   1\r
\r
#define EFI_FVB2_CAPABILITIES (EFI_FVB2_READ_DISABLED_CAP | \\r
                              EFI_FVB2_READ_ENABLED_CAP | \\r
                              EFI_FVB2_WRITE_DISABLED_CAP | \\r
                              EFI_FVB2_WRITE_ENABLED_CAP | \\r
                              EFI_FVB2_LOCK_CAP \\r
                              )\r
#define EFI_FVB2_STATUS (EFI_FVB2_READ_STATUS | EFI_FVB2_WRITE_STATUS | EFI_FVB2_LOCK_STATUS)\r
\r
typedef struct {\r
  EFI_LOCK                    FvbDevLock;\r
  UINTN                       FvBase[2];\r
  //\r
  // We can treat VolumeSignature combined with MappedFile \r
  //  as a unique key to locate the mapped file.\r
#define MAX_PATH 256\r
  UINT32                      VolumeId;\r
  CHAR16                      MappedFile[MAX_PATH];\r
  UINT32                      ActuralSize;\r
  UINT32                      Offset;\r
  \r
  EFI_DEVICE_PATH_PROTOCOL    *Device; // only used in BS period, won't use after memory map changed\r
  UINTN                       NumOfBlocks;\r
  BOOLEAN                     WriteEnabled;\r
  EFI_FIRMWARE_VOLUME_HEADER  VolumeHeader;\r
} EFI_FW_VOL_INSTANCE;\r
\r
typedef struct {\r
  UINT32              NumFv;\r
  EFI_FW_VOL_INSTANCE *FvInstance[2];\r
  UINT8               *FvbScratchSpace[2];\r
} ESAL_FWB_GLOBAL;\r
\r
//\r
// Fvb Protocol instance data\r
//\r
#define FVB_DEVICE_FROM_THIS(a)         CR (a, EFI_FW_VOL_BLOCK_DEVICE, FwVolBlockInstance, FVB_DEVICE_SIGNATURE)\r
#define FVB_EXTEND_DEVICE_FROM_THIS(a)  CR (a, EFI_FW_VOL_BLOCK_DEVICE, FvbExtension, FVB_DEVICE_SIGNATURE)\r
#define FVB_DEVICE_SIGNATURE            EFI_SIGNATURE_32 ('F', 'V', 'B', 'C')\r
\r
typedef struct {\r
  MEMMAP_DEVICE_PATH        MemMapDevPath;\r
  EFI_DEVICE_PATH_PROTOCOL  EndDevPath;\r
} FV_DEVICE_PATH;\r
\r
typedef struct {\r
  UINTN                               Signature;\r
  FV_DEVICE_PATH                      DevicePath;\r
  UINTN                               Instance;\r
  EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL  FwVolBlockInstance;\r
  EFI_FVB_EXTENSION_PROTOCOL          FvbExtension;\r
} EFI_FW_VOL_BLOCK_DEVICE;\r
\r
EFI_STATUS\r
GetFvbInfo (\r
  IN  EFI_PHYSICAL_ADDRESS              FvBaseAddress,\r
  OUT EFI_FIRMWARE_VOLUME_HEADER        **FvbInfo\r
  );\r
\r
EFI_STATUS\r
EnableFvbWrites (\r
  IN  BOOLEAN   EnableWrites\r
  );\r
\r
EFI_STATUS\r
PlatformGetFvbWriteBase (\r
  IN  UINTN     CurrentBaseAddress,\r
  IN  UINTN     *NewBaseAddress,\r
  IN  BOOLEAN   *WriteEnabled\r
  );\r
\r
EFI_STATUS\r
EnablePlatformFvb (\r
  VOID\r
  );\r
\r
BOOLEAN\r
SetPlatformFvbLock (\r
  IN UINTN  LbaAddress\r
  );\r
\r
EFI_STATUS\r
FvbReadBlock (\r
  IN UINTN                                Instance,\r
  IN EFI_LBA                              Lba,\r
  IN UINTN                                BlockOffset,\r
  IN OUT UINTN                            *NumBytes,\r
  IN UINT8                                *Buffer,\r
  IN ESAL_FWB_GLOBAL                      *Global,\r
  IN BOOLEAN                              Virtual\r
  );\r
\r
EFI_STATUS\r
FvbWriteBlock (\r
  IN UINTN                                Instance,\r
  IN EFI_LBA                              Lba,\r
  IN UINTN                                BlockOffset,\r
  IN OUT UINTN                            *NumBytes,\r
  IN UINT8                                *Buffer,\r
  IN ESAL_FWB_GLOBAL                      *Global,\r
  IN BOOLEAN                              Virtual\r
  );\r
\r
EFI_STATUS\r
FvbEraseBlock (\r
  IN UINTN                                Instance,\r
  IN EFI_LBA                              Lba,\r
  IN ESAL_FWB_GLOBAL                      *Global,\r
  IN BOOLEAN                              Virtual\r
  );\r
\r
EFI_STATUS\r
FvbSetVolumeAttributes (\r
  IN UINTN                                Instance,\r
  IN OUT EFI_FVB_ATTRIBUTES_2             *Attributes,\r
  IN ESAL_FWB_GLOBAL                      *Global,\r
  IN BOOLEAN                              Virtual\r
  );\r
\r
EFI_STATUS\r
FvbGetVolumeAttributes (\r
  IN UINTN                                Instance,\r
  OUT EFI_FVB_ATTRIBUTES_2                *Attributes,\r
  IN ESAL_FWB_GLOBAL                      *Global,\r
  IN BOOLEAN                              Virtual\r
  );\r
\r
EFI_STATUS\r
FvbGetPhysicalAddress (\r
  IN UINTN                                Instance,\r
  OUT EFI_PHYSICAL_ADDRESS                *Address,\r
  IN ESAL_FWB_GLOBAL                      *Global,\r
  IN BOOLEAN                              Virtual\r
  );\r
\r
EFI_STATUS\r
EFIAPI\r
FvbInitialize (\r
  IN EFI_HANDLE         ImageHandle,\r
  IN EFI_SYSTEM_TABLE   *SystemTable\r
  );\r
\r
VOID\r
EFIAPI\r
FvbClassAddressChangeEvent (\r
  IN EFI_EVENT        Event,\r
  IN VOID             *Context\r
  );\r
\r
EFI_STATUS\r
FvbSpecificInitialize (\r
  IN  ESAL_FWB_GLOBAL   *mFvbModuleGlobal\r
  );\r
\r
EFI_STATUS\r
FvbGetLbaAddress (\r
  IN  UINTN                               Instance,\r
  IN  EFI_LBA                             Lba,\r
  OUT UINTN                               *LbaAddress,\r
  OUT UINTN                               *LbaLength,\r
  OUT UINTN                               *NumOfBlocks,\r
  IN  ESAL_FWB_GLOBAL                     *Global,\r
  IN  BOOLEAN                             Virtual\r
  );\r
\r
EFI_STATUS\r
FvbEraseCustomBlockRange (\r
  IN UINTN                                Instance,\r
  IN EFI_LBA                              StartLba,\r
  IN UINTN                                OffsetStartLba,\r
  IN EFI_LBA                              LastLba,\r
  IN UINTN                                OffsetLastLba,\r
  IN ESAL_FWB_GLOBAL                      *Global,\r
  IN BOOLEAN                              Virtual\r
  );\r
\r
//\r
// Protocol APIs\r
//\r
EFI_STATUS\r
EFIAPI\r
FvbProtocolGetAttributes (\r
  IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL          *This,\r
  OUT      EFI_FVB_ATTRIBUTES_2                        *Attributes\r
  );\r
\r
EFI_STATUS\r
EFIAPI\r
FvbProtocolSetAttributes (\r
  IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL       *This,\r
  IN OUT   EFI_FVB_ATTRIBUTES_2                     *Attributes\r
  );\r
\r
EFI_STATUS\r
EFIAPI\r
FvbProtocolGetPhysicalAddress (\r
  IN  CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL          *This,\r
  OUT       EFI_PHYSICAL_ADDRESS                        *Address\r
  );\r
\r
EFI_STATUS\r
EFIAPI\r
FvbProtocolGetBlockSize (\r
  IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL           *This,\r
  IN  EFI_LBA                                     Lba,\r
  OUT UINTN                                       *BlockSize,\r
  OUT UINTN                                       *NumOfBlocks\r
  );\r
\r
EFI_STATUS\r
EFIAPI\r
FvbProtocolRead (\r
  IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL     *This,\r
  IN EFI_LBA                                      Lba,\r
  IN UINTN                                        Offset,\r
  IN OUT UINTN                                    *NumBytes,\r
  IN UINT8                                        *Buffer\r
  );\r
\r
EFI_STATUS\r
EFIAPI\r
FvbProtocolWrite (\r
  IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL     *This,\r
  IN EFI_LBA                                      Lba,\r
  IN UINTN                                        Offset,\r
  IN OUT UINTN                                    *NumBytes,\r
  IN UINT8                                        *Buffer\r
  );\r
\r
EFI_STATUS\r
EFIAPI\r
FvbProtocolEraseBlocks (\r
  IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL    *This,\r
  ...  \r
  );\r
\r
EFI_STATUS\r
EFIAPI\r
FvbExtendProtocolEraseCustomBlockRange (\r
  IN EFI_FVB_EXTENSION_PROTOCOL           *This,\r
  IN EFI_LBA                              StartLba,\r
  IN UINTN                                OffsetStartLba,\r
  IN EFI_LBA                              LastLba,\r
  IN UINTN                                OffsetLastLba\r
  );\r
\r
#endif\r
Commit	Line	Data
9071550e	1	/**@file\r
	2	Copyright (c) 2007, Intel Corporation \r
	3	All rights reserved. This program and the accompanying materials \r
	4	are licensed and made available under the terms and conditions of the BSD License \r
	5	which accompanies this distribution. The full text of the license may be found at \r
	6	http://opensource.org/licenses/bsd-license.php \r
	7	\r
	8	THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
	9	WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
	10	\r
	11	Module Name:\r
	12	\r
	13	FwBlockService.h\r
	14	\r
	15	Abstract:\r
	16	\r
	17	Firmware volume block driver for Intel Firmware Hub (FWH) device\r
	18	\r
	19	**/\r
	20	#ifndef _FW_BLOCK_SERVICE_H\r
	21	#define _FW_BLOCK_SERVICE_H\r
	22	\r
	23	//\r
	24	// The package level header files this module uses\r
	25	//\r
	26	#include <PiDxe.h>\r
	27	\r
	28	//\r
	29	// The protocols, PPI and GUID defintions for this module\r
	30	//\r
	31	#include <Guid/EventGroup.h>\r
	32	#include <Guid/FirmwareFileSystem2.h>\r
	33	#include <Protocol/FvbExtension.h>\r
	34	#include <Protocol/FirmwareVolumeBlock.h>\r
	35	#include <Guid/AlternateFvBlock.h>\r
	36	#include <Protocol/DevicePath.h>\r
	37	#include <Protocol/SimpleFileSystem.h>\r
	38	#include <Protocol/BlockIo.h>\r
	39	#include <Library/DevicePathLib.h>\r
	40	#include <Guid/SystemNvDataGuid.h>\r
	41	#include <Guid/FlashMapHob.h>\r
	42	#include <Guid/HobList.h>\r
	43	#include <Guid/AlternateFvBlock.h>\r
	44	#include <Protocol/FvbExtension.h>\r
	45	\r
	46	//\r
	47	// The Library classes this module consumes\r
	48	//\r
	49	#include <Library/UefiLib.h>\r
	50	#include <Library/UefiDriverEntryPoint.h>\r
	51	#include <Library/BaseLib.h>\r
	52	#include <Library/DxeServicesTableLib.h>\r
	53	#include <Library/UefiRuntimeLib.h>\r
	54	#include <Library/DebugLib.h>\r
	55	#include <Library/HobLib.h>\r
	56	#include <Library/BaseMemoryLib.h>\r
	57	#include <Library/MemoryAllocationLib.h>\r
	58	#include <Library/UefiBootServicesTableLib.h>\r
	59	#include <Library/PcdLib.h>\r
	60	\r
	61	\r
	62	#define FWH_READ_LOCK (1 << 2)\r
	63	#define FWH_LOCK_DOWN (1 << 1)\r
	64	#define FWH_WRITE_LOCK 1\r
65	#define FWH_WRITE_STATE_STATUS (1 << 7)\r
66	#define FWH_ERASE_STATUS (1 << 5)\r
67	#define FWH_PROGRAM_STATUS (1 << 4)\r
68	#define FWH_VPP_STATUS (1 << 3)\r
69	#define STALL_TIME 5\r
70	#define FWH_ERASE_STATUS_BITS (FWH_ERASE_STATUS \|\| FWH_VPP_STATUS)\r
71	#define FWH_WRITE_STATUS_BITS (FWH_WRITE_STATUS \|\| FWH_VPP_STATUS)\r
72	\r
73	//\r
74	// BugBug: Add documentation here for data structure!!!!\r
75	//\r
76	#define FVB_PHYSICAL 0\r
77	#define FVB_VIRTUAL 1\r
78	\r
79	#define EFI_FVB2_CAPABILITIES (EFI_FVB2_READ_DISABLED_CAP \| \\r
80	EFI_FVB2_READ_ENABLED_CAP \| \\r
81	EFI_FVB2_WRITE_DISABLED_CAP \| \\r
82	EFI_FVB2_WRITE_ENABLED_CAP \| \\r
83	EFI_FVB2_LOCK_CAP \\r
84	)\r
85	#define EFI_FVB2_STATUS (EFI_FVB2_READ_STATUS \| EFI_FVB2_WRITE_STATUS \| EFI_FVB2_LOCK_STATUS)\r
86	\r
87	typedef struct {\r
88	EFI_LOCK FvbDevLock;\r
89	UINTN FvBase[2];\r
90	//\r
91	// We can treat VolumeSignature combined with MappedFile \r
92	// as a unique key to locate the mapped file.\r
93	#define MAX_PATH 256\r
94	UINT32 VolumeId;\r
95	CHAR16 MappedFile[MAX_PATH];\r
96	UINT32 ActuralSize;\r
97	UINT32 Offset;\r
98	\r
99	EFI_DEVICE_PATH_PROTOCOL *Device; // only used in BS period, won't use after memory map changed\r
100	UINTN NumOfBlocks;\r
101	BOOLEAN WriteEnabled;\r
102	EFI_FIRMWARE_VOLUME_HEADER VolumeHeader;\r
103	} EFI_FW_VOL_INSTANCE;\r
104	\r
105	typedef struct {\r
106	UINT32 NumFv;\r
107	EFI_FW_VOL_INSTANCE *FvInstance[2];\r
108	UINT8 *FvbScratchSpace[2];\r
109	} ESAL_FWB_GLOBAL;\r
110	\r
111	//\r
112	// Fvb Protocol instance data\r
113	//\r
114	#define FVB_DEVICE_FROM_THIS(a) CR (a, EFI_FW_VOL_BLOCK_DEVICE, FwVolBlockInstance, FVB_DEVICE_SIGNATURE)\r
115	#define FVB_EXTEND_DEVICE_FROM_THIS(a) CR (a, EFI_FW_VOL_BLOCK_DEVICE, FvbExtension, FVB_DEVICE_SIGNATURE)\r
116	#define FVB_DEVICE_SIGNATURE EFI_SIGNATURE_32 ('F', 'V', 'B', 'C')\r
117	\r
118	typedef struct {\r
119	MEMMAP_DEVICE_PATH MemMapDevPath;\r
120	EFI_DEVICE_PATH_PROTOCOL EndDevPath;\r
121	} FV_DEVICE_PATH;\r
122	\r
123	typedef struct {\r
124	UINTN Signature;\r
125	FV_DEVICE_PATH DevicePath;\r
126	UINTN Instance;\r
127	EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL FwVolBlockInstance;\r
128	EFI_FVB_EXTENSION_PROTOCOL FvbExtension;\r
129	} EFI_FW_VOL_BLOCK_DEVICE;\r
130	\r
131	EFI_STATUS\r
132	GetFvbInfo (\r
133	IN EFI_PHYSICAL_ADDRESS FvBaseAddress,\r
134	OUT EFI_FIRMWARE_VOLUME_HEADER **FvbInfo\r
ed66e1bc	135	);\r
9071550e	136	\r
	137	EFI_STATUS\r
	138	EnableFvbWrites (\r
	139	IN BOOLEAN EnableWrites\r
ed66e1bc	140	);\r
9071550e	141	\r
	142	EFI_STATUS\r
	143	PlatformGetFvbWriteBase (\r
	144	IN UINTN CurrentBaseAddress,\r
	145	IN UINTN *NewBaseAddress,\r
	146	IN BOOLEAN *WriteEnabled\r
ed66e1bc	147	);\r
9071550e	148	\r
	149	EFI_STATUS\r
	150	EnablePlatformFvb (\r
	151	VOID\r
ed66e1bc	152	);\r
9071550e	153	\r
	154	BOOLEAN\r
	155	SetPlatformFvbLock (\r
	156	IN UINTN LbaAddress\r
ed66e1bc	157	);\r
9071550e	158	\r
	159	EFI_STATUS\r
	160	FvbReadBlock (\r
	161	IN UINTN Instance,\r
	162	IN EFI_LBA Lba,\r
	163	IN UINTN BlockOffset,\r
	164	IN OUT UINTN *NumBytes,\r
	165	IN UINT8 *Buffer,\r
	166	IN ESAL_FWB_GLOBAL *Global,\r
	167	IN BOOLEAN Virtual\r
ed66e1bc	168	);\r
9071550e	169	\r
	170	EFI_STATUS\r
	171	FvbWriteBlock (\r
	172	IN UINTN Instance,\r
	173	IN EFI_LBA Lba,\r
	174	IN UINTN BlockOffset,\r
	175	IN OUT UINTN *NumBytes,\r
	176	IN UINT8 *Buffer,\r
	177	IN ESAL_FWB_GLOBAL *Global,\r
	178	IN BOOLEAN Virtual\r
ed66e1bc	179	);\r
9071550e	180	\r
	181	EFI_STATUS\r
	182	FvbEraseBlock (\r
	183	IN UINTN Instance,\r
	184	IN EFI_LBA Lba,\r
	185	IN ESAL_FWB_GLOBAL *Global,\r
	186	IN BOOLEAN Virtual\r
ed66e1bc	187	);\r
9071550e	188	\r
	189	EFI_STATUS\r
	190	FvbSetVolumeAttributes (\r
	191	IN UINTN Instance,\r
8ee3a199	192	IN OUT EFI_FVB_ATTRIBUTES_2 *Attributes,\r
9071550e	193	IN ESAL_FWB_GLOBAL *Global,\r
9071550e	194	IN BOOLEAN Virtual\r
ed66e1bc	195	);\r
9071550e	196	\r
	197	EFI_STATUS\r
	198	FvbGetVolumeAttributes (\r
	199	IN UINTN Instance,\r
8ee3a199	200	OUT EFI_FVB_ATTRIBUTES_2 *Attributes,\r
9071550e	201	IN ESAL_FWB_GLOBAL *Global,\r
9071550e	202	IN BOOLEAN Virtual\r
ed66e1bc	203	);\r
9071550e	204	\r
	205	EFI_STATUS\r
	206	FvbGetPhysicalAddress (\r
	207	IN UINTN Instance,\r
	208	OUT EFI_PHYSICAL_ADDRESS *Address,\r
	209	IN ESAL_FWB_GLOBAL *Global,\r
	210	IN BOOLEAN Virtual\r
ed66e1bc	211	);\r
9071550e	212	\r
	213	EFI_STATUS\r
	214	EFIAPI\r
	215	FvbInitialize (\r
	216	IN EFI_HANDLE ImageHandle,\r
	217	IN EFI_SYSTEM_TABLE *SystemTable\r
ed66e1bc	218	);\r
9071550e	219	\r
	220	VOID\r
	221	EFIAPI\r
	222	FvbClassAddressChangeEvent (\r
	223	IN EFI_EVENT Event,\r
	224	IN VOID *Context\r
ed66e1bc	225	);\r
9071550e	226	\r
	227	EFI_STATUS\r
	228	FvbSpecificInitialize (\r
	229	IN ESAL_FWB_GLOBAL *mFvbModuleGlobal\r
ed66e1bc	230	);\r
9071550e	231	\r
	232	EFI_STATUS\r
	233	FvbGetLbaAddress (\r
	234	IN UINTN Instance,\r
	235	IN EFI_LBA Lba,\r
	236	OUT UINTN *LbaAddress,\r
	237	OUT UINTN *LbaLength,\r
	238	OUT UINTN *NumOfBlocks,\r
	239	IN ESAL_FWB_GLOBAL *Global,\r
	240	IN BOOLEAN Virtual\r
ed66e1bc	241	);\r
9071550e	242	\r
	243	EFI_STATUS\r
	244	FvbEraseCustomBlockRange (\r
	245	IN UINTN Instance,\r
	246	IN EFI_LBA StartLba,\r
	247	IN UINTN OffsetStartLba,\r
	248	IN EFI_LBA LastLba,\r
	249	IN UINTN OffsetLastLba,\r
	250	IN ESAL_FWB_GLOBAL *Global,\r
	251	IN BOOLEAN Virtual\r
ed66e1bc	252	);\r
9071550e	253	\r
	254	//\r
	255	// Protocol APIs\r
	256	//\r
	257	EFI_STATUS\r
	258	EFIAPI\r
	259	FvbProtocolGetAttributes (\r
	260	IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL *This,\r
8ee3a199	261	OUT EFI_FVB_ATTRIBUTES_2 *Attributes\r
ed66e1bc	262	);\r
9071550e	263	\r
	264	EFI_STATUS\r
	265	EFIAPI\r
	266	FvbProtocolSetAttributes (\r
	267	IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL *This,\r
8ee3a199	268	IN OUT EFI_FVB_ATTRIBUTES_2 *Attributes\r
ed66e1bc	269	);\r
9071550e	270	\r
	271	EFI_STATUS\r
	272	EFIAPI\r
	273	FvbProtocolGetPhysicalAddress (\r
	274	IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL *This,\r
	275	OUT EFI_PHYSICAL_ADDRESS *Address\r
ed66e1bc	276	);\r
9071550e	277	\r
	278	EFI_STATUS\r
	279	EFIAPI\r
	280	FvbProtocolGetBlockSize (\r
	281	IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL *This,\r
	282	IN EFI_LBA Lba,\r
	283	OUT UINTN *BlockSize,\r
	284	OUT UINTN *NumOfBlocks\r
ed66e1bc	285	);\r
9071550e	286	\r
	287	EFI_STATUS\r
	288	EFIAPI\r
	289	FvbProtocolRead (\r
	290	IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL *This,\r
	291	IN EFI_LBA Lba,\r
	292	IN UINTN Offset,\r
	293	IN OUT UINTN *NumBytes,\r
	294	IN UINT8 *Buffer\r
ed66e1bc	295	);\r
9071550e	296	\r
	297	EFI_STATUS\r
	298	EFIAPI\r
	299	FvbProtocolWrite (\r
	300	IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL *This,\r
	301	IN EFI_LBA Lba,\r
	302	IN UINTN Offset,\r
	303	IN OUT UINTN *NumBytes,\r
	304	IN UINT8 *Buffer\r
ed66e1bc	305	);\r
9071550e	306	\r
	307	EFI_STATUS\r
	308	EFIAPI\r
	309	FvbProtocolEraseBlocks (\r
	310	IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL *This,\r
	311	... \r
ed66e1bc	312	);\r
9071550e	313	\r
	314	EFI_STATUS\r
	315	EFIAPI\r
	316	FvbExtendProtocolEraseCustomBlockRange (\r
	317	IN EFI_FVB_EXTENSION_PROTOCOL *This,\r
	318	IN EFI_LBA StartLba,\r
	319	IN UINTN OffsetStartLba,\r
	320	IN EFI_LBA LastLba,\r
	321	IN UINTN OffsetLastLba\r
ed66e1bc	322	);\r
9071550e	323	\r
9071550e	324	#endif\r