[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
\r
EFI_STATUS\r
EnableFvbWrites (\r
  IN  BOOLEAN   EnableWrites\r
  )\r
;\r
\r
EFI_STATUS\r
PlatformGetFvbWriteBase (\r
  IN  UINTN     CurrentBaseAddress,\r
  IN  UINTN     *NewBaseAddress,\r
  IN  BOOLEAN   *WriteEnabled\r
  )\r
;\r
\r
EFI_STATUS\r
EnablePlatformFvb (\r
  VOID\r
  )\r
;\r
\r
BOOLEAN\r
SetPlatformFvbLock (\r
  IN UINTN  LbaAddress\r
  )\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
\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
\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
\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
\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
\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
\r
EFI_STATUS\r
EFIAPI\r
FvbInitialize (\r
  IN EFI_HANDLE         ImageHandle,\r
  IN EFI_SYSTEM_TABLE   *SystemTable\r
  )\r
;\r
\r
VOID\r
EFIAPI\r
FvbClassAddressChangeEvent (\r
  IN EFI_EVENT        Event,\r
  IN VOID             *Context\r
  )\r
;\r
\r
EFI_STATUS\r
FvbSpecificInitialize (\r
  IN  ESAL_FWB_GLOBAL   *mFvbModuleGlobal\r
  )\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
\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
//\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
\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
\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
\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
\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
\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
\r
EFI_STATUS\r
EFIAPI\r
FvbProtocolEraseBlocks (\r
  IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL    *This,\r
  ...  \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
\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
135	)\r
136	;\r
137	\r
138	EFI_STATUS\r
139	EnableFvbWrites (\r
140	IN BOOLEAN EnableWrites\r
141	)\r
142	;\r
143	\r
144	EFI_STATUS\r
145	PlatformGetFvbWriteBase (\r
146	IN UINTN CurrentBaseAddress,\r
147	IN UINTN *NewBaseAddress,\r
148	IN BOOLEAN *WriteEnabled\r
149	)\r
150	;\r
151	\r
152	EFI_STATUS\r
153	EnablePlatformFvb (\r
154	VOID\r
155	)\r
156	;\r
157	\r
158	BOOLEAN\r
159	SetPlatformFvbLock (\r
160	IN UINTN LbaAddress\r
161	)\r
162	;\r
163	\r
164	EFI_STATUS\r
165	FvbReadBlock (\r
166	IN UINTN Instance,\r
167	IN EFI_LBA Lba,\r
168	IN UINTN BlockOffset,\r
169	IN OUT UINTN *NumBytes,\r
170	IN UINT8 *Buffer,\r
171	IN ESAL_FWB_GLOBAL *Global,\r
172	IN BOOLEAN Virtual\r
173	)\r
174	;\r
175	\r
176	EFI_STATUS\r
177	FvbWriteBlock (\r
178	IN UINTN Instance,\r
179	IN EFI_LBA Lba,\r
180	IN UINTN BlockOffset,\r
181	IN OUT UINTN *NumBytes,\r
182	IN UINT8 *Buffer,\r
183	IN ESAL_FWB_GLOBAL *Global,\r
184	IN BOOLEAN Virtual\r
185	)\r
186	;\r
187	\r
188	EFI_STATUS\r
189	FvbEraseBlock (\r
190	IN UINTN Instance,\r
191	IN EFI_LBA Lba,\r
192	IN ESAL_FWB_GLOBAL *Global,\r
193	IN BOOLEAN Virtual\r
194	)\r
195	;\r
196	\r
197	EFI_STATUS\r
198	FvbSetVolumeAttributes (\r
199	IN UINTN Instance,\r
8ee3a199	200	IN OUT EFI_FVB_ATTRIBUTES_2 *Attributes,\r
9071550e	201	IN ESAL_FWB_GLOBAL *Global,\r
	202	IN BOOLEAN Virtual\r
	203	)\r
	204	;\r
	205	\r
	206	EFI_STATUS\r
	207	FvbGetVolumeAttributes (\r
	208	IN UINTN Instance,\r
8ee3a199	209	OUT EFI_FVB_ATTRIBUTES_2 *Attributes,\r
9071550e	210	IN ESAL_FWB_GLOBAL *Global,\r
	211	IN BOOLEAN Virtual\r
	212	)\r
	213	;\r
	214	\r
	215	EFI_STATUS\r
	216	FvbGetPhysicalAddress (\r
	217	IN UINTN Instance,\r
	218	OUT EFI_PHYSICAL_ADDRESS *Address,\r
	219	IN ESAL_FWB_GLOBAL *Global,\r
	220	IN BOOLEAN Virtual\r
	221	)\r
	222	;\r
	223	\r
	224	EFI_STATUS\r
	225	EFIAPI\r
	226	FvbInitialize (\r
	227	IN EFI_HANDLE ImageHandle,\r
	228	IN EFI_SYSTEM_TABLE *SystemTable\r
	229	)\r
	230	;\r
	231	\r
	232	VOID\r
	233	EFIAPI\r
	234	FvbClassAddressChangeEvent (\r
	235	IN EFI_EVENT Event,\r
	236	IN VOID *Context\r
	237	)\r
	238	;\r
	239	\r
	240	EFI_STATUS\r
	241	FvbSpecificInitialize (\r
	242	IN ESAL_FWB_GLOBAL *mFvbModuleGlobal\r
	243	)\r
	244	;\r
	245	\r
	246	EFI_STATUS\r
	247	FvbGetLbaAddress (\r
	248	IN UINTN Instance,\r
	249	IN EFI_LBA Lba,\r
	250	OUT UINTN *LbaAddress,\r
	251	OUT UINTN *LbaLength,\r
	252	OUT UINTN *NumOfBlocks,\r
	253	IN ESAL_FWB_GLOBAL *Global,\r
	254	IN BOOLEAN Virtual\r
	255	)\r
	256	;\r
	257	\r
	258	EFI_STATUS\r
	259	FvbEraseCustomBlockRange (\r
	260	IN UINTN Instance,\r
	261	IN EFI_LBA StartLba,\r
	262	IN UINTN OffsetStartLba,\r
	263	IN EFI_LBA LastLba,\r
	264	IN UINTN OffsetLastLba,\r
	265	IN ESAL_FWB_GLOBAL *Global,\r
	266	IN BOOLEAN Virtual\r
	267	)\r
	268	;\r
	269	\r
	270	//\r
	271	// Protocol APIs\r
	272	//\r
	273	EFI_STATUS\r
274	EFIAPI\r
275	FvbProtocolGetAttributes (\r
276	IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL *This,\r
8ee3a199	277	OUT EFI_FVB_ATTRIBUTES_2 *Attributes\r
9071550e	278	)\r
	279	;\r
	280	\r
	281	EFI_STATUS\r
	282	EFIAPI\r
	283	FvbProtocolSetAttributes (\r
	284	IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL *This,\r
8ee3a199	285	IN OUT EFI_FVB_ATTRIBUTES_2 *Attributes\r
9071550e	286	)\r
	287	;\r
	288	\r
	289	EFI_STATUS\r
	290	EFIAPI\r
	291	FvbProtocolGetPhysicalAddress (\r
	292	IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL *This,\r
	293	OUT EFI_PHYSICAL_ADDRESS *Address\r
	294	)\r
	295	;\r
	296	\r
	297	EFI_STATUS\r
	298	EFIAPI\r
	299	FvbProtocolGetBlockSize (\r
	300	IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL *This,\r
	301	IN EFI_LBA Lba,\r
	302	OUT UINTN *BlockSize,\r
	303	OUT UINTN *NumOfBlocks\r
	304	)\r
	305	;\r
	306	\r
	307	EFI_STATUS\r
	308	EFIAPI\r
	309	FvbProtocolRead (\r
	310	IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL *This,\r
	311	IN EFI_LBA Lba,\r
	312	IN UINTN Offset,\r
	313	IN OUT UINTN *NumBytes,\r
	314	IN UINT8 *Buffer\r
	315	)\r
	316	;\r
	317	\r
	318	EFI_STATUS\r
	319	EFIAPI\r
	320	FvbProtocolWrite (\r
	321	IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL *This,\r
	322	IN EFI_LBA Lba,\r
	323	IN UINTN Offset,\r
	324	IN OUT UINTN *NumBytes,\r
	325	IN UINT8 *Buffer\r
	326	)\r
	327	;\r
	328	\r
	329	EFI_STATUS\r
	330	EFIAPI\r
	331	FvbProtocolEraseBlocks (\r
	332	IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL *This,\r
	333	... \r
	334	)\r
	335	;\r
	336	\r
	337	EFI_STATUS\r
	338	EFIAPI\r
	339	FvbExtendProtocolEraseCustomBlockRange (\r
	340	IN EFI_FVB_EXTENSION_PROTOCOL *This,\r
	341	IN EFI_LBA StartLba,\r
	342	IN UINTN OffsetStartLba,\r
	343	IN EFI_LBA LastLba,\r
	344	IN UINTN OffsetLastLba\r
	345	)\r
	346	;\r
	347	\r
	348	#endif\r