Patrick Georgi | ea063cb | 2020-05-08 19:28:13 +0200 | [diff] [blame] | 1 | /* ifdtool - dump Intel Firmware Descriptor information */ |
Patrick Georgi | 7333a11 | 2020-05-08 20:48:04 +0200 | [diff] [blame] | 2 | /* SPDX-License-Identifier: GPL-2.0-only */ |
Stefan Reinauer | 1c795ad1 | 2011-10-14 12:49:41 -0700 | [diff] [blame] | 3 | |
| 4 | #include <stdint.h> |
Bill XIE | b3e15a2 | 2017-09-07 18:34:50 +0800 | [diff] [blame] | 5 | #include <stdbool.h> |
Duncan Laurie | 1f7fd72 | 2015-06-22 11:14:48 -0700 | [diff] [blame] | 6 | #define IFDTOOL_VERSION "1.2" |
| 7 | |
| 8 | enum ifd_version { |
| 9 | IFD_VERSION_1, |
Patrick Rudolph | 1659874 | 2022-10-21 15:13:43 +0200 | [diff] [blame] | 10 | IFD_VERSION_1_5, |
Duncan Laurie | 1f7fd72 | 2015-06-22 11:14:48 -0700 | [diff] [blame] | 11 | IFD_VERSION_2, |
| 12 | }; |
Stefan Reinauer | 1c795ad1 | 2011-10-14 12:49:41 -0700 | [diff] [blame] | 13 | |
Bill XIE | b3e15a2 | 2017-09-07 18:34:50 +0800 | [diff] [blame] | 14 | /* port from flashrom */ |
| 15 | enum ich_chipset { |
| 16 | CHIPSET_ICH_UNKNOWN, |
Bill XIE | b3e15a2 | 2017-09-07 18:34:50 +0800 | [diff] [blame] | 17 | CHIPSET_ICH8, |
| 18 | CHIPSET_ICH9, |
| 19 | CHIPSET_ICH10, |
Subrata Banik | 89db225 | 2020-08-26 14:49:17 +0530 | [diff] [blame] | 20 | CHIPSET_PCH_UNKNOWN, |
Bill XIE | b3e15a2 | 2017-09-07 18:34:50 +0800 | [diff] [blame] | 21 | CHIPSET_5_SERIES_IBEX_PEAK, |
| 22 | CHIPSET_6_SERIES_COUGAR_POINT, |
| 23 | CHIPSET_7_SERIES_PANTHER_POINT, |
| 24 | CHIPSET_8_SERIES_LYNX_POINT, |
| 25 | CHIPSET_BAYTRAIL, /* Actually all with Silvermont architecture: |
| 26 | * Bay Trail, Avoton/Rangeley |
| 27 | */ |
| 28 | CHIPSET_8_SERIES_LYNX_POINT_LP, |
| 29 | CHIPSET_8_SERIES_WELLSBURG, |
| 30 | CHIPSET_9_SERIES_WILDCAT_POINT, |
| 31 | CHIPSET_9_SERIES_WILDCAT_POINT_LP, |
Subrata Banik | 8c082e5 | 2021-06-10 23:02:29 +0530 | [diff] [blame] | 32 | CHIPSET_N_J_SERIES_APOLLO_LAKE, /* Apollo Lake: N3xxx, J3xxx */ |
| 33 | CHIPSET_N_J_SERIES_GEMINI_LAKE, /* Gemini Lake: N5xxx, J5xxx, N4xxx, J4xxx */ |
| 34 | CHIPSET_N_SERIES_JASPER_LAKE, /* Jasper Lake: N6xxx, N51xx, N45xx */ |
| 35 | CHIPSET_x6000_SERIES_ELKHART_LAKE, /* Elkhart Lake: x6000 */ |
Subrata Banik | 89db225 | 2020-08-26 14:49:17 +0530 | [diff] [blame] | 36 | CHIPSET_100_200_SERIES_SUNRISE_POINT, /* 6th-7th gen Core i/o (LP) variants */ |
Subrata Banik | 8c082e5 | 2021-06-10 23:02:29 +0530 | [diff] [blame] | 37 | CHIPSET_300_SERIES_CANNON_POINT, /* 8th-9th gen Core i/o (LP) variants */ |
| 38 | CHIPSET_400_SERIES_ICE_POINT, /* 10th gen Core i/o (LP) variants */ |
Subrata Banik | a5f4781 | 2020-09-29 11:43:01 +0530 | [diff] [blame] | 39 | CHIPSET_500_600_SERIES_TIGER_ALDER_POINT, /* 11th-12th gen Core i/o (LP) |
| 40 | * variants onwards */ |
Subrata Banik | 9cd85d0 | 2023-05-24 23:18:49 +0530 | [diff] [blame] | 41 | CHIPSET_800_SERIES_METEOR_LAKE, /* 14th gen Core i/o (LP) variants onwards */ |
Bill XIE | b3e15a2 | 2017-09-07 18:34:50 +0800 | [diff] [blame] | 42 | CHIPSET_C620_SERIES_LEWISBURG, |
Jeff Daly | abd4b96 | 2022-01-06 00:52:30 -0500 | [diff] [blame] | 43 | CHIPSET_DENVERTON, |
Bill XIE | b3e15a2 | 2017-09-07 18:34:50 +0800 | [diff] [blame] | 44 | }; |
| 45 | |
Andrey Petrov | 96ecb77 | 2016-10-31 19:31:54 -0700 | [diff] [blame] | 46 | enum platform { |
Furquan Shaikh | c0257dd | 2018-05-02 23:29:04 -0700 | [diff] [blame] | 47 | PLATFORM_APL, |
| 48 | PLATFORM_CNL, |
Johnny Lin | e273a02 | 2021-06-22 11:26:46 +0800 | [diff] [blame] | 49 | PLATFORM_LBG, |
Lean Sheng Tan | 0faba3c | 2021-06-09 07:52:24 -0700 | [diff] [blame] | 50 | PLATFORM_EHL, |
Furquan Shaikh | c0257dd | 2018-05-02 23:29:04 -0700 | [diff] [blame] | 51 | PLATFORM_GLK, |
Aamir Bohra | 1018be2 | 2018-06-29 15:08:50 +0530 | [diff] [blame] | 52 | PLATFORM_ICL, |
rkanabar | d64b046 | 2019-08-30 11:40:08 +0530 | [diff] [blame] | 53 | PLATFORM_JSL, |
Furquan Shaikh | 088b6e8 | 2018-03-21 10:42:37 -0700 | [diff] [blame] | 54 | PLATFORM_SKLKBL, |
Ravi Sarawadi | 7d9d63b | 2019-10-22 13:45:36 -0700 | [diff] [blame] | 55 | PLATFORM_TGL, |
Subrata Banik | 46f8073 | 2020-03-14 15:01:42 +0530 | [diff] [blame] | 56 | PLATFORM_ADL, |
Wonkyu Kim | 3922aa5 | 2022-02-02 15:19:05 -0800 | [diff] [blame] | 57 | PLATFORM_IFD2, |
Jeff Daly | abd4b96 | 2022-01-06 00:52:30 -0500 | [diff] [blame] | 58 | PLATFORM_DNV, |
Subrata Banik | ca82e61 | 2022-01-20 18:51:21 +0530 | [diff] [blame] | 59 | PLATFORM_MTL, |
Patrick Rudolph | 1659874 | 2022-10-21 15:13:43 +0200 | [diff] [blame] | 60 | PLATFORM_WBG |
Andrey Petrov | 96ecb77 | 2016-10-31 19:31:54 -0700 | [diff] [blame] | 61 | }; |
| 62 | |
Chris Douglass | 03ce014 | 2014-02-26 13:30:13 -0500 | [diff] [blame] | 63 | #define LAYOUT_LINELEN 80 |
| 64 | |
Stefan Reinauer | 1c795ad1 | 2011-10-14 12:49:41 -0700 | [diff] [blame] | 65 | enum spi_frequency { |
| 66 | SPI_FREQUENCY_20MHZ = 0, |
| 67 | SPI_FREQUENCY_33MHZ = 1, |
Duncan Laurie | 1f7fd72 | 2015-06-22 11:14:48 -0700 | [diff] [blame] | 68 | SPI_FREQUENCY_48MHZ = 2, |
| 69 | SPI_FREQUENCY_50MHZ_30MHZ = 4, |
| 70 | SPI_FREQUENCY_17MHZ = 6, |
Stefan Reinauer | 1c795ad1 | 2011-10-14 12:49:41 -0700 | [diff] [blame] | 71 | }; |
| 72 | |
Subrata Banik | d16ef4d | 2020-08-26 15:53:00 +0530 | [diff] [blame] | 73 | enum spi_frequency_500_series { |
| 74 | SPI_FREQUENCY_100MHZ = 0, |
| 75 | SPI_FREQUENCY_50MHZ = 1, |
| 76 | SPI_FREQUENCY_500SERIES_33MHZ = 3, |
| 77 | SPI_FREQUENCY_25MHZ = 4, |
| 78 | SPI_FREQUENCY_14MHZ = 6, |
| 79 | }; |
| 80 | |
Subrata Banik | e5d3992 | 2020-08-26 16:01:42 +0530 | [diff] [blame] | 81 | enum espi_frequency { |
| 82 | ESPI_FREQUENCY_20MHZ = 0, |
| 83 | ESPI_FREQUENCY_24MHZ = 1, |
| 84 | ESPI_FREQUENCY_30MHZ = 2, |
| 85 | ESPI_FREQUENCY_48MHZ = 3, |
| 86 | ESPI_FREQUENCY_60MHZ = 4, |
| 87 | ESPI_FREQUENCY_17MHZ = 6, |
| 88 | }; |
| 89 | |
| 90 | enum espi_frequency_500_series { |
| 91 | ESPI_FREQUENCY_500SERIES_20MHZ = 0, |
| 92 | ESPI_FREQUENCY_500SERIES_24MHZ = 1, |
| 93 | ESPI_FREQUENCY_500SERIES_25MHZ = 2, |
| 94 | ESPI_FREQUENCY_500SERIES_48MHZ = 3, |
| 95 | ESPI_FREQUENCY_500SERIES_60MHZ = 4, |
| 96 | }; |
| 97 | |
Subrata Banik | 9cd85d0 | 2023-05-24 23:18:49 +0530 | [diff] [blame] | 98 | enum espi_frequency_800_series { |
| 99 | ESPI_FREQUENCY_800SERIES_20MHZ = 0, |
| 100 | ESPI_FREQUENCY_800SERIES_25MHZ = 1, |
| 101 | ESPI_FREQUENCY_800SERIES_33MHZ = 2, |
| 102 | ESPI_FREQUENCY_800SERIES_50MHZ = 4, |
| 103 | }; |
| 104 | |
Stefan Reinauer | 1b1309f | 2012-05-11 15:53:43 -0700 | [diff] [blame] | 105 | enum component_density { |
| 106 | COMPONENT_DENSITY_512KB = 0, |
| 107 | COMPONENT_DENSITY_1MB = 1, |
| 108 | COMPONENT_DENSITY_2MB = 2, |
| 109 | COMPONENT_DENSITY_4MB = 3, |
| 110 | COMPONENT_DENSITY_8MB = 4, |
| 111 | COMPONENT_DENSITY_16MB = 5, |
Duncan Laurie | 1f7fd72 | 2015-06-22 11:14:48 -0700 | [diff] [blame] | 112 | COMPONENT_DENSITY_32MB = 6, |
| 113 | COMPONENT_DENSITY_64MB = 7, |
| 114 | COMPONENT_DENSITY_UNUSED = 0xf |
Stefan Reinauer | 1b1309f | 2012-05-11 15:53:43 -0700 | [diff] [blame] | 115 | }; |
| 116 | |
Stefan Reinauer | 1c795ad1 | 2011-10-14 12:49:41 -0700 | [diff] [blame] | 117 | // flash descriptor |
Maximilian Brune | ab0e680 | 2023-03-05 04:34:40 +0100 | [diff] [blame] | 118 | struct __packed fdbar { |
Stefan Reinauer | 1c795ad1 | 2011-10-14 12:49:41 -0700 | [diff] [blame] | 119 | uint32_t flvalsig; |
| 120 | uint32_t flmap0; |
| 121 | uint32_t flmap1; |
| 122 | uint32_t flmap2; |
Subrata Banik | bd2da5a | 2020-08-26 15:43:51 +0530 | [diff] [blame] | 123 | uint32_t flmap3; // Exist for 500 series onwards |
Maximilian Brune | ab0e680 | 2023-03-05 04:34:40 +0100 | [diff] [blame] | 124 | }; |
Stefan Reinauer | 1c795ad1 | 2011-10-14 12:49:41 -0700 | [diff] [blame] | 125 | |
| 126 | // regions |
Jeff Daly | 3623eca | 2022-01-05 23:51:40 -0500 | [diff] [blame] | 127 | #define MAX_REGIONS 16 |
Duncan Laurie | 1f7fd72 | 2015-06-22 11:14:48 -0700 | [diff] [blame] | 128 | #define MAX_REGIONS_OLD 5 |
Bill XIE | 4651d45 | 2017-09-12 11:54:48 +0800 | [diff] [blame] | 129 | |
Duncan Laurie | 7775d67 | 2019-06-06 13:39:26 -0700 | [diff] [blame] | 130 | enum flash_regions { |
| 131 | REGION_DESC, |
| 132 | REGION_BIOS, |
| 133 | REGION_ME, |
| 134 | REGION_GBE, |
| 135 | REGION_PDR, |
Jeff Daly | 3623eca | 2022-01-05 23:51:40 -0500 | [diff] [blame] | 136 | REGION_DEV_EXP1, |
| 137 | REGION_BIOS2, |
Duncan Laurie | 7775d67 | 2019-06-06 13:39:26 -0700 | [diff] [blame] | 138 | REGION_EC = 8, |
Jeff Daly | 3623eca | 2022-01-05 23:51:40 -0500 | [diff] [blame] | 139 | REGION_DEV_EXP2, |
| 140 | REGION_IE, |
| 141 | REGION_10GB_0, |
| 142 | REGION_10GB_1, |
| 143 | REGION_PTT = 15, |
Duncan Laurie | 7775d67 | 2019-06-06 13:39:26 -0700 | [diff] [blame] | 144 | }; |
| 145 | |
Maximilian Brune | ab0e680 | 2023-03-05 04:34:40 +0100 | [diff] [blame] | 146 | struct __packed frba { |
Bill XIE | 4651d45 | 2017-09-12 11:54:48 +0800 | [diff] [blame] | 147 | uint32_t flreg[MAX_REGIONS]; |
Maximilian Brune | ab0e680 | 2023-03-05 04:34:40 +0100 | [diff] [blame] | 148 | }; |
Stefan Reinauer | 1c795ad1 | 2011-10-14 12:49:41 -0700 | [diff] [blame] | 149 | |
| 150 | // component section |
Maximilian Brune | ab0e680 | 2023-03-05 04:34:40 +0100 | [diff] [blame] | 151 | struct __packed fcba { |
Stefan Reinauer | 1c795ad1 | 2011-10-14 12:49:41 -0700 | [diff] [blame] | 152 | uint32_t flcomp; |
| 153 | uint32_t flill; |
| 154 | uint32_t flpb; |
Maximilian Brune | ab0e680 | 2023-03-05 04:34:40 +0100 | [diff] [blame] | 155 | }; |
Stefan Reinauer | 1c795ad1 | 2011-10-14 12:49:41 -0700 | [diff] [blame] | 156 | |
| 157 | // pch strap |
Patrick Rudolph | 802cbee | 2020-05-25 12:18:11 +0200 | [diff] [blame] | 158 | #define MAX_PCHSTRP 1024 |
Bill XIE | 4651d45 | 2017-09-12 11:54:48 +0800 | [diff] [blame] | 159 | |
Maximilian Brune | ab0e680 | 2023-03-05 04:34:40 +0100 | [diff] [blame] | 160 | struct __packed fpsba { |
Bill XIE | 4651d45 | 2017-09-12 11:54:48 +0800 | [diff] [blame] | 161 | uint32_t pchstrp[MAX_PCHSTRP]; |
Maximilian Brune | ab0e680 | 2023-03-05 04:34:40 +0100 | [diff] [blame] | 162 | }; |
Stefan Reinauer | 1c795ad1 | 2011-10-14 12:49:41 -0700 | [diff] [blame] | 163 | |
Shawn Nematbakhsh | d2cb118 | 2015-09-10 19:07:13 -0700 | [diff] [blame] | 164 | /* |
| 165 | * WR / RD bits start at different locations within the flmstr regs, but |
| 166 | * otherwise have identical meaning. |
| 167 | */ |
| 168 | #define FLMSTR_WR_SHIFT_V1 24 |
| 169 | #define FLMSTR_WR_SHIFT_V2 20 |
| 170 | #define FLMSTR_RD_SHIFT_V1 16 |
| 171 | #define FLMSTR_RD_SHIFT_V2 8 |
| 172 | |
Stefan Reinauer | 1c795ad1 | 2011-10-14 12:49:41 -0700 | [diff] [blame] | 173 | // master |
Maximilian Brune | ab0e680 | 2023-03-05 04:34:40 +0100 | [diff] [blame] | 174 | struct __packed fmba { |
Stefan Reinauer | 1c795ad1 | 2011-10-14 12:49:41 -0700 | [diff] [blame] | 175 | uint32_t flmstr1; |
| 176 | uint32_t flmstr2; |
| 177 | uint32_t flmstr3; |
Duncan Laurie | 1f7fd72 | 2015-06-22 11:14:48 -0700 | [diff] [blame] | 178 | uint32_t flmstr4; |
| 179 | uint32_t flmstr5; |
Jeff Daly | abd4b96 | 2022-01-06 00:52:30 -0500 | [diff] [blame] | 180 | uint32_t flmstr6; |
Maximilian Brune | ab0e680 | 2023-03-05 04:34:40 +0100 | [diff] [blame] | 181 | }; |
Stefan Reinauer | 1c795ad1 | 2011-10-14 12:49:41 -0700 | [diff] [blame] | 182 | |
| 183 | // processor strap |
Maximilian Brune | ab0e680 | 2023-03-05 04:34:40 +0100 | [diff] [blame] | 184 | struct __packed fmsba { |
Stefan Reinauer | 1c795ad1 | 2011-10-14 12:49:41 -0700 | [diff] [blame] | 185 | uint32_t data[8]; |
Maximilian Brune | ab0e680 | 2023-03-05 04:34:40 +0100 | [diff] [blame] | 186 | }; |
Stefan Reinauer | 1c795ad1 | 2011-10-14 12:49:41 -0700 | [diff] [blame] | 187 | |
Stefan Reinauer | 4a17d29 | 2012-09-27 12:42:15 -0700 | [diff] [blame] | 188 | // ME VSCC |
Maximilian Brune | ab0e680 | 2023-03-05 04:34:40 +0100 | [diff] [blame] | 189 | struct vscc { |
Stefan Reinauer | 4a17d29 | 2012-09-27 12:42:15 -0700 | [diff] [blame] | 190 | uint32_t jid; |
| 191 | uint32_t vscc; |
Maximilian Brune | ab0e680 | 2023-03-05 04:34:40 +0100 | [diff] [blame] | 192 | }; |
Stefan Reinauer | 1c795ad1 | 2011-10-14 12:49:41 -0700 | [diff] [blame] | 193 | |
Maximilian Brune | ab0e680 | 2023-03-05 04:34:40 +0100 | [diff] [blame] | 194 | struct vtba { |
Stefan Reinauer | 4a17d29 | 2012-09-27 12:42:15 -0700 | [diff] [blame] | 195 | // Actual number of entries specified in vtl |
Stefan Tauner | 0d22614 | 2018-08-05 18:56:53 +0200 | [diff] [blame] | 196 | /* FIXME: Rationale for the limit of 8. |
| 197 | * AFAICT it's 127, cf. flashrom's ich_descriptors_tool). */ |
Maximilian Brune | ab0e680 | 2023-03-05 04:34:40 +0100 | [diff] [blame] | 198 | struct vscc entry[8]; |
| 199 | }; |
Stefan Reinauer | 4a17d29 | 2012-09-27 12:42:15 -0700 | [diff] [blame] | 200 | |
Maximilian Brune | ab0e680 | 2023-03-05 04:34:40 +0100 | [diff] [blame] | 201 | struct region { |
Maximilian Brune | 347596a | 2023-03-05 20:55:32 +0100 | [diff] [blame] | 202 | int base, limit, size, type; |
Maximilian Brune | ab0e680 | 2023-03-05 04:34:40 +0100 | [diff] [blame] | 203 | }; |
Chris Douglass | 03ce014 | 2014-02-26 13:30:13 -0500 | [diff] [blame] | 204 | |
| 205 | struct region_name { |
Bill XIE | fa5f994 | 2017-09-12 11:22:29 +0800 | [diff] [blame] | 206 | const char *pretty; |
| 207 | const char *terse; |
Bill XIE | 1bf6506 | 2017-09-12 11:31:37 +0800 | [diff] [blame] | 208 | const char *filename; |
Mathew King | c7ddc99 | 2019-08-08 14:59:25 -0600 | [diff] [blame] | 209 | const char *fmapname; |
Chris Douglass | 03ce014 | 2014-02-26 13:30:13 -0500 | [diff] [blame] | 210 | }; |