Elyes HAOUAS | 8741510 | 2020-05-07 11:49:08 +0200 | [diff] [blame^] | 1 | # This file is part of the coreboot project. |
| 2 | # SPDX-License-Identifier: GPL-2.0-only |
Martin Roth | 59aa2b1 | 2015-06-20 16:17:12 -0600 | [diff] [blame] | 3 | |
| 4 | config HAVE_INTEL_FIRMWARE |
| 5 | bool |
Stefan Tauner | ef8b957 | 2018-09-06 00:34:28 +0200 | [diff] [blame] | 6 | default y if INTEL_DESCRIPTOR_MODE_CAPABLE |
Martin Roth | 59aa2b1 | 2015-06-20 16:17:12 -0600 | [diff] [blame] | 7 | help |
Stefan Tauner | ef8b957 | 2018-09-06 00:34:28 +0200 | [diff] [blame] | 8 | Platform uses the Intel Firmware Descriptor to describe the |
| 9 | layout of the SPI ROM chip. Enabling this option will allow you to |
| 10 | select further features that rely on this like providing individual |
| 11 | firmware blobs. |
Martin Roth | 59aa2b1 | 2015-06-20 16:17:12 -0600 | [diff] [blame] | 12 | |
| 13 | if HAVE_INTEL_FIRMWARE |
| 14 | |
| 15 | comment "Intel Firmware" |
| 16 | |
| 17 | config HAVE_IFD_BIN |
| 18 | bool "Add Intel descriptor.bin file" |
Simon Glass | 46255f7 | 2018-07-12 15:26:07 -0600 | [diff] [blame] | 19 | select HAVE_EM100_SUPPORT # We use ifdtool to enable this. |
Martin Roth | 59aa2b1 | 2015-06-20 16:17:12 -0600 | [diff] [blame] | 20 | help |
| 21 | The descriptor binary |
| 22 | |
| 23 | config IFD_BIN_PATH |
| 24 | string "Path and filename of the descriptor.bin file" |
Stefan Reinauer | cecabc1 | 2015-07-01 17:37:57 -0700 | [diff] [blame] | 25 | default "3rdparty/blobs/mainboard/$(MAINBOARDDIR)/descriptor.bin" |
Angel Pons | 240eaaa | 2018-08-20 16:32:22 +0200 | [diff] [blame] | 26 | depends on HAVE_IFD_BIN |
Martin Roth | 59aa2b1 | 2015-06-20 16:17:12 -0600 | [diff] [blame] | 27 | |
| 28 | config HAVE_ME_BIN |
Martin Roth | c407cb9 | 2015-06-23 19:59:30 -0600 | [diff] [blame] | 29 | bool "Add Intel ME/TXE firmware" |
Martin Roth | c528c2e | 2015-06-27 08:59:10 -0600 | [diff] [blame] | 30 | depends on HAVE_IFD_BIN |
Martin Roth | 59aa2b1 | 2015-06-20 16:17:12 -0600 | [diff] [blame] | 31 | help |
| 32 | The Intel processor in the selected system requires a special firmware |
Martin Roth | c407cb9 | 2015-06-23 19:59:30 -0600 | [diff] [blame] | 33 | for an integrated controller. This might be called the Management |
| 34 | Engine (ME), the Trusted Execution Engine (TXE) or something else |
| 35 | depending on the chip. This firmware might or might not be available |
| 36 | in coreboot's 3rdparty/blobs repository. If it is not and if you don't |
| 37 | have access to the firmware from elsewhere, you can still build |
| 38 | coreboot without it. In this case however, you'll have to make sure |
| 39 | that you don't overwrite your ME/TXE firmware on your flash ROM. |
Martin Roth | 59aa2b1 | 2015-06-20 16:17:12 -0600 | [diff] [blame] | 40 | |
| 41 | config ME_BIN_PATH |
| 42 | string "Path to management engine firmware" |
Stefan Reinauer | cecabc1 | 2015-07-01 17:37:57 -0700 | [diff] [blame] | 43 | default "3rdparty/blobs/mainboard/$(MAINBOARDDIR)/me.bin" |
Martin Roth | 59aa2b1 | 2015-06-20 16:17:12 -0600 | [diff] [blame] | 44 | depends on HAVE_ME_BIN |
| 45 | |
Nicola Corna | 16719ad | 2017-03-10 11:27:39 +0100 | [diff] [blame] | 46 | config CHECK_ME |
| 47 | bool "Verify the integrity of the supplied ME/TXE firmware" |
Naresh G Solanki | 95d6dd2 | 2017-04-12 20:15:53 +0530 | [diff] [blame] | 48 | default n |
Angel Pons | 95de231 | 2020-02-17 13:08:53 +0100 | [diff] [blame] | 49 | depends on HAVE_ME_BIN && (NORTHBRIDGE_INTEL_IRONLAKE || \ |
Nicola Corna | 16719ad | 2017-03-10 11:27:39 +0100 | [diff] [blame] | 50 | NORTHBRIDGE_INTEL_SANDYBRIDGE || \ |
Nico Huber | 772a154 | 2019-05-10 16:48:14 +0200 | [diff] [blame] | 51 | NORTHBRIDGE_INTEL_HASWELL || \ |
Nicola Corna | 16719ad | 2017-03-10 11:27:39 +0100 | [diff] [blame] | 52 | SOC_INTEL_BROADWELL || SOC_INTEL_SKYLAKE || \ |
Nicola Corna | d58dd5c | 2018-03-31 16:40:03 +0200 | [diff] [blame] | 53 | SOC_INTEL_KABYLAKE || SOC_INTEL_BAYTRAIL || SOC_INTEL_BRASWELL) |
Nicola Corna | 16719ad | 2017-03-10 11:27:39 +0100 | [diff] [blame] | 54 | help |
| 55 | Verify the integrity of the supplied Intel ME/TXE firmware before |
| 56 | proceeding with the build, in order to prevent an accidental loading |
| 57 | of a corrupted ME/TXE image. |
| 58 | |
Nicola Corna | 92e95ca | 2017-01-23 15:29:03 +0100 | [diff] [blame] | 59 | config USE_ME_CLEANER |
| 60 | bool "Strip down the Intel ME/TXE firmware" |
Angel Pons | 95de231 | 2020-02-17 13:08:53 +0100 | [diff] [blame] | 61 | depends on HAVE_ME_BIN && (NORTHBRIDGE_INTEL_IRONLAKE || \ |
Nicola Corna | 04d2601 | 2018-06-21 14:57:26 +0200 | [diff] [blame] | 62 | NORTHBRIDGE_INTEL_SANDYBRIDGE || \ |
Nico Huber | 772a154 | 2019-05-10 16:48:14 +0200 | [diff] [blame] | 63 | NORTHBRIDGE_INTEL_HASWELL || \ |
Nicola Corna | 92e95ca | 2017-01-23 15:29:03 +0100 | [diff] [blame] | 64 | SOC_INTEL_BROADWELL || SOC_INTEL_SKYLAKE || \ |
Nicola Corna | d58dd5c | 2018-03-31 16:40:03 +0200 | [diff] [blame] | 65 | SOC_INTEL_KABYLAKE || SOC_INTEL_BAYTRAIL || SOC_INTEL_BRASWELL) |
Nicola Corna | 92e95ca | 2017-01-23 15:29:03 +0100 | [diff] [blame] | 66 | help |
| 67 | Use me_cleaner to remove all the non-fundamental code from the Intel |
| 68 | ME/TXE firmware. |
| 69 | The resulting Intel ME/TXE firmware will have only the code |
| 70 | responsible for the very basic hardware initialization, leaving the |
| 71 | ME/TXE subsystem essentially in a disabled state. |
| 72 | |
| 73 | Don't flash a modified ME/TXE firmware and a new coreboot image at the |
| 74 | same time, test them in two different steps. |
| 75 | |
| 76 | WARNING: this tool isn't based on any official Intel documentation but |
| 77 | only on reverse engineering and trial & error. |
| 78 | |
| 79 | See the project's page |
Nicola Corna | 98f3034 | 2017-08-08 21:24:49 +0200 | [diff] [blame] | 80 | https://github.com/corna/me_cleaner |
Nicola Corna | 92e95ca | 2017-01-23 15:29:03 +0100 | [diff] [blame] | 81 | or the wiki |
Nicola Corna | 98f3034 | 2017-08-08 21:24:49 +0200 | [diff] [blame] | 82 | https://github.com/corna/me_cleaner/wiki/How-to-apply-me_cleaner |
| 83 | https://github.com/corna/me_cleaner/wiki/How-does-it-work%3F |
| 84 | https://github.com/corna/me_cleaner/wiki/me_cleaner-status |
Nicola Corna | 92e95ca | 2017-01-23 15:29:03 +0100 | [diff] [blame] | 85 | for more info about this tool |
| 86 | |
| 87 | If unsure, say N. |
| 88 | |
| 89 | comment "Please test the modified ME/TXE firmware and coreboot in two steps" |
| 90 | depends on USE_ME_CLEANER |
| 91 | |
Nicola Corna | 364f2e1 | 2018-03-31 18:24:44 +0200 | [diff] [blame] | 92 | config ME_CLEANER_ARGS |
| 93 | string |
| 94 | depends on USE_ME_CLEANER |
| 95 | default "-S" |
| 96 | |
Jan Tatje | 83a127a | 2019-01-09 20:39:28 +0100 | [diff] [blame] | 97 | config MAINBOARD_USES_IFD_GBE_REGION |
| 98 | def_bool n |
| 99 | |
Martin Roth | c6a177d | 2015-07-09 20:50:51 -0600 | [diff] [blame] | 100 | config HAVE_GBE_BIN |
Nico Huber | e81f334 | 2019-01-26 14:24:41 +0100 | [diff] [blame] | 101 | bool "Add gigabit ethernet configuration" |
Jan Tatje | 83a127a | 2019-01-09 20:39:28 +0100 | [diff] [blame] | 102 | depends on HAVE_IFD_BIN && MAINBOARD_USES_IFD_GBE_REGION |
Martin Roth | c6a177d | 2015-07-09 20:50:51 -0600 | [diff] [blame] | 103 | help |
Nico Huber | e81f334 | 2019-01-26 14:24:41 +0100 | [diff] [blame] | 104 | The integrated gigabit ethernet controller needs a configuration |
| 105 | file. Select this if you are going to use the PCH integrated |
| 106 | controller and want to add that file. |
Martin Roth | c6a177d | 2015-07-09 20:50:51 -0600 | [diff] [blame] | 107 | |
| 108 | config GBE_BIN_PATH |
Nico Huber | e81f334 | 2019-01-26 14:24:41 +0100 | [diff] [blame] | 109 | string "Path to gigabit ethernet configuration" |
Martin Roth | c6a177d | 2015-07-09 20:50:51 -0600 | [diff] [blame] | 110 | depends on HAVE_GBE_BIN |
| 111 | default "3rdparty/blobs/mainboard/$(MAINBOARDDIR)/gbe.bin" |
| 112 | |
Jan Tatje | 82a4e27 | 2019-01-06 17:38:36 +0100 | [diff] [blame] | 113 | config MAINBOARD_USES_IFD_EC_REGION |
| 114 | def_bool n |
| 115 | |
Lijian Zhao | 0fb6568 | 2017-05-16 12:11:45 -0700 | [diff] [blame] | 116 | config HAVE_EC_BIN |
| 117 | bool "Add EC firmware" |
Jan Tatje | 82a4e27 | 2019-01-06 17:38:36 +0100 | [diff] [blame] | 118 | depends on HAVE_IFD_BIN && MAINBOARD_USES_IFD_EC_REGION |
Lijian Zhao | 0fb6568 | 2017-05-16 12:11:45 -0700 | [diff] [blame] | 119 | help |
| 120 | The embedded controller needs a firmware file. |
| 121 | |
| 122 | Select this if you are going to use the PCH integrated controller |
| 123 | and have the EC firmware. EC firmware will be added to final image |
| 124 | through ifdtool. |
| 125 | |
| 126 | config EC_BIN_PATH |
| 127 | string "Path to EC firmware" |
| 128 | depends on HAVE_EC_BIN |
| 129 | default "3rdparty/blobs/mainboard/$(MAINBOARDDIR)/ec.bin" |
| 130 | |
Mario Scheithauer | 2687443 | 2019-02-27 10:29:01 +0100 | [diff] [blame] | 131 | choice |
| 132 | prompt "Protect flash regions" |
| 133 | default UNLOCK_FLASH_REGIONS |
| 134 | help |
| 135 | This option allows you to protect flash regions. |
| 136 | |
| 137 | config DO_NOT_TOUCH_DESCRIPTOR_REGION |
| 138 | bool "Use the preset values to protect the regions" |
| 139 | help |
| 140 | Read and write access permissions to different regions in the flash |
| 141 | can be controlled via dedicated bitfields in the flash descriptor. |
| 142 | These permissions can be modified with the Intel Flash Descriptor |
| 143 | Tool (ifdtool). If you don't want to change these permissions and |
| 144 | keep the ones provided in the initial descriptor, use this option. |
| 145 | |
Martin Roth | 775d508 | 2015-06-23 21:47:19 -0600 | [diff] [blame] | 146 | config LOCK_MANAGEMENT_ENGINE |
| 147 | bool "Lock ME/TXE section" |
Martin Roth | 775d508 | 2015-06-23 21:47:19 -0600 | [diff] [blame] | 148 | help |
| 149 | The Intel Firmware Descriptor supports preventing write accesses |
| 150 | from the host to the ME or TXE section in the firmware |
| 151 | descriptor. If the section is locked, it can only be overwritten |
| 152 | with an external SPI flash programmer. You will want this if you |
| 153 | want to increase security of your ROM image once you are sure |
| 154 | that the ME/TXE firmware is no longer going to change. |
| 155 | |
Mario Scheithauer | 2687443 | 2019-02-27 10:29:01 +0100 | [diff] [blame] | 156 | If unsure, select "Unlock flash regions". |
| 157 | |
| 158 | config UNLOCK_FLASH_REGIONS |
| 159 | bool "Unlock flash regions" |
| 160 | help |
| 161 | All regions are completely unprotected and can be overwritten using |
| 162 | a flash programming tool. |
| 163 | |
| 164 | endchoice |
Martin Roth | 775d508 | 2015-06-23 21:47:19 -0600 | [diff] [blame] | 165 | |
Martin Roth | 59ff340 | 2016-02-09 09:06:46 -0700 | [diff] [blame] | 166 | config CBFS_SIZE |
| 167 | hex |
| 168 | default 0x100000 |
| 169 | help |
| 170 | Reduce CBFS size to give room to the IFD blobs. |
| 171 | |
Martin Roth | 59aa2b1 | 2015-06-20 16:17:12 -0600 | [diff] [blame] | 172 | endif #INTEL_FIRMWARE |