1/* SPDX-License-Identifier: Intel */ 2/* 3 * Copyright (C) 2013, Intel Corporation 4 * Copyright (C) 2014, Bin Meng <bmeng.cn@gmail.com> 5 */ 6 7#ifndef __FSP_FV___ 8#define __FSP_FV___ 9 10/* Value of EFI_FV_FILE_ATTRIBUTES */ 11#define EFI_FV_FILE_ATTR_ALIGNMENT 0x0000001F 12#define EFI_FV_FILE_ATTR_FIXED 0x00000100 13#define EFI_FV_FILE_ATTR_MEMORY_MAPPED 0x00000200 14 15/* Attributes bit definitions */ 16#define EFI_FVB2_READ_DISABLED_CAP 0x00000001 17#define EFI_FVB2_READ_ENABLED_CAP 0x00000002 18#define EFI_FVB2_READ_STATUS 0x00000004 19#define EFI_FVB2_WRITE_DISABLED_CAP 0x00000008 20#define EFI_FVB2_WRITE_ENABLED_CAP 0x00000010 21#define EFI_FVB2_WRITE_STATUS 0x00000020 22#define EFI_FVB2_LOCK_CAP 0x00000040 23#define EFI_FVB2_LOCK_STATUS 0x00000080 24#define EFI_FVB2_STICKY_WRITE 0x00000200 25#define EFI_FVB2_MEMORY_MAPPED 0x00000400 26#define EFI_FVB2_ERASE_POLARITY 0x00000800 27#define EFI_FVB2_READ_LOCK_CAP 0x00001000 28#define EFI_FVB2_READ_LOCK_STATUS 0x00002000 29#define EFI_FVB2_WRITE_LOCK_CAP 0x00004000 30#define EFI_FVB2_WRITE_LOCK_STATUS 0x00008000 31#define EFI_FVB2_ALIGNMENT 0x001F0000 32#define EFI_FVB2_ALIGNMENT_1 0x00000000 33#define EFI_FVB2_ALIGNMENT_2 0x00010000 34#define EFI_FVB2_ALIGNMENT_4 0x00020000 35#define EFI_FVB2_ALIGNMENT_8 0x00030000 36#define EFI_FVB2_ALIGNMENT_16 0x00040000 37#define EFI_FVB2_ALIGNMENT_32 0x00050000 38#define EFI_FVB2_ALIGNMENT_64 0x00060000 39#define EFI_FVB2_ALIGNMENT_128 0x00070000 40#define EFI_FVB2_ALIGNMENT_256 0x00080000 41#define EFI_FVB2_ALIGNMENT_512 0x00090000 42#define EFI_FVB2_ALIGNMENT_1K 0x000A0000 43#define EFI_FVB2_ALIGNMENT_2K 0x000B0000 44#define EFI_FVB2_ALIGNMENT_4K 0x000C0000 45#define EFI_FVB2_ALIGNMENT_8K 0x000D0000 46#define EFI_FVB2_ALIGNMENT_16K 0x000E0000 47#define EFI_FVB2_ALIGNMENT_32K 0x000F0000 48#define EFI_FVB2_ALIGNMENT_64K 0x00100000 49#define EFI_FVB2_ALIGNMENT_128K 0x00110000 50#define EFI_FVB2_ALIGNMENT_256K 0x00120000 51#define EFI_FVB2_ALIGNMENT_512K 0x00130000 52#define EFI_FVB2_ALIGNMENT_1M 0x00140000 53#define EFI_FVB2_ALIGNMENT_2M 0x00150000 54#define EFI_FVB2_ALIGNMENT_4M 0x00160000 55#define EFI_FVB2_ALIGNMENT_8M 0x00170000 56#define EFI_FVB2_ALIGNMENT_16M 0x00180000 57#define EFI_FVB2_ALIGNMENT_32M 0x00190000 58#define EFI_FVB2_ALIGNMENT_64M 0x001A0000 59#define EFI_FVB2_ALIGNMENT_128M 0x001B0000 60#define EFI_FVB2_ALIGNMENT_256M 0x001C0000 61#define EFI_FVB2_ALIGNMENT_512M 0x001D0000 62#define EFI_FVB2_ALIGNMENT_1G 0x001E0000 63#define EFI_FVB2_ALIGNMENT_2G 0x001F0000 64 65struct fv_blkmap_entry { 66 /* The number of sequential blocks which are of the same size */ 67 u32 num_blocks; 68 /* The size of the blocks */ 69 u32 length; 70}; 71 72/* Describes the features and layout of the firmware volume */ 73struct fv_header { 74 /* 75 * The first 16 bytes are reserved to allow for the reset vector of 76 * processors whose reset vector is at address 0. 77 */ 78 u8 zero_vec[16]; 79 /* 80 * Declares the file system with which the firmware volume 81 * is formatted. 82 */ 83 struct efi_guid fs_guid; 84 /* 85 * Length in bytes of the complete firmware volume, including 86 * the header. 87 */ 88 u64 fv_len; 89 /* Set to EFI_FVH_SIGNATURE */ 90 u32 sign; 91 /* 92 * Declares capabilities and power-on defaults for the firmware 93 * volume. 94 */ 95 u32 attr; 96 /* Length in bytes of the complete firmware volume header */ 97 u16 hdr_len; 98 /* 99 * A 16-bit checksum of the firmware volume header. 100 * A valid header sums to zero. 101 */ 102 u16 checksum; 103 /* 104 * Offset, relative to the start of the header, of the extended 105 * header (EFI_FIRMWARE_VOLUME_EXT_HEADER) or zero if there is 106 * no extended header. 107 */ 108 u16 ext_hdr_off; 109 /* This field must always be set to zero */ 110 u8 reserved[1]; 111 /* 112 * Set to 2. Future versions of this specification may define new 113 * header fields and will increment the Revision field accordingly. 114 */ 115 u8 rev; 116 /* 117 * An array of run-length encoded FvBlockMapEntry structures. 118 * The array is terminated with an entry of {0,0}. 119 */ 120 struct fv_blkmap_entry block_map[1]; 121}; 122 123#define EFI_FVH_SIGNATURE SIGNATURE_32('_', 'F', 'V', 'H') 124 125/* Firmware Volume Header Revision definition */ 126#define EFI_FVH_REVISION 0x02 127 128/* Extension header pointed by ExtHeaderOffset of volume header */ 129struct fv_ext_header { 130 /* firmware volume name */ 131 struct efi_guid fv_name; 132 /* Size of the rest of the extension header including this structure */ 133 u32 ext_hdr_size; 134}; 135 136#endif 137