7 def_bool y if CMD_SAVEENV
10 bool "Enable overwriting environment"
12 Use this to permit overriding of certain environmental variables
13 like Ethernet and Serial
16 bool "Environment is not stored"
17 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 && \
24 Define this if you don't want to or can't have an environment stored
25 on a storage medium. In this case the environment will still exist
26 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
30 config ENV_IS_IN_EEPROM
31 bool "Environment in EEPROM"
32 depends on !CHAIN_OF_TRUST
34 Use this if you have an EEPROM or similar serial access
35 device and a driver for it.
40 These two #defines specify the offset and size of the
41 environment area within the total memory of your EEPROM.
43 Note that we consider the length of the address field to
44 still be one byte because the extra address bits are hidden
47 - 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.
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
56 #define CONFIG_I2C_ENV_EEPROM_BUS 1
58 EEPROM which holds the environment, is reached over
59 a pca9547 i2c mux with address 0x70, channel 3.
62 bool "Environment is in a FAT filesystem"
63 depends on !CHAIN_OF_TRUST
64 default y if ARCH_BCM283X
65 default y if ARCH_SUNXI && MMC
66 default y if MMC_OMAP_HS && TI_COMMON_CMD_OPTIONS
70 Define this if you want to use the FAT file system for the environment.
73 bool "Environment is in a EXT4 filesystem"
74 depends on !CHAIN_OF_TRUST
77 Define this if you want to use the EXT4 file system for the environment.
79 config ENV_IS_IN_FLASH
80 bool "Environment in flash memory"
81 depends on !CHAIN_OF_TRUST
82 default y if ARCH_CINTEGRATOR
83 default y if ARCH_INTEGRATOR_CP
84 default y if M548x || M547x || M5282 || MCF547x_8x
85 default y if MCF532x || MCF52x2
86 default y if MPC86xx || MPC83xx
87 default y if ARCH_MPC8572 || ARCH_MPC8548 || ARCH_MPC8641
88 default y if SH && !CPU_SH4
90 Define this if you have a flash device which you want to use for the
93 a) The environment occupies one whole flash sector, which is
94 "embedded" in the text segment with the U-Boot code. This
95 happens usually with "bottom boot sector" or "top boot
96 sector" type flash chips, which have several smaller
97 sectors at the start or the end. For instance, such a
98 layout can have sector sizes of 8, 2x4, 16, Nx32 kB. In
99 such a case you would place the environment in one of the
100 4 kB sectors - with U-Boot code before and after it. With
101 "top boot sector" type flash chips, you would put the
102 environment in one of the last sectors, leaving a gap
103 between U-Boot and the environment.
107 Offset of environment data (variable area) to the
108 beginning of flash memory; for instance, with bottom boot
109 type flash chips the second sector can be used: the offset
110 for this sector is given here.
112 CONFIG_ENV_OFFSET is used relative to CONFIG_SYS_FLASH_BASE.
116 This is just another way to specify the start address of
117 the flash sector containing the environment (instead of
120 CONFIG_ENV_SECT_SIZE:
122 Size of the sector containing the environment.
125 b) Sometimes flash chips have few, equal sized, BIG sectors.
126 In such a case you don't want to spend a whole sector for
131 If you use this in combination with CONFIG_ENV_IS_IN_FLASH
132 and CONFIG_ENV_SECT_SIZE, you can specify to use only a part
133 of this flash sector for the environment. This saves
134 memory for the RAM copy of the environment.
136 It may also save flash memory if you decide to use this
137 when your environment is "embedded" within U-Boot code,
138 since then the remainder of the flash sector could be used
139 for U-Boot code. It should be pointed out that this is
140 STRONGLY DISCOURAGED from a robustness point of view:
141 updating the environment in flash makes it always
142 necessary to erase the WHOLE sector. If something goes
143 wrong before the contents has been restored from a copy in
144 RAM, your target system will be dead.
146 CONFIG_ENV_ADDR_REDUND
148 These settings describe a second storage area used to hold
149 a redundant copy of the environment data, so that there is
150 a valid backup copy in case there is a power failure during
151 a "saveenv" operation.
153 BE CAREFUL! Any changes to the flash layout, and some changes to the
154 source code will make it necessary to adapt <board>/u-boot.lds*
158 bool "Environment in an MMC device"
159 depends on !CHAIN_OF_TRUST
161 default y if ARCH_EXYNOS4
162 default y if MX6SX || MX7D
163 default y if TEGRA30 || TEGRA124
164 default y if TEGRA_ARMV8_COMMON
166 Define this if you have an MMC device which you want to use for the
169 CONFIG_SYS_MMC_ENV_DEV:
171 Specifies which MMC device the environment is stored in.
173 CONFIG_SYS_MMC_ENV_PART (optional):
175 Specifies which MMC partition the environment is stored in. If not
176 set, defaults to partition 0, the user area. Common values might be
177 1 (first MMC boot partition), 2 (second MMC boot partition).
182 These two #defines specify the offset and size of the environment
183 area within the specified MMC device.
185 If offset is positive (the usual case), it is treated as relative to
186 the start of the MMC partition. If offset is negative, it is treated
187 as relative to the end of the MMC partition. This can be useful if
188 your board may be fitted with different MMC devices, which have
189 different sizes for the MMC partitions, and you always want the
190 environment placed at the very end of the partition, to leave the
191 maximum possible space before it, to store other data.
193 These two values are in units of bytes, but must be aligned to an
196 CONFIG_ENV_OFFSET_REDUND (optional):
198 Specifies a second storage area, of CONFIG_ENV_SIZE size, used to
199 hold a redundant copy of the environment data. This provides a
200 valid backup copy in case the other copy is corrupted, e.g. due
201 to a power failure during a "saveenv" operation.
203 This value may also be positive or negative; this is handled in the
204 same way as CONFIG_ENV_OFFSET.
206 This value is also in units of bytes, but must also be aligned to
207 an MMC sector boundary.
209 config ENV_IS_IN_NAND
210 bool "Environment in a NAND device"
211 depends on !CHAIN_OF_TRUST
213 Define this if you have a NAND device which you want to use for the
219 These two #defines specify the offset and size of the environment
220 area within the first NAND device. CONFIG_ENV_OFFSET must be
221 aligned to an erase block boundary.
223 - CONFIG_ENV_OFFSET_REDUND (optional):
225 This setting describes a second storage area of CONFIG_ENV_SIZE
226 size used to hold a redundant copy of the environment data, so
227 that there is a valid backup copy in case there is a power failure
228 during a "saveenv" operation. CONFIG_ENV_OFFSET_REDUND must be
229 aligned to an erase block boundary.
231 - CONFIG_ENV_RANGE (optional):
233 Specifies the length of the region in which the environment
234 can be written. This should be a multiple of the NAND device's
235 block size. Specifying a range with more erase blocks than
236 are needed to hold CONFIG_ENV_SIZE allows bad blocks within
237 the range to be avoided.
239 - CONFIG_ENV_OFFSET_OOB (optional):
241 Enables support for dynamically retrieving the offset of the
242 environment from block zero's out-of-band data. The
243 "nand env.oob" command can be used to record this offset.
244 Currently, CONFIG_ENV_OFFSET_REDUND is not supported when
245 using CONFIG_ENV_OFFSET_OOB.
247 config ENV_IS_IN_NVRAM
248 bool "Environment in a non-volatile RAM"
249 depends on !CHAIN_OF_TRUST
251 Define this if you have some non-volatile memory device
252 (NVRAM, battery buffered SRAM) which you want to use for the
258 These two #defines are used to determine the memory area you
259 want to use for environment. It is assumed that this memory
260 can just be read and written to, without any special
263 config ENV_IS_IN_ONENAND
264 bool "Environment is in OneNAND"
265 depends on !CHAIN_OF_TRUST
267 Define this if you want to put your local device's environment in
273 These two #defines are used to determine the device range you
274 want to use for environment. It is assumed that this memory
275 can just be read and written to, without any special
278 config ENV_IS_IN_REMOTE
279 bool "Environment is in remote memory space"
280 depends on !CHAIN_OF_TRUST
282 Define this if you have a remote memory space which you
283 want to use for the local device's environment.
288 These two #defines specify the address and size of the
289 environment area within the remote memory space. The
290 local device can get the environment from remote memory
291 space by SRIO or PCIE links.
293 config ENV_IS_IN_SPI_FLASH
294 bool "Environment is in SPI flash"
295 depends on !CHAIN_OF_TRUST && SPI
296 default y if ARMADA_XP
297 default y if INTEL_BAYTRAIL
298 default y if INTEL_BRASWELL
299 default y if INTEL_BROADWELL
300 default y if NORTHBRIDGE_INTEL_IVYBRIDGE
301 default y if INTEL_QUARK
302 default y if INTEL_QUEENSBAY
304 Define this if you have a SPI Flash memory device which you
305 want to use for the environment.
310 These two #defines specify the offset and size of the
311 environment area within the SPI Flash. CONFIG_ENV_OFFSET must be
312 aligned to an erase sector boundary.
314 - CONFIG_ENV_SECT_SIZE:
316 Define the SPI flash's sector size.
318 - CONFIG_ENV_OFFSET_REDUND (optional):
320 This setting describes a second storage area of CONFIG_ENV_SIZE
321 size used to hold a redundant copy of the environment data, so
322 that there is a valid backup copy in case there is a power failure
323 during a "saveenv" operation. CONFIG_ENV_OFFSET_REDUND must be
324 aligned to an erase sector boundary.
326 config USE_ENV_SPI_BUS
327 bool "SPI flash bus for environment"
328 depends on ENV_IS_IN_SPI_FLASH
330 Force the SPI bus for environment.
331 If not defined, use CONFIG_SF_DEFAULT_BUS.
334 int "Value of SPI flash bus for environment"
335 depends on USE_ENV_SPI_BUS
337 Value the SPI bus and chip select for environment.
339 config USE_ENV_SPI_CS
340 bool "SPI flash chip select for environment"
341 depends on ENV_IS_IN_SPI_FLASH
343 Force the SPI chip select for environment.
344 If not defined, use CONFIG_SF_DEFAULT_CS.
347 int "Value of SPI flash chip select for environment"
348 depends on USE_ENV_SPI_CS
350 Value of the SPI chip select for environment.
352 config USE_ENV_SPI_MAX_HZ
353 bool "SPI flash max frequency for environment"
354 depends on ENV_IS_IN_SPI_FLASH
356 Force the SPI max work clock for environment.
357 If not defined, use CONFIG_SF_DEFAULT_SPEED.
359 config ENV_SPI_MAX_HZ
360 int "Value of SPI flash max frequency for environment"
361 depends on USE_ENV_SPI_MAX_HZ
363 Value of the SPI max work clock for environment.
365 config USE_ENV_SPI_MODE
366 bool "SPI flash mode for environment"
367 depends on ENV_IS_IN_SPI_FLASH
369 Force the SPI work mode for environment.
372 hex "Value of SPI flash work mode for environment"
373 depends on USE_ENV_SPI_MODE
375 Value of the SPI work mode for environment.
376 See include/spi.h for value.
379 bool "Environment in a UBI volume"
380 depends on !CHAIN_OF_TRUST
384 Define this if you have an UBI volume that you want to use for the
385 environment. This has the benefit of wear-leveling the environment
386 accesses, which is important on NAND.
388 - CONFIG_ENV_UBI_PART:
390 Define this to a string that is the mtd partition containing the UBI.
392 - CONFIG_ENV_UBI_VOLUME:
394 Define this to the name of the volume that you want to store the
397 - CONFIG_ENV_UBI_VOLUME_REDUND:
399 Define this to the name of another volume to store a second copy of
400 the environment in. This will enable redundant environments in UBI.
401 It is assumed that both volumes are in the same MTD partition.
403 config SYS_REDUNDAND_ENVIRONMENT
404 bool "Enable redundant environment support"
405 depends on ENV_IS_IN_EEPROM || ENV_IS_IN_FLASH || ENV_IS_IN_MMC || \
406 ENV_IS_IN_NAND || ENV_IS_IN_SPI_FLASH || ENV_IS_IN_UBI
408 Normally, the environemt is stored in a single location. By
409 selecting this option, you can then define where to hold a redundant
410 copy of the environment data, so that there is a valid backup copy in
411 case there is a power failure during a "saveenv" operation.
413 config ENV_FAT_INTERFACE
414 string "Name of the block device for the environment"
415 depends on ENV_IS_IN_FAT
418 Define this to a string that is the name of the block device.
420 config ENV_FAT_DEVICE_AND_PART
421 string "Device and partition for where to store the environemt in FAT"
422 depends on ENV_IS_IN_FAT
423 default "0:1" if TI_COMMON_CMD_OPTIONS
424 default "0:auto" if ARCH_ZYNQMP
425 default "0:auto" if ARCH_SUNXI && MMC_SUNXI_SLOT_EXTRA = -1
426 default "1:auto" if ARCH_SUNXI && MMC_SUNXI_SLOT_EXTRA != -1
427 default "0" if ARCH_AT91
429 Define this to a string to specify the partition of the device. It can
432 "D:P", "D:0", "D", "D:" or "D:auto" (D, P are integers. And P >= 1)
433 - "D:P": device D partition P. Error occurs if device D has no
436 - "D" or "D:": device D partition 1 if device D has partition
437 table, or the whole device D if has no partition
439 - "D:auto": first partition in device D with bootable flag set.
440 If none, first valid partition in device D. If no
441 partition table then means device D.
443 If ENV_FAT_INTERFACE is set to "mmc" then device 'D' can be omitted,
444 leaving the string starting with a colon, and the boot device will
448 string "Name of the FAT file to use for the environment"
449 depends on ENV_IS_IN_FAT
452 It's a string of the FAT file name. This file use to store the
455 config ENV_EXT4_INTERFACE
456 string "Name of the block device for the environment"
457 depends on ENV_IS_IN_EXT4
459 Define this to a string that is the name of the block device.
461 config ENV_EXT4_DEVICE_AND_PART
462 string "Device and partition for where to store the environemt in EXT4"
463 depends on ENV_IS_IN_EXT4
465 Define this to a string to specify the partition of the device. It can
468 "D:P", "D:0", "D", "D:" or "D:auto" (D, P are integers. And P >= 1)
469 - "D:P": device D partition P. Error occurs if device D has no
472 - "D" or "D:": device D partition 1 if device D has partition
473 table, or the whole device D if has no partition
475 - "D:auto": first partition in device D with bootable flag set.
476 If none, first valid partition in device D. If no
477 partition table then means device D.
480 string "Name of the EXT4 file to use for the environment"
481 depends on ENV_IS_IN_EXT4
484 It's a string of the EXT4 file name. This file use to store the
485 environment (explicit path to the file)
488 hex "Environment address"
489 depends on ENV_IS_IN_FLASH || ENV_IS_IN_NVRAM || ENV_IS_IN_ONENAND || \
490 ENV_IS_IN_REMOTE || ENV_IS_IN_SPI_FLASH
491 default 0x0 if ENV_IS_IN_SPI_FLASH
493 Offset from the start of the device (or partition)
495 config ENV_ADDR_REDUND
496 hex "Redundant environment address"
497 depends on ENV_IS_IN_FLASH && SYS_REDUNDAND_ENVIRONMENT
499 Offset from the start of the device (or partition) of the redundant
500 environment location.
503 hex "Environment offset"
504 depends on ENV_IS_IN_EEPROM || ENV_IS_IN_MMC || ENV_IS_IN_NAND || \
506 default 0x3f8000 if ARCH_ROCKCHIP && ENV_IS_IN_MMC
507 default 0x140000 if ARCH_ROCKCHIP && ENV_IS_IN_SPI_FLASH
508 default 0x88000 if ARCH_SUNXI
509 default 0xE0000 if ARCH_ZYNQ
510 default 0x1E00000 if ARCH_ZYNQMP
511 default 0x7F40000 if ARCH_VERSAL
513 default 0x140000 if ARCH_AT91
514 default 0x260000 if ARCH_OMAP2PLUS
515 default 0x1080000 if MICROBLAZE && ENV_IS_IN_SPI_FLASH
517 Offset from the start of the device (or partition)
519 config ENV_OFFSET_REDUND
520 hex "Redundant environment offset"
521 depends on (ENV_IS_IN_EEPROM || ENV_IS_IN_MMC || ENV_IS_IN_NAND || \
522 ENV_IS_IN_SPI_FLASH) && SYS_REDUNDAND_ENVIRONMENT
524 Offset from the start of the device (or partition) of the redundant
525 environment location.
528 hex "Environment Size"
529 default 0x40000 if ENV_IS_IN_SPI_FLASH && ARCH_ZYNQMP
530 default 0x20000 if ARCH_SUNXI || ARCH_ZYNQ || ARCH_OMAP2PLUS || ARCH_AT91
531 default 0x8000 if ARCH_ROCKCHIP && ENV_IS_IN_MMC
532 default 0x2000 if ARCH_ROCKCHIP && ENV_IS_IN_SPI_FLASH
533 default 0x8000 if ARCH_ZYNQMP || ARCH_VERSAL
534 default 0x4000 if ARC
537 Size of the environment storage area
540 hex "Environment Sector-Size"
541 depends on ENV_IS_IN_FLASH || ENV_IS_IN_SPI_FLASH
542 default 0x2000 if ARCH_ROCKCHIP
543 default 0x40000 if ARCH_ZYNQMP || ARCH_VERSAL
544 default 0x20000 if ARCH_ZYNQ || ARCH_OMAP2PLUS || ARCH_AT91
545 default 0x20000 if MICROBLAZE && ENV_IS_IN_SPI_FLASH
547 Size of the sector containing the environment.
550 string "UBI partition name"
551 depends on ENV_IS_IN_UBI
553 MTD partition containing the UBI device
555 config ENV_UBI_VOLUME
556 string "UBI volume name"
557 depends on ENV_IS_IN_UBI
559 Name of the volume that you want to store the environment in.
561 config ENV_UBI_VOLUME_REDUND
562 string "UBI redundant volume name"
563 depends on ENV_IS_IN_UBI && SYS_REDUNDAND_ENVIRONMENT
565 Name of the redundant volume that you want to store the environment in.
567 config ENV_UBI_VID_OFFSET
568 int "ubi environment VID offset"
569 depends on ENV_IS_IN_UBI
572 UBI VID offset for environment. If 0, no custom VID offset is used.
574 config SYS_RELOC_GD_ENV_ADDR
575 bool "Relocate gd->env_addr"
577 Relocate the early env_addr pointer so we know it is not inside
578 the binary. Some systems need this and for the rest, it doesn't hurt.
580 config USE_DEFAULT_ENV_FILE
581 bool "Create default environment from file"
583 Normally, the default environment is automatically generated
584 based on the settings of various CONFIG_* options, as well
585 as the CONFIG_EXTRA_ENV_SETTINGS. By selecting this option,
586 you can instead define the entire default environment in an
589 config DEFAULT_ENV_FILE
590 string "Path to default environment file"
591 depends on USE_DEFAULT_ENV_FILE
593 The path containing the default environment. The format is
594 the same as accepted by the mkenvimage tool: lines
595 containing key=value pairs, blank lines and lines beginning
598 config ENV_VARS_UBOOT_RUNTIME_CONFIG
599 bool "Add run-time information to the environment"
601 Enable this in order to add variables describing certain
602 run-time determined information about the hardware to the
603 environment. These will be named board_name, board_rev.
605 config DELAY_ENVIRONMENT
606 bool "Delay environment loading"
607 depends on !OF_CONTROL
609 Enable this to inhibit loading the environment during board
610 initialization. This can address the security risk of untrusted data
611 being used during boot. Normally the environment is loaded when the
612 board is initialised so that it is available to U-Boot. This inhibits
613 that so that the environment is not available until explicitly loaded
614 later by U-Boot code. With CONFIG_OF_CONTROL this is instead
615 controlled by the value of /config/load-environment.
617 config ENV_ACCESS_IGNORE_FORCE
618 bool "Block forced environment operations"
621 If defined, don't allow the -f switch to env set override variable
625 config SPL_ENV_IS_NOWHERE
626 bool "SPL Environment is not stored"
627 default y if ENV_IS_NOWHERE
629 Similar to ENV_IS_NOWHERE, used for SPL environment.
631 config SPL_ENV_IS_IN_MMC
632 bool "SPL Environment in an MMC device"
633 depends on !SPL_ENV_IS_NOWHERE
634 depends on ENV_IS_IN_MMC
637 Similar to ENV_IS_IN_MMC, used for SPL environment.
639 config SPL_ENV_IS_IN_FAT
640 bool "SPL Environment is in a FAT filesystem"
641 depends on !SPL_ENV_IS_NOWHERE
642 depends on ENV_IS_IN_FAT
645 Similar to ENV_IS_IN_FAT, used for SPL environment.
647 config SPL_ENV_IS_IN_EXT4
648 bool "SPL Environment is in a EXT4 filesystem"
649 depends on !SPL_ENV_IS_NOWHERE
650 depends on ENV_IS_IN_EXT4
653 Similar to ENV_IS_IN_EXT4, used for SPL environment.
655 config SPL_ENV_IS_IN_NAND
656 bool "SPL Environment in a NAND device"
657 depends on !SPL_ENV_IS_NOWHERE
658 depends on ENV_IS_IN_NAND
661 Similar to ENV_IS_IN_NAND, used for SPL environment.
663 config SPL_ENV_IS_IN_SPI_FLASH
664 bool "SPL Environment is in SPI flash"
665 depends on !SPL_ENV_IS_NOWHERE
666 depends on ENV_IS_IN_SPI_FLASH
669 Similar to ENV_IS_IN_SPI_FLASH, used for SPL environment.
671 config SPL_ENV_IS_IN_FLASH
672 bool "SPL Environment in flash memory"
673 depends on !SPL_ENV_IS_NOWHERE
674 depends on ENV_IS_IN_FLASH
677 Similar to ENV_IS_IN_FLASH, used for SPL environment.
683 config TPL_ENV_IS_NOWHERE
684 bool "TPL Environment is not stored"
685 default y if ENV_IS_NOWHERE
687 Similar to ENV_IS_NOWHERE, used for TPL environment.
689 config TPL_ENV_IS_IN_MMC
690 bool "TPL Environment in an MMC device"
691 depends on !TPL_ENV_IS_NOWHERE
692 depends on ENV_IS_IN_MMC
695 Similar to ENV_IS_IN_MMC, used for TPL environment.
697 config TPL_ENV_IS_IN_FAT
698 bool "TPL Environment is in a FAT filesystem"
699 depends on !TPL_ENV_IS_NOWHERE
700 depends on ENV_IS_IN_FAT
703 Similar to ENV_IS_IN_FAT, used for TPL environment.
705 config TPL_ENV_IS_IN_EXT4
706 bool "TPL Environment is in a EXT4 filesystem"
707 depends on !TPL_ENV_IS_NOWHERE
708 depends on ENV_IS_IN_EXT4
711 Similar to ENV_IS_IN_EXT4, used for TPL environment.
713 config TPL_ENV_IS_IN_NAND
714 bool "TPL Environment in a NAND device"
715 depends on !TPL_ENV_IS_NOWHERE
716 depends on ENV_IS_IN_NAND
719 Similar to ENV_IS_IN_NAND, used for TPL environment.
721 config TPL_ENV_IS_IN_SPI_FLASH
722 bool "TPL Environment is in SPI flash"
723 depends on !TPL_ENV_IS_NOWHERE
724 depends on ENV_IS_IN_SPI_FLASH
727 Similar to ENV_IS_IN_SPI_FLASH, used for TPL environment.
729 config TPL_ENV_IS_IN_FLASH
730 bool "TPL Environment in flash memory"
731 depends on !TPL_ENV_IS_NOWHERE
732 depends on ENV_IS_IN_FLASH
735 Similar to ENV_IS_IN_FLASH, used for TPL environment.