blob: 84e9fb1f8adddca003abb3b7cb483e379f05eb8f [file] [log] [blame]
Simon Glass547cb402017-08-03 12:21:49 -06001menu "Environment"
2
Rasmus Villemoesecdf0742019-12-15 22:29:39 +00003config ENV_SUPPORT
4 def_bool y
5
Rasmus Villemoes21294752020-02-19 09:47:39 +00006config SAVEENV
7 def_bool y if CMD_SAVEENV
8
Adam Ford710966e2020-07-03 06:48:56 -05009config ENV_OVERWRITE
10 bool "Enable overwriting environment"
11 help
12 Use this to permit overriding of certain environmental variables
13 like Ethernet and Serial
14
Simon Glass87551f12017-08-03 12:21:59 -060015config ENV_IS_NOWHERE
16 bool "Environment is not stored"
Patrice Chotardaf755812019-05-07 11:24:02 +020017 default y if !ENV_IS_IN_EEPROM && !ENV_IS_IN_EXT4 && \
18 !ENV_IS_IN_FAT && !ENV_IS_IN_FLASH && \
19 !ENV_IS_IN_MMC && !ENV_IS_IN_NAND && \
20 !ENV_IS_IN_NVRAM && !ENV_IS_IN_ONENAND && \
21 !ENV_IS_IN_REMOTE && !ENV_IS_IN_SPI_FLASH && \
22 !ENV_IS_IN_UBI
Simon Glass87551f12017-08-03 12:21:59 -060023 help
24 Define this if you don't want to or can't have an environment stored
Shyam Sainiefe757c2018-06-07 19:47:19 +053025 on a storage medium. In this case the environment will still exist
Simon Glass87551f12017-08-03 12:21:59 -060026 while U-Boot is running, but once U-Boot exits it will not be
27 stored. U-Boot will therefore always start up with a default
28 environment.
29
Simon Glass547cb402017-08-03 12:21:49 -060030config ENV_IS_IN_EEPROM
31 bool "Environment in EEPROM"
32 depends on !CHAIN_OF_TRUST
33 help
34 Use this if you have an EEPROM or similar serial access
35 device and a driver for it.
36
37 - CONFIG_ENV_OFFSET:
38 - CONFIG_ENV_SIZE:
39
40 These two #defines specify the offset and size of the
41 environment area within the total memory of your EEPROM.
42
Simon Glass547cb402017-08-03 12:21:49 -060043 Note that we consider the length of the address field to
44 still be one byte because the extra address bits are hidden
45 in the chip address.
46
Simon Glass547cb402017-08-03 12:21:49 -060047 - CONFIG_ENV_EEPROM_IS_ON_I2C
48 define this, if you have I2C and SPI activated, and your
49 EEPROM, which holds the environment, is on the I2C bus.
50
51 - CONFIG_I2C_ENV_EEPROM_BUS
52 if you have an Environment on an EEPROM reached over
53 I2C muxes, you can define here, how to reach this
54 EEPROM. For example:
55
56 #define CONFIG_I2C_ENV_EEPROM_BUS 1
57
58 EEPROM which holds the environment, is reached over
59 a pca9547 i2c mux with address 0x70, channel 3.
60
61config ENV_IS_IN_FAT
62 bool "Environment is in a FAT filesystem"
63 depends on !CHAIN_OF_TRUST
Maxime Ripard7569e182018-01-23 21:17:01 +010064 default y if ARCH_BCM283X
Maxime Ripard8b7dcd32018-01-23 21:17:04 +010065 default y if ARCH_SUNXI && MMC
Maxime Ripard7569e182018-01-23 21:17:01 +010066 default y if MMC_OMAP_HS && TI_COMMON_CMD_OPTIONS
Tuomas Tynkkynendc256cd2018-01-05 02:45:19 +020067 select FS_FAT
Simon Glass547cb402017-08-03 12:21:49 -060068 select FAT_WRITE
69 help
Simon Glassea8bf842017-08-03 12:21:50 -060070 Define this if you want to use the FAT file system for the environment.
Simon Glass547cb402017-08-03 12:21:49 -060071
Jorge Ramirez-Ortiz4a4c26d2018-01-10 11:33:48 +010072config ENV_IS_IN_EXT4
73 bool "Environment is in a EXT4 filesystem"
74 depends on !CHAIN_OF_TRUST
Michal Simek4b4ba3c2020-08-19 10:44:23 +020075 select FS_EXT4
Jorge Ramirez-Ortiz4a4c26d2018-01-10 11:33:48 +010076 select EXT4_WRITE
77 help
78 Define this if you want to use the EXT4 file system for the environment.
79
Simon Glass547cb402017-08-03 12:21:49 -060080config ENV_IS_IN_FLASH
81 bool "Environment in flash memory"
82 depends on !CHAIN_OF_TRUST
Maxime Ripard7569e182018-01-23 21:17:01 +010083 default y if ARCH_CINTEGRATOR
84 default y if ARCH_INTEGRATOR_CP
85 default y if M548x || M547x || M5282 || MCF547x_8x
86 default y if MCF532x || MCF52x2
87 default y if MPC86xx || MPC83xx
88 default y if ARCH_MPC8572 || ARCH_MPC8548 || ARCH_MPC8641
89 default y if SH && !CPU_SH4
Simon Glass547cb402017-08-03 12:21:49 -060090 help
91 Define this if you have a flash device which you want to use for the
92 environment.
93
94 a) The environment occupies one whole flash sector, which is
95 "embedded" in the text segment with the U-Boot code. This
96 happens usually with "bottom boot sector" or "top boot
97 sector" type flash chips, which have several smaller
98 sectors at the start or the end. For instance, such a
99 layout can have sector sizes of 8, 2x4, 16, Nx32 kB. In
100 such a case you would place the environment in one of the
101 4 kB sectors - with U-Boot code before and after it. With
102 "top boot sector" type flash chips, you would put the
103 environment in one of the last sectors, leaving a gap
104 between U-Boot and the environment.
105
106 CONFIG_ENV_OFFSET:
107
108 Offset of environment data (variable area) to the
109 beginning of flash memory; for instance, with bottom boot
110 type flash chips the second sector can be used: the offset
111 for this sector is given here.
112
113 CONFIG_ENV_OFFSET is used relative to CONFIG_SYS_FLASH_BASE.
114
115 CONFIG_ENV_ADDR:
116
117 This is just another way to specify the start address of
118 the flash sector containing the environment (instead of
119 CONFIG_ENV_OFFSET).
120
121 CONFIG_ENV_SECT_SIZE:
122
123 Size of the sector containing the environment.
124
125
126 b) Sometimes flash chips have few, equal sized, BIG sectors.
127 In such a case you don't want to spend a whole sector for
128 the environment.
129
130 CONFIG_ENV_SIZE:
131
132 If you use this in combination with CONFIG_ENV_IS_IN_FLASH
133 and CONFIG_ENV_SECT_SIZE, you can specify to use only a part
134 of this flash sector for the environment. This saves
135 memory for the RAM copy of the environment.
136
137 It may also save flash memory if you decide to use this
138 when your environment is "embedded" within U-Boot code,
139 since then the remainder of the flash sector could be used
140 for U-Boot code. It should be pointed out that this is
141 STRONGLY DISCOURAGED from a robustness point of view:
142 updating the environment in flash makes it always
143 necessary to erase the WHOLE sector. If something goes
144 wrong before the contents has been restored from a copy in
145 RAM, your target system will be dead.
146
147 CONFIG_ENV_ADDR_REDUND
Simon Glass547cb402017-08-03 12:21:49 -0600148
149 These settings describe a second storage area used to hold
150 a redundant copy of the environment data, so that there is
151 a valid backup copy in case there is a power failure during
152 a "saveenv" operation.
153
154 BE CAREFUL! Any changes to the flash layout, and some changes to the
155 source code will make it necessary to adapt <board>/u-boot.lds*
156 accordingly!
157
158config ENV_IS_IN_MMC
159 bool "Environment in an MMC device"
160 depends on !CHAIN_OF_TRUST
Maxime Ripard662a1ec2018-01-23 21:17:00 +0100161 depends on MMC
Maxime Ripard7569e182018-01-23 21:17:01 +0100162 default y if ARCH_EXYNOS4
163 default y if MX6SX || MX7D
164 default y if TEGRA30 || TEGRA124
165 default y if TEGRA_ARMV8_COMMON
Simon Glass547cb402017-08-03 12:21:49 -0600166 help
167 Define this if you have an MMC device which you want to use for the
168 environment.
169
170 CONFIG_SYS_MMC_ENV_DEV:
171
172 Specifies which MMC device the environment is stored in.
173
174 CONFIG_SYS_MMC_ENV_PART (optional):
175
176 Specifies which MMC partition the environment is stored in. If not
177 set, defaults to partition 0, the user area. Common values might be
178 1 (first MMC boot partition), 2 (second MMC boot partition).
179
180 CONFIG_ENV_OFFSET:
181 CONFIG_ENV_SIZE:
182
183 These two #defines specify the offset and size of the environment
184 area within the specified MMC device.
185
186 If offset is positive (the usual case), it is treated as relative to
187 the start of the MMC partition. If offset is negative, it is treated
188 as relative to the end of the MMC partition. This can be useful if
189 your board may be fitted with different MMC devices, which have
190 different sizes for the MMC partitions, and you always want the
191 environment placed at the very end of the partition, to leave the
192 maximum possible space before it, to store other data.
193
194 These two values are in units of bytes, but must be aligned to an
195 MMC sector boundary.
196
197 CONFIG_ENV_OFFSET_REDUND (optional):
198
199 Specifies a second storage area, of CONFIG_ENV_SIZE size, used to
200 hold a redundant copy of the environment data. This provides a
201 valid backup copy in case the other copy is corrupted, e.g. due
202 to a power failure during a "saveenv" operation.
203
204 This value may also be positive or negative; this is handled in the
205 same way as CONFIG_ENV_OFFSET.
206
207 This value is also in units of bytes, but must also be aligned to
208 an MMC sector boundary.
209
Simon Glass547cb402017-08-03 12:21:49 -0600210config ENV_IS_IN_NAND
211 bool "Environment in a NAND device"
212 depends on !CHAIN_OF_TRUST
213 help
214 Define this if you have a NAND device which you want to use for the
215 environment.
216
217 - CONFIG_ENV_OFFSET:
218 - CONFIG_ENV_SIZE:
219
220 These two #defines specify the offset and size of the environment
221 area within the first NAND device. CONFIG_ENV_OFFSET must be
222 aligned to an erase block boundary.
223
224 - CONFIG_ENV_OFFSET_REDUND (optional):
225
226 This setting describes a second storage area of CONFIG_ENV_SIZE
227 size used to hold a redundant copy of the environment data, so
228 that there is a valid backup copy in case there is a power failure
229 during a "saveenv" operation. CONFIG_ENV_OFFSET_REDUND must be
230 aligned to an erase block boundary.
231
232 - CONFIG_ENV_RANGE (optional):
233
234 Specifies the length of the region in which the environment
235 can be written. This should be a multiple of the NAND device's
236 block size. Specifying a range with more erase blocks than
237 are needed to hold CONFIG_ENV_SIZE allows bad blocks within
238 the range to be avoided.
239
240 - CONFIG_ENV_OFFSET_OOB (optional):
241
242 Enables support for dynamically retrieving the offset of the
243 environment from block zero's out-of-band data. The
244 "nand env.oob" command can be used to record this offset.
245 Currently, CONFIG_ENV_OFFSET_REDUND is not supported when
246 using CONFIG_ENV_OFFSET_OOB.
247
248config ENV_IS_IN_NVRAM
249 bool "Environment in a non-volatile RAM"
250 depends on !CHAIN_OF_TRUST
251 help
252 Define this if you have some non-volatile memory device
253 (NVRAM, battery buffered SRAM) which you want to use for the
254 environment.
255
256 - CONFIG_ENV_ADDR:
257 - CONFIG_ENV_SIZE:
258
259 These two #defines are used to determine the memory area you
260 want to use for environment. It is assumed that this memory
261 can just be read and written to, without any special
262 provision.
263
264config ENV_IS_IN_ONENAND
265 bool "Environment is in OneNAND"
266 depends on !CHAIN_OF_TRUST
267 help
268 Define this if you want to put your local device's environment in
269 OneNAND.
270
271 - CONFIG_ENV_ADDR:
272 - CONFIG_ENV_SIZE:
273
274 These two #defines are used to determine the device range you
275 want to use for environment. It is assumed that this memory
276 can just be read and written to, without any special
277 provision.
278
279config ENV_IS_IN_REMOTE
Heinrich Schuchardtaefbfe12018-03-17 22:53:11 +0000280 bool "Environment is in remote memory space"
Simon Glass547cb402017-08-03 12:21:49 -0600281 depends on !CHAIN_OF_TRUST
282 help
283 Define this if you have a remote memory space which you
284 want to use for the local device's environment.
285
286 - CONFIG_ENV_ADDR:
287 - CONFIG_ENV_SIZE:
288
289 These two #defines specify the address and size of the
290 environment area within the remote memory space. The
291 local device can get the environment from remote memory
292 space by SRIO or PCIE links.
293
294config ENV_IS_IN_SPI_FLASH
295 bool "Environment is in SPI flash"
Tom Rinie5289a72019-05-29 17:01:28 -0400296 depends on !CHAIN_OF_TRUST && SPI
Maxime Ripard7569e182018-01-23 21:17:01 +0100297 default y if ARMADA_XP
298 default y if INTEL_BAYTRAIL
299 default y if INTEL_BRASWELL
300 default y if INTEL_BROADWELL
301 default y if NORTHBRIDGE_INTEL_IVYBRIDGE
302 default y if INTEL_QUARK
303 default y if INTEL_QUEENSBAY
Simon Glass547cb402017-08-03 12:21:49 -0600304 help
305 Define this if you have a SPI Flash memory device which you
306 want to use for the environment.
307
308 - CONFIG_ENV_OFFSET:
309 - CONFIG_ENV_SIZE:
310
311 These two #defines specify the offset and size of the
312 environment area within the SPI Flash. CONFIG_ENV_OFFSET must be
313 aligned to an erase sector boundary.
314
315 - CONFIG_ENV_SECT_SIZE:
316
317 Define the SPI flash's sector size.
318
319 - CONFIG_ENV_OFFSET_REDUND (optional):
320
321 This setting describes a second storage area of CONFIG_ENV_SIZE
322 size used to hold a redundant copy of the environment data, so
323 that there is a valid backup copy in case there is a power failure
324 during a "saveenv" operation. CONFIG_ENV_OFFSET_REDUND must be
325 aligned to an erase sector boundary.
326
Rasmus Villemoese535f5b2021-04-14 20:51:43 +0200327config ENV_SECT_SIZE_AUTO
328 bool "Use automatically detected sector size"
329 depends on ENV_IS_IN_SPI_FLASH
330 help
331 Some boards exist in multiple variants, with different
332 flashes having different sector sizes. In such cases, you
333 can select this option to make U-Boot use the actual sector
334 size when figuring out how much to erase, which can thus be
335 more efficient on the flashes with smaller erase size. Since
336 the environment must always be aligned on a sector boundary,
337 CONFIG_ENV_OFFSET must be aligned to the largest of the
338 different sector sizes, and CONFIG_ENV_SECT_SIZE should be
339 set to that value.
340
Patrick Delaunayf8e932e2019-02-27 15:20:38 +0100341config USE_ENV_SPI_BUS
342 bool "SPI flash bus for environment"
343 depends on ENV_IS_IN_SPI_FLASH
344 help
345 Force the SPI bus for environment.
346 If not defined, use CONFIG_SF_DEFAULT_BUS.
Simon Glass547cb402017-08-03 12:21:49 -0600347
Patrick Delaunayf8e932e2019-02-27 15:20:38 +0100348config ENV_SPI_BUS
349 int "Value of SPI flash bus for environment"
350 depends on USE_ENV_SPI_BUS
351 help
352 Value the SPI bus and chip select for environment.
Simon Glass547cb402017-08-03 12:21:49 -0600353
Patrick Delaunayf8e932e2019-02-27 15:20:38 +0100354config USE_ENV_SPI_CS
355 bool "SPI flash chip select for environment"
356 depends on ENV_IS_IN_SPI_FLASH
357 help
358 Force the SPI chip select for environment.
359 If not defined, use CONFIG_SF_DEFAULT_CS.
Simon Glass547cb402017-08-03 12:21:49 -0600360
Patrick Delaunayf8e932e2019-02-27 15:20:38 +0100361config ENV_SPI_CS
362 int "Value of SPI flash chip select for environment"
363 depends on USE_ENV_SPI_CS
364 help
365 Value of the SPI chip select for environment.
Simon Glass547cb402017-08-03 12:21:49 -0600366
Patrick Delaunayf8e932e2019-02-27 15:20:38 +0100367config USE_ENV_SPI_MAX_HZ
Marek Vasutdfe74622019-05-04 19:10:05 +0200368 bool "SPI flash max frequency for environment"
Patrick Delaunayf8e932e2019-02-27 15:20:38 +0100369 depends on ENV_IS_IN_SPI_FLASH
370 help
371 Force the SPI max work clock for environment.
372 If not defined, use CONFIG_SF_DEFAULT_SPEED.
373
374config ENV_SPI_MAX_HZ
Marek Vasutdfe74622019-05-04 19:10:05 +0200375 int "Value of SPI flash max frequency for environment"
Patrick Delaunayf8e932e2019-02-27 15:20:38 +0100376 depends on USE_ENV_SPI_MAX_HZ
377 help
378 Value of the SPI max work clock for environment.
379
380config USE_ENV_SPI_MODE
381 bool "SPI flash mode for environment"
382 depends on ENV_IS_IN_SPI_FLASH
383 help
384 Force the SPI work mode for environment.
Simon Glass547cb402017-08-03 12:21:49 -0600385
Patrick Delaunayf8e932e2019-02-27 15:20:38 +0100386config ENV_SPI_MODE
387 hex "Value of SPI flash work mode for environment"
388 depends on USE_ENV_SPI_MODE
389 help
390 Value of the SPI work mode for environment.
391 See include/spi.h for value.
Simon Glass547cb402017-08-03 12:21:49 -0600392
Heiko Schocher704d21c2020-10-10 10:28:05 +0200393config ENV_SPI_EARLY
394 bool "Access Environment in SPI flashes before relocation"
395 depends on ENV_IS_IN_SPI_FLASH
396 help
397 Enable this if you want to use Environment in SPI flash
398 before relocation. Call env_init() and than you can use
399 env_get_f() for accessing Environment variables.
400
Simon Glass547cb402017-08-03 12:21:49 -0600401config ENV_IS_IN_UBI
402 bool "Environment in a UBI volume"
403 depends on !CHAIN_OF_TRUST
Miquel Raynal27271b62019-10-03 19:50:12 +0200404 depends on MTD_UBI
405 depends on CMD_UBI
Simon Glass547cb402017-08-03 12:21:49 -0600406 help
407 Define this if you have an UBI volume that you want to use for the
408 environment. This has the benefit of wear-leveling the environment
409 accesses, which is important on NAND.
410
411 - CONFIG_ENV_UBI_PART:
412
413 Define this to a string that is the mtd partition containing the UBI.
414
415 - CONFIG_ENV_UBI_VOLUME:
416
417 Define this to the name of the volume that you want to store the
418 environment in.
419
420 - CONFIG_ENV_UBI_VOLUME_REDUND:
421
422 Define this to the name of another volume to store a second copy of
423 the environment in. This will enable redundant environments in UBI.
424 It is assumed that both volumes are in the same MTD partition.
425
Tom Rini4bb26a42019-11-10 11:28:03 -0500426config SYS_REDUNDAND_ENVIRONMENT
427 bool "Enable redundant environment support"
Tom Rini4bb26a42019-11-10 11:28:03 -0500428 help
429 Normally, the environemt is stored in a single location. By
430 selecting this option, you can then define where to hold a redundant
431 copy of the environment data, so that there is a valid backup copy in
432 case there is a power failure during a "saveenv" operation.
Michal Simekcc780ec2021-01-13 10:25:50 +0100433 Also this config changes the binary environment structure handling
434 which is used by env import/export commands which are independent of
435 storing variables to redundant location on a non volatile device.
Tom Rini4bb26a42019-11-10 11:28:03 -0500436
Simon Glass547cb402017-08-03 12:21:49 -0600437config ENV_FAT_INTERFACE
438 string "Name of the block device for the environment"
439 depends on ENV_IS_IN_FAT
Michal Simek5227e1e2020-02-25 15:50:33 +0100440 default "mmc"
Simon Glass547cb402017-08-03 12:21:49 -0600441 help
442 Define this to a string that is the name of the block device.
443
444config ENV_FAT_DEVICE_AND_PART
445 string "Device and partition for where to store the environemt in FAT"
446 depends on ENV_IS_IN_FAT
447 default "0:1" if TI_COMMON_CMD_OPTIONS
Michal Simek678d1352020-08-24 13:35:53 +0200448 default "0:auto" if ARCH_ZYNQ || ARCH_ZYNQMP
Maxime Ripard8b7dcd32018-01-23 21:17:04 +0100449 default "0:auto" if ARCH_SUNXI && MMC_SUNXI_SLOT_EXTRA = -1
450 default "1:auto" if ARCH_SUNXI && MMC_SUNXI_SLOT_EXTRA != -1
Simon Glass547cb402017-08-03 12:21:49 -0600451 default "0" if ARCH_AT91
452 help
453 Define this to a string to specify the partition of the device. It can
454 be as following:
455
456 "D:P", "D:0", "D", "D:" or "D:auto" (D, P are integers. And P >= 1)
457 - "D:P": device D partition P. Error occurs if device D has no
458 partition table.
459 - "D:0": device D.
460 - "D" or "D:": device D partition 1 if device D has partition
461 table, or the whole device D if has no partition
462 table.
463 - "D:auto": first partition in device D with bootable flag set.
464 If none, first valid partition in device D. If no
465 partition table then means device D.
466
David Woodhouse93365392020-06-19 23:07:17 +0100467 If ENV_FAT_INTERFACE is set to "mmc" then device 'D' can be omitted,
468 leaving the string starting with a colon, and the boot device will
469 be used.
470
Simon Glass547cb402017-08-03 12:21:49 -0600471config ENV_FAT_FILE
Shyam Sainiefe757c2018-06-07 19:47:19 +0530472 string "Name of the FAT file to use for the environment"
Simon Glass547cb402017-08-03 12:21:49 -0600473 depends on ENV_IS_IN_FAT
474 default "uboot.env"
475 help
476 It's a string of the FAT file name. This file use to store the
477 environment.
478
Brandon Maierf2815462021-01-16 15:14:43 -0600479config ENV_FAT_FILE_REDUND
480 string "Name of the FAT file to use for the environment"
481 depends on ENV_IS_IN_FAT && SYS_REDUNDAND_ENVIRONMENT
482 default "uboot-redund.env"
483 help
484 It's a string of the FAT file name. This file use to store the
485 redundant environment.
486
Jorge Ramirez-Ortiz4a4c26d2018-01-10 11:33:48 +0100487config ENV_EXT4_INTERFACE
488 string "Name of the block device for the environment"
489 depends on ENV_IS_IN_EXT4
490 help
491 Define this to a string that is the name of the block device.
492
493config ENV_EXT4_DEVICE_AND_PART
494 string "Device and partition for where to store the environemt in EXT4"
495 depends on ENV_IS_IN_EXT4
496 help
497 Define this to a string to specify the partition of the device. It can
498 be as following:
499
500 "D:P", "D:0", "D", "D:" or "D:auto" (D, P are integers. And P >= 1)
501 - "D:P": device D partition P. Error occurs if device D has no
502 partition table.
503 - "D:0": device D.
504 - "D" or "D:": device D partition 1 if device D has partition
505 table, or the whole device D if has no partition
506 table.
507 - "D:auto": first partition in device D with bootable flag set.
508 If none, first valid partition in device D. If no
509 partition table then means device D.
510
David Woodhouse6815e2c2020-08-04 10:05:47 +0100511 If ENV_EXT4_INTERFACE is set to "mmc" then device 'D' can be omitted,
512 leaving the string starting with a colon, and the boot device will
513 be used.
514
Jorge Ramirez-Ortiz4a4c26d2018-01-10 11:33:48 +0100515config ENV_EXT4_FILE
Shyam Sainiefe757c2018-06-07 19:47:19 +0530516 string "Name of the EXT4 file to use for the environment"
Jorge Ramirez-Ortiz4a4c26d2018-01-10 11:33:48 +0100517 depends on ENV_IS_IN_EXT4
Patrick Delaunay955b6712020-07-28 11:51:14 +0200518 default "/uboot.env"
Jorge Ramirez-Ortiz4a4c26d2018-01-10 11:33:48 +0100519 help
520 It's a string of the EXT4 file name. This file use to store the
521 environment (explicit path to the file)
522
Tom Rini5cd7ece2019-11-18 20:02:10 -0500523config ENV_ADDR
524 hex "Environment address"
525 depends on ENV_IS_IN_FLASH || ENV_IS_IN_NVRAM || ENV_IS_IN_ONENAND || \
526 ENV_IS_IN_REMOTE || ENV_IS_IN_SPI_FLASH
527 default 0x0 if ENV_IS_IN_SPI_FLASH
528 help
529 Offset from the start of the device (or partition)
530
531config ENV_ADDR_REDUND
532 hex "Redundant environment address"
533 depends on ENV_IS_IN_FLASH && SYS_REDUNDAND_ENVIRONMENT
534 help
535 Offset from the start of the device (or partition) of the redundant
536 environment location.
Simon Glass547cb402017-08-03 12:21:49 -0600537
538config ENV_OFFSET
Tom Rini5cd7ece2019-11-18 20:02:10 -0500539 hex "Environment offset"
540 depends on ENV_IS_IN_EEPROM || ENV_IS_IN_MMC || ENV_IS_IN_NAND || \
541 ENV_IS_IN_SPI_FLASH
Jagan Tekic4ec2262019-12-21 13:24:35 +0530542 default 0x3f8000 if ARCH_ROCKCHIP && ENV_IS_IN_MMC
Jagan Teki68397572019-12-21 13:24:36 +0530543 default 0x140000 if ARCH_ROCKCHIP && ENV_IS_IN_SPI_FLASH
Simon Glass547cb402017-08-03 12:21:49 -0600544 default 0x88000 if ARCH_SUNXI
Michal Simeke93ef192018-07-19 08:45:45 +0200545 default 0xE0000 if ARCH_ZYNQ
546 default 0x1E00000 if ARCH_ZYNQMP
T Karthik Reddy76770302019-08-05 16:18:57 +0530547 default 0x7F40000 if ARCH_VERSAL
Alexey Brodkin07dfc092019-01-15 11:42:48 +0300548 default 0 if ARC
Markus Klotzbuecher7bd60e62019-05-15 15:15:54 +0200549 default 0x140000 if ARCH_AT91
550 default 0x260000 if ARCH_OMAP2PLUS
Varalaxmi Bingi52e79212020-02-05 03:58:20 -0700551 default 0x1080000 if MICROBLAZE && ENV_IS_IN_SPI_FLASH
Simon Glass547cb402017-08-03 12:21:49 -0600552 help
553 Offset from the start of the device (or partition)
554
Tom Rini5cd7ece2019-11-18 20:02:10 -0500555config ENV_OFFSET_REDUND
556 hex "Redundant environment offset"
557 depends on (ENV_IS_IN_EEPROM || ENV_IS_IN_MMC || ENV_IS_IN_NAND || \
558 ENV_IS_IN_SPI_FLASH) && SYS_REDUNDAND_ENVIRONMENT
Michal Simek46d6b522021-02-24 10:33:45 +0100559 default 0
Tom Rini5cd7ece2019-11-18 20:02:10 -0500560 help
561 Offset from the start of the device (or partition) of the redundant
562 environment location.
563
Simon Glass547cb402017-08-03 12:21:49 -0600564config ENV_SIZE
565 hex "Environment Size"
Michal Simeke93ef192018-07-19 08:45:45 +0200566 default 0x40000 if ENV_IS_IN_SPI_FLASH && ARCH_ZYNQMP
Markus Klotzbuecher7bd60e62019-05-15 15:15:54 +0200567 default 0x20000 if ARCH_SUNXI || ARCH_ZYNQ || ARCH_OMAP2PLUS || ARCH_AT91
Jagan Tekic4ec2262019-12-21 13:24:35 +0530568 default 0x8000 if ARCH_ROCKCHIP && ENV_IS_IN_MMC
Jagan Teki68397572019-12-21 13:24:36 +0530569 default 0x2000 if ARCH_ROCKCHIP && ENV_IS_IN_SPI_FLASH
Jagan Tekic4ec2262019-12-21 13:24:35 +0530570 default 0x8000 if ARCH_ZYNQMP || ARCH_VERSAL
Alexey Brodkin07dfc092019-01-15 11:42:48 +0300571 default 0x4000 if ARC
Markus Klotzbuecher7bd60e62019-05-15 15:15:54 +0200572 default 0x1f000
Simon Glass547cb402017-08-03 12:21:49 -0600573 help
574 Size of the environment storage area
575
Michal Simeke93ef192018-07-19 08:45:45 +0200576config ENV_SECT_SIZE
577 hex "Environment Sector-Size"
Tom Rini5cd7ece2019-11-18 20:02:10 -0500578 depends on ENV_IS_IN_FLASH || ENV_IS_IN_SPI_FLASH
Jagan Teki68397572019-12-21 13:24:36 +0530579 default 0x2000 if ARCH_ROCKCHIP
T Karthik Reddy76770302019-08-05 16:18:57 +0530580 default 0x40000 if ARCH_ZYNQMP || ARCH_VERSAL
Markus Klotzbuecher7bd60e62019-05-15 15:15:54 +0200581 default 0x20000 if ARCH_ZYNQ || ARCH_OMAP2PLUS || ARCH_AT91
Varalaxmi Bingi52e79212020-02-05 03:58:20 -0700582 default 0x20000 if MICROBLAZE && ENV_IS_IN_SPI_FLASH
Michal Simeke93ef192018-07-19 08:45:45 +0200583 help
584 Size of the sector containing the environment.
585
Simon Glass547cb402017-08-03 12:21:49 -0600586config ENV_UBI_PART
587 string "UBI partition name"
588 depends on ENV_IS_IN_UBI
589 help
590 MTD partition containing the UBI device
591
592config ENV_UBI_VOLUME
593 string "UBI volume name"
594 depends on ENV_IS_IN_UBI
595 help
596 Name of the volume that you want to store the environment in.
597
Markus Klotzbuecher975bcde2019-05-15 15:15:53 +0200598config ENV_UBI_VOLUME_REDUND
599 string "UBI redundant volume name"
Tom Rini4bb26a42019-11-10 11:28:03 -0500600 depends on ENV_IS_IN_UBI && SYS_REDUNDAND_ENVIRONMENT
Markus Klotzbuecher975bcde2019-05-15 15:15:53 +0200601 help
602 Name of the redundant volume that you want to store the environment in.
603
Hamish Guthrie674ab242019-05-15 15:15:55 +0200604config ENV_UBI_VID_OFFSET
605 int "ubi environment VID offset"
606 depends on ENV_IS_IN_UBI
607 default 0
608 help
609 UBI VID offset for environment. If 0, no custom VID offset is used.
610
Tom Rinica63e712019-11-12 22:46:36 -0500611config SYS_RELOC_GD_ENV_ADDR
Patrick Delaunay9f757532020-06-10 19:28:42 +0200612 bool "Relocate gd->env_addr"
Tom Rinica63e712019-11-12 22:46:36 -0500613 help
614 Relocate the early env_addr pointer so we know it is not inside
615 the binary. Some systems need this and for the rest, it doesn't hurt.
616
Tom Rinieb1f9092020-07-24 17:14:47 -0400617config SYS_MMC_ENV_DEV
618 int "mmc device number"
619 depends on ENV_IS_IN_MMC || ENV_IS_IN_FAT || SYS_LS_PPA_FW_IN_MMC || \
620 CMD_MVEBU_BUBT || FMAN_ENET || QE
621 default 0
622 help
623 MMC device number on the platform where the environment is stored.
624
625config SYS_MMC_ENV_PART
626 int "mmc partition number"
627 depends on ENV_IS_IN_MMC || ENV_IS_IN_FAT
628 default 0
629 help
630 MMC hardware partition device number on the platform where the
631 environment is stored. Note that this is not related to any software
632 defined partition table but instead if we are in the user area, which is
633 partition 0 or the first boot partition, which is 1 or some other defined
634 partition.
635
Rasmus Villemoes14c71142018-03-20 11:38:45 +0100636config USE_DEFAULT_ENV_FILE
637 bool "Create default environment from file"
638 help
639 Normally, the default environment is automatically generated
640 based on the settings of various CONFIG_* options, as well
641 as the CONFIG_EXTRA_ENV_SETTINGS. By selecting this option,
642 you can instead define the entire default environment in an
643 external file.
644
645config DEFAULT_ENV_FILE
646 string "Path to default environment file"
647 depends on USE_DEFAULT_ENV_FILE
648 help
649 The path containing the default environment. The format is
650 the same as accepted by the mkenvimage tool: lines
651 containing key=value pairs, blank lines and lines beginning
652 with # are ignored.
653
Alex Kiernana410d6e2018-04-01 16:37:53 +0000654config ENV_VARS_UBOOT_RUNTIME_CONFIG
655 bool "Add run-time information to the environment"
656 help
657 Enable this in order to add variables describing certain
658 run-time determined information about the hardware to the
659 environment. These will be named board_name, board_rev.
660
Ovidiu Panait86ccd752020-05-06 20:38:42 +0300661config DELAY_ENVIRONMENT
662 bool "Delay environment loading"
663 depends on !OF_CONTROL
664 help
665 Enable this to inhibit loading the environment during board
666 initialization. This can address the security risk of untrusted data
667 being used during boot. Normally the environment is loaded when the
668 board is initialised so that it is available to U-Boot. This inhibits
669 that so that the environment is not available until explicitly loaded
670 later by U-Boot code. With CONFIG_OF_CONTROL this is instead
671 controlled by the value of /config/load-environment.
672
Marek Vasuta7b82672020-07-07 20:51:38 +0200673config ENV_APPEND
674 bool "Always append the environment with new data"
675 default n
676 help
677 If defined, the environment hash table is only ever appended with new
678 data, but the existing hash table can never be dropped and reloaded
679 with newly imported data. This may be used in combination with static
680 flags to e.g. to protect variables which must not be modified.
681
Marek Vasut803549f2020-07-07 20:51:39 +0200682config ENV_WRITEABLE_LIST
683 bool "Permit write access only to listed variables"
684 default n
685 help
686 If defined, only environment variables which explicitly set the 'w'
687 writeable flag can be written and modified at runtime. No variables
688 can be otherwise created, written or imported into the environment.
689
Marek Vasutb7f3f232020-05-22 01:10:14 +0200690config ENV_ACCESS_IGNORE_FORCE
691 bool "Block forced environment operations"
692 default n
693 help
694 If defined, don't allow the -f switch to env set override variable
695 access flags.
696
York Sun187da8d2018-06-26 10:03:22 -0700697if SPL_ENV_SUPPORT
698config SPL_ENV_IS_NOWHERE
699 bool "SPL Environment is not stored"
700 default y if ENV_IS_NOWHERE
701 help
702 Similar to ENV_IS_NOWHERE, used for SPL environment.
703
704config SPL_ENV_IS_IN_MMC
705 bool "SPL Environment in an MMC device"
706 depends on !SPL_ENV_IS_NOWHERE
707 depends on ENV_IS_IN_MMC
708 default y
709 help
710 Similar to ENV_IS_IN_MMC, used for SPL environment.
711
712config SPL_ENV_IS_IN_FAT
713 bool "SPL Environment is in a FAT filesystem"
714 depends on !SPL_ENV_IS_NOWHERE
715 depends on ENV_IS_IN_FAT
716 default y
717 help
718 Similar to ENV_IS_IN_FAT, used for SPL environment.
719
720config SPL_ENV_IS_IN_EXT4
721 bool "SPL Environment is in a EXT4 filesystem"
722 depends on !SPL_ENV_IS_NOWHERE
723 depends on ENV_IS_IN_EXT4
724 default y
725 help
726 Similar to ENV_IS_IN_EXT4, used for SPL environment.
727
728config SPL_ENV_IS_IN_NAND
729 bool "SPL Environment in a NAND device"
730 depends on !SPL_ENV_IS_NOWHERE
731 depends on ENV_IS_IN_NAND
732 default y
733 help
734 Similar to ENV_IS_IN_NAND, used for SPL environment.
735
736config SPL_ENV_IS_IN_SPI_FLASH
737 bool "SPL Environment is in SPI flash"
738 depends on !SPL_ENV_IS_NOWHERE
739 depends on ENV_IS_IN_SPI_FLASH
740 default y
741 help
742 Similar to ENV_IS_IN_SPI_FLASH, used for SPL environment.
743
744config SPL_ENV_IS_IN_FLASH
745 bool "SPL Environment in flash memory"
746 depends on !SPL_ENV_IS_NOWHERE
747 depends on ENV_IS_IN_FLASH
748 default y
749 help
750 Similar to ENV_IS_IN_FLASH, used for SPL environment.
751
752endif
753
754if TPL_ENV_SUPPORT
755
756config TPL_ENV_IS_NOWHERE
757 bool "TPL Environment is not stored"
758 default y if ENV_IS_NOWHERE
759 help
760 Similar to ENV_IS_NOWHERE, used for TPL environment.
761
762config TPL_ENV_IS_IN_MMC
763 bool "TPL Environment in an MMC device"
764 depends on !TPL_ENV_IS_NOWHERE
765 depends on ENV_IS_IN_MMC
766 default y
767 help
768 Similar to ENV_IS_IN_MMC, used for TPL environment.
769
770config TPL_ENV_IS_IN_FAT
771 bool "TPL Environment is in a FAT filesystem"
772 depends on !TPL_ENV_IS_NOWHERE
773 depends on ENV_IS_IN_FAT
774 default y
775 help
776 Similar to ENV_IS_IN_FAT, used for TPL environment.
777
778config TPL_ENV_IS_IN_EXT4
779 bool "TPL Environment is in a EXT4 filesystem"
780 depends on !TPL_ENV_IS_NOWHERE
781 depends on ENV_IS_IN_EXT4
782 default y
783 help
784 Similar to ENV_IS_IN_EXT4, used for TPL environment.
785
786config TPL_ENV_IS_IN_NAND
787 bool "TPL Environment in a NAND device"
788 depends on !TPL_ENV_IS_NOWHERE
789 depends on ENV_IS_IN_NAND
790 default y
791 help
792 Similar to ENV_IS_IN_NAND, used for TPL environment.
793
794config TPL_ENV_IS_IN_SPI_FLASH
795 bool "TPL Environment is in SPI flash"
796 depends on !TPL_ENV_IS_NOWHERE
797 depends on ENV_IS_IN_SPI_FLASH
798 default y
799 help
800 Similar to ENV_IS_IN_SPI_FLASH, used for TPL environment.
801
802config TPL_ENV_IS_IN_FLASH
803 bool "TPL Environment in flash memory"
804 depends on !TPL_ENV_IS_NOWHERE
805 depends on ENV_IS_IN_FLASH
806 default y
807 help
808 Similar to ENV_IS_IN_FLASH, used for TPL environment.
809
810endif
811
Simon Glass99298be2020-09-10 20:21:24 -0600812config VERSION_VARIABLE
813 bool "Add a 'ver' environment variable with the U-Boot version"
814 help
815 If this variable is defined, an environment variable
816 named "ver" is created by U-Boot showing the U-Boot
817 version as printed by the "version" command.
818 Any change to this variable will be reverted at the
819 next reset.
820
Simon Glass547cb402017-08-03 12:21:49 -0600821endmenu