/** @file\r
- This file defines NvDataHob GUIDs for System Non Volatile HOB entries \r
- in the HOB list and NV system hob entry structure. \r
- It also defines NvDataFv GUID used as the signature of FTW working block header.\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
- \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
+ This file defines NvDataFv GUID and FTW working block structures.\r
+ The NvDataFv GUID can be used as FileSystemGuid in EFI_FIRMWARE_VOLUME_HEADER if\r
+ this FV image contains NV data, such as NV variable data.\r
+ This file also defines WorkingBlockSignature GUID for FTW working block signature.\r
+\r
+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>\r
+SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
\r
#define EFI_SYSTEM_NV_DATA_FV_GUID \\r
{0xfff12b8d, 0x7696, 0x4c8b, {0xa9, 0x85, 0x27, 0x47, 0x7, 0x5b, 0x4f, 0x50} }\r
\r
-#define EFI_SYSTEM_NV_DATA_HOB_GUID \\r
- {0xd6e5092d, 0xc7b2, 0x4872, {0xaf, 0x66, 0xfd, 0xc0, 0xe6, 0xf9, 0x5e, 0x78} }\r
+#define EDKII_WORKING_BLOCK_SIGNATURE_GUID \\r
+ {0x9e58292b, 0x7c68, 0x497d, {0xa0, 0xce, 0x65, 0x0, 0xfd, 0x9f, 0x1b, 0x95} }\r
+\r
+extern EFI_GUID gEfiSystemNvDataFvGuid;\r
+extern EFI_GUID gEdkiiWorkingBlockSignatureGuid;\r
+\r
+#define WORKING_BLOCK_VALID 0x1\r
+#define WORKING_BLOCK_INVALID 0x2\r
\r
///\r
-/// Hob entry for NV data region\r
+/// The EDKII Fault tolerant working block header.\r
+/// The header is immediately followed by the write queue data.\r
///\r
typedef struct {\r
- EFI_GUID SystemNvDataHobGuid; /// EFI_SYSTEM_NV_DATA_HOB_GUID\r
- EFI_GUID SystemNvDataFvGuid; /// Guid specifies the NvData Fv for the specific purpose, such as FTW, Error Log.\r
- EFI_LBA StartLba; /// The starting logical block index.\r
- UINTN StartLbaOffset; /// Offset into the starting block at which to the start of NvData region.\r
- EFI_LBA EndLba; /// The last logical block index.\r
- UINTN EndLbaOffset; /// Offset into the last block at which to the end of Nvdata region.\r
- UINT32 DataTypeSignature; /// NvData type in the specified NV range.\r
-} NV_SYSTEM_DATA_GUID_TYPE;\r
+ ///\r
+ /// FTW working block signature.\r
+ /// Its value has be updated from gEfiSystemNvDataFvGuid to gEdkiiWorkingBlockSignatureGuid,\r
+ /// because its write queue data format has been updated to support the crossing archs.\r
+ ///\r
+ EFI_GUID Signature;\r
+ ///\r
+ /// 32bit CRC calculated for this header.\r
+ ///\r
+ UINT32 Crc;\r
+ ///\r
+ /// Working block valid bit.\r
+ ///\r
+ UINT8 WorkingBlockValid : 1;\r
+ UINT8 WorkingBlockInvalid : 1;\r
+ UINT8 Reserved : 6;\r
+ UINT8 Reserved3[3];\r
+ ///\r
+ /// Total size of the following write queue range.\r
+ ///\r
+ UINT64 WriteQueueSize;\r
+ ///\r
+ /// Write Queue data.\r
+ ///\r
+ /// EFI_FAULT_TOLERANT_WRITE_HEADER FtwHeader;\r
+ /// EFI_FAULT_TOLERANT_WRITE_RECORD FtwRecord[FtwHeader.NumberOfWrites]\r
+ /// EFI_FAULT_TOLERANT_WRITE_HEADER FtwHeader2;\r
+ /// EFI_FAULT_TOLERANT_WRITE_RECORD FtwRecord2[FtwHeader2.NumberOfWrites]\r
+ /// ...\r
+ ///\r
+} EFI_FAULT_TOLERANT_WORKING_BLOCK_HEADER;\r
\r
-extern EFI_GUID gEfiSystemNvDataHobGuid;\r
+#define FTW_VALID_STATE 0\r
+#define FTW_INVALID_STATE 1\r
\r
-///\r
-/// NvDataFv GUID used as the signature of FTW working block header.\r
-///\r
-extern EFI_GUID gEfiSystemNvDataFvGuid;\r
+//\r
+// EFI Fault tolerant block update write queue entry.\r
+//\r
+typedef struct {\r
+ UINT8 HeaderAllocated : 1;\r
+ UINT8 WritesAllocated : 1;\r
+ UINT8 Complete : 1;\r
+ UINT8 Reserved : 5;\r
+ EFI_GUID CallerId;\r
+ UINT64 NumberOfWrites;\r
+ UINT64 PrivateDataSize;\r
+} EFI_FAULT_TOLERANT_WRITE_HEADER;\r
+\r
+//\r
+// EFI Fault tolerant block update write queue record.\r
+//\r
+typedef struct {\r
+ UINT8 BootBlockUpdate : 1;\r
+ UINT8 SpareComplete : 1;\r
+ UINT8 DestinationComplete : 1;\r
+ UINT8 Reserved : 5;\r
+ EFI_LBA Lba;\r
+ UINT64 Offset;\r
+ UINT64 Length;\r
+ //\r
+ // Relative offset to spare block.\r
+ //\r
+ INT64 RelativeOffset;\r
+ //\r
+ // UINT8 PrivateData[PrivateDataSize]\r
+ //\r
+} EFI_FAULT_TOLERANT_WRITE_RECORD;\r
+\r
+#define FTW_RECORD_SIZE(PrivateDataSize) (sizeof (EFI_FAULT_TOLERANT_WRITE_RECORD) + (UINTN) PrivateDataSize)\r
+\r
+#define FTW_RECORD_TOTAL_SIZE(NumberOfWrites, PrivateDataSize) \\r
+ ((UINTN) (NumberOfWrites) * (sizeof (EFI_FAULT_TOLERANT_WRITE_RECORD) + (UINTN) PrivateDataSize))\r
+\r
+#define FTW_WRITE_TOTAL_SIZE(NumberOfWrites, PrivateDataSize) \\r
+ ( \\r
+ sizeof (EFI_FAULT_TOLERANT_WRITE_HEADER) + (UINTN) (NumberOfWrites) * \\r
+ (sizeof (EFI_FAULT_TOLERANT_WRITE_RECORD) + (UINTN) PrivateDataSize) \\r
+ )\r
\r
#endif\r