4 bool "Environment is not stored"
5 depends on !ENV_IS_IN_EEPROM
6 depends on !ENV_IS_IN_EXT4
7 depends on !ENV_IS_IN_FAT
8 depends on !ENV_IS_IN_FLASH
9 depends on !ENV_IS_IN_MMC
10 depends on !ENV_IS_IN_NAND
11 depends on !ENV_IS_IN_NVRAM
12 depends on !ENV_IS_IN_ONENAND
13 depends on !ENV_IS_IN_REMOTE
14 depends on !ENV_IS_IN_SPI_FLASH
15 depends on !ENV_IS_IN_UBI
18 Define this if you don't want to or can't have an environment stored
19 on a storage medium. In this case the environment will still exist
20 while U-Boot is running, but once U-Boot exits it will not be
21 stored. U-Boot will therefore always start up with a default
24 config ENV_IS_IN_EEPROM
25 bool "Environment in EEPROM"
26 depends on !CHAIN_OF_TRUST
28 Use this if you have an EEPROM or similar serial access
29 device and a driver for it.
34 These two #defines specify the offset and size of the
35 environment area within the total memory of your EEPROM.
37 Note that we consider the length of the address field to
38 still be one byte because the extra address bits are hidden
41 - CONFIG_ENV_EEPROM_IS_ON_I2C
42 define this, if you have I2C and SPI activated, and your
43 EEPROM, which holds the environment, is on the I2C bus.
45 - CONFIG_I2C_ENV_EEPROM_BUS
46 if you have an Environment on an EEPROM reached over
47 I2C muxes, you can define here, how to reach this
50 #define CONFIG_I2C_ENV_EEPROM_BUS 1
52 EEPROM which holds the environment, is reached over
53 a pca9547 i2c mux with address 0x70, channel 3.
56 bool "Environment is in a FAT filesystem"
57 depends on !CHAIN_OF_TRUST
58 default y if ARCH_BCM283X
59 default y if ARCH_SUNXI && MMC
60 default y if MMC_OMAP_HS && TI_COMMON_CMD_OPTIONS
64 Define this if you want to use the FAT file system for the environment.
67 bool "Environment is in a EXT4 filesystem"
68 depends on !CHAIN_OF_TRUST
71 Define this if you want to use the EXT4 file system for the environment.
73 config ENV_IS_IN_FLASH
74 bool "Environment in flash memory"
75 depends on !CHAIN_OF_TRUST
76 default y if ARCH_CINTEGRATOR
77 default y if ARCH_INTEGRATOR_CP
78 default y if M548x || M547x || M5282 || MCF547x_8x
79 default y if MCF532x || MCF52x2
80 default y if MPC86xx || MPC83xx
81 default y if ARCH_MPC8572 || ARCH_MPC8548 || ARCH_MPC8641
82 default y if SH && !CPU_SH4
84 Define this if you have a flash device which you want to use for the
87 a) The environment occupies one whole flash sector, which is
88 "embedded" in the text segment with the U-Boot code. This
89 happens usually with "bottom boot sector" or "top boot
90 sector" type flash chips, which have several smaller
91 sectors at the start or the end. For instance, such a
92 layout can have sector sizes of 8, 2x4, 16, Nx32 kB. In
93 such a case you would place the environment in one of the
94 4 kB sectors - with U-Boot code before and after it. With
95 "top boot sector" type flash chips, you would put the
96 environment in one of the last sectors, leaving a gap
97 between U-Boot and the environment.
101 Offset of environment data (variable area) to the
102 beginning of flash memory; for instance, with bottom boot
103 type flash chips the second sector can be used: the offset
104 for this sector is given here.
106 CONFIG_ENV_OFFSET is used relative to CONFIG_SYS_FLASH_BASE.
110 This is just another way to specify the start address of
111 the flash sector containing the environment (instead of
114 CONFIG_ENV_SECT_SIZE:
116 Size of the sector containing the environment.
119 b) Sometimes flash chips have few, equal sized, BIG sectors.
120 In such a case you don't want to spend a whole sector for
125 If you use this in combination with CONFIG_ENV_IS_IN_FLASH
126 and CONFIG_ENV_SECT_SIZE, you can specify to use only a part
127 of this flash sector for the environment. This saves
128 memory for the RAM copy of the environment.
130 It may also save flash memory if you decide to use this
131 when your environment is "embedded" within U-Boot code,
132 since then the remainder of the flash sector could be used
133 for U-Boot code. It should be pointed out that this is
134 STRONGLY DISCOURAGED from a robustness point of view:
135 updating the environment in flash makes it always
136 necessary to erase the WHOLE sector. If something goes
137 wrong before the contents has been restored from a copy in
138 RAM, your target system will be dead.
140 CONFIG_ENV_ADDR_REDUND
141 CONFIG_ENV_SIZE_REDUND
143 These settings describe a second storage area used to hold
144 a redundant copy of the environment data, so that there is
145 a valid backup copy in case there is a power failure during
146 a "saveenv" operation.
148 BE CAREFUL! Any changes to the flash layout, and some changes to the
149 source code will make it necessary to adapt <board>/u-boot.lds*
153 bool "Environment in an MMC device"
154 depends on !CHAIN_OF_TRUST
156 default y if ARCH_EXYNOS4
157 default y if MX6SX || MX7D
158 default y if TEGRA30 || TEGRA124
159 default y if TEGRA_ARMV8_COMMON
161 Define this if you have an MMC device which you want to use for the
164 CONFIG_SYS_MMC_ENV_DEV:
166 Specifies which MMC device the environment is stored in.
168 CONFIG_SYS_MMC_ENV_PART (optional):
170 Specifies which MMC partition the environment is stored in. If not
171 set, defaults to partition 0, the user area. Common values might be
172 1 (first MMC boot partition), 2 (second MMC boot partition).
177 These two #defines specify the offset and size of the environment
178 area within the specified MMC device.
180 If offset is positive (the usual case), it is treated as relative to
181 the start of the MMC partition. If offset is negative, it is treated
182 as relative to the end of the MMC partition. This can be useful if
183 your board may be fitted with different MMC devices, which have
184 different sizes for the MMC partitions, and you always want the
185 environment placed at the very end of the partition, to leave the
186 maximum possible space before it, to store other data.
188 These two values are in units of bytes, but must be aligned to an
191 CONFIG_ENV_OFFSET_REDUND (optional):
193 Specifies a second storage area, of CONFIG_ENV_SIZE size, used to
194 hold a redundant copy of the environment data. This provides a
195 valid backup copy in case the other copy is corrupted, e.g. due
196 to a power failure during a "saveenv" operation.
198 This value may also be positive or negative; this is handled in the
199 same way as CONFIG_ENV_OFFSET.
201 This value is also in units of bytes, but must also be aligned to
202 an MMC sector boundary.
204 CONFIG_ENV_SIZE_REDUND (optional):
206 This value need not be set, even when CONFIG_ENV_OFFSET_REDUND is
207 set. If this value is set, it must be set to the same value as
210 config ENV_IS_IN_NAND
211 bool "Environment in a NAND device"
212 depends on !CHAIN_OF_TRUST
214 Define this if you have a NAND device which you want to use for the
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.
224 - CONFIG_ENV_OFFSET_REDUND (optional):
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.
232 - CONFIG_ENV_RANGE (optional):
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.
240 - CONFIG_ENV_OFFSET_OOB (optional):
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.
248 config ENV_IS_IN_NVRAM
249 bool "Environment in a non-volatile RAM"
250 depends on !CHAIN_OF_TRUST
252 Define this if you have some non-volatile memory device
253 (NVRAM, battery buffered SRAM) which you want to use for the
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
264 config ENV_IS_IN_ONENAND
265 bool "Environment is in OneNAND"
266 depends on !CHAIN_OF_TRUST
268 Define this if you want to put your local device's environment in
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
279 config ENV_IS_IN_REMOTE
280 bool "Environment is in remote memory space"
281 depends on !CHAIN_OF_TRUST
283 Define this if you have a remote memory space which you
284 want to use for the local device's environment.
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.
294 config ENV_IS_IN_SPI_FLASH
295 bool "Environment is in SPI flash"
296 depends on !CHAIN_OF_TRUST
297 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
305 Define this if you have a SPI Flash memory device which you
306 want to use for the environment.
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.
315 - CONFIG_ENV_SECT_SIZE:
317 Define the SPI flash's sector size.
319 - CONFIG_ENV_OFFSET_REDUND (optional):
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.
327 - CONFIG_ENV_SPI_BUS (optional):
328 - CONFIG_ENV_SPI_CS (optional):
330 Define the SPI bus and chip select. If not defined they will be 0.
332 - CONFIG_ENV_SPI_MAX_HZ (optional):
334 Define the SPI max work clock. If not defined then use 1MHz.
336 - CONFIG_ENV_SPI_MODE (optional):
338 Define the SPI work mode. If not defined then use SPI_MODE_3.
341 bool "Environment in a UBI volume"
342 depends on !CHAIN_OF_TRUST
344 Define this if you have an UBI volume that you want to use for the
345 environment. This has the benefit of wear-leveling the environment
346 accesses, which is important on NAND.
348 - CONFIG_ENV_UBI_PART:
350 Define this to a string that is the mtd partition containing the UBI.
352 - CONFIG_ENV_UBI_VOLUME:
354 Define this to the name of the volume that you want to store the
357 - CONFIG_ENV_UBI_VOLUME_REDUND:
359 Define this to the name of another volume to store a second copy of
360 the environment in. This will enable redundant environments in UBI.
361 It is assumed that both volumes are in the same MTD partition.
363 config ENV_FAT_INTERFACE
364 string "Name of the block device for the environment"
365 depends on ENV_IS_IN_FAT
366 default "mmc" if ARCH_SUNXI
367 default "mmc" if TI_COMMON_CMD_OPTIONS || ARCH_ZYNQMP || ARCH_AT91
369 Define this to a string that is the name of the block device.
371 config ENV_FAT_DEVICE_AND_PART
372 string "Device and partition for where to store the environemt in FAT"
373 depends on ENV_IS_IN_FAT
374 default "0:1" if TI_COMMON_CMD_OPTIONS
375 default "0:auto" if ARCH_ZYNQMP
376 default "0:auto" if ARCH_SUNXI && MMC_SUNXI_SLOT_EXTRA = -1
377 default "1:auto" if ARCH_SUNXI && MMC_SUNXI_SLOT_EXTRA != -1
378 default "0" if ARCH_AT91
380 Define this to a string to specify the partition of the device. It can
383 "D:P", "D:0", "D", "D:" or "D:auto" (D, P are integers. And P >= 1)
384 - "D:P": device D partition P. Error occurs if device D has no
387 - "D" or "D:": device D partition 1 if device D has partition
388 table, or the whole device D if has no partition
390 - "D:auto": first partition in device D with bootable flag set.
391 If none, first valid partition in device D. If no
392 partition table then means device D.
395 string "Name of the FAT file to use for the environment"
396 depends on ENV_IS_IN_FAT
399 It's a string of the FAT file name. This file use to store the
402 config ENV_EXT4_INTERFACE
403 string "Name of the block device for the environment"
404 depends on ENV_IS_IN_EXT4
406 Define this to a string that is the name of the block device.
408 config ENV_EXT4_DEVICE_AND_PART
409 string "Device and partition for where to store the environemt in EXT4"
410 depends on ENV_IS_IN_EXT4
412 Define this to a string to specify the partition of the device. It can
415 "D:P", "D:0", "D", "D:" or "D:auto" (D, P are integers. And P >= 1)
416 - "D:P": device D partition P. Error occurs if device D has no
419 - "D" or "D:": device D partition 1 if device D has partition
420 table, or the whole device D if has no partition
422 - "D:auto": first partition in device D with bootable flag set.
423 If none, first valid partition in device D. If no
424 partition table then means device D.
427 string "Name of the EXT4 file to use for the environment"
428 depends on ENV_IS_IN_EXT4
431 It's a string of the EXT4 file name. This file use to store the
432 environment (explicit path to the file)
437 hex "Environment Offset"
438 depends on !ENV_IS_IN_UBI
439 depends on !ENV_IS_NOWHERE
440 default 0x88000 if ARCH_SUNXI
442 Offset from the start of the device (or partition)
445 hex "Environment Size"
446 depends on !ENV_IS_NOWHERE
447 default 0x20000 if ARCH_SUNXI
449 Size of the environment storage area
452 string "UBI partition name"
453 depends on ENV_IS_IN_UBI
455 MTD partition containing the UBI device
457 config ENV_UBI_VOLUME
458 string "UBI volume name"
459 depends on ENV_IS_IN_UBI
461 Name of the volume that you want to store the environment in.
469 depends on !ENV_IS_IN_UBI
470 depends on !ENV_IS_NOWHERE
473 Offset from the start of the device (or partition)
479 Size of the environment storage area
483 if ARCH_ZYNQMP || ARCH_ZYNQ
486 hex "Environment Offset"
487 depends on !ENV_IS_NOWHERE
488 default 0x1E00000 if ARCH_ZYNQMP
489 default 0xE0000 if ARCH_ZYNQ
491 Offset from the start of the device (or partition)
494 hex "Environment Size"
495 default 0x40000 if ENV_IS_IN_SPI_FLASH && ARCH_ZYNQMP
496 default 0x8000 if ARCH_ZYNQMP
497 default 0x20000 if ARCH_ZYNQ
499 Size of the environment storage area.
502 hex "Environment Sector-Size"
503 depends on !ENV_IS_NOWHERE
504 default 0x40000 if ARCH_ZYNQMP
505 default 0x20000 if ARCH_ZYNQ
507 Size of the sector containing the environment.
511 config USE_DEFAULT_ENV_FILE
512 bool "Create default environment from file"
514 Normally, the default environment is automatically generated
515 based on the settings of various CONFIG_* options, as well
516 as the CONFIG_EXTRA_ENV_SETTINGS. By selecting this option,
517 you can instead define the entire default environment in an
520 config DEFAULT_ENV_FILE
521 string "Path to default environment file"
522 depends on USE_DEFAULT_ENV_FILE
524 The path containing the default environment. The format is
525 the same as accepted by the mkenvimage tool: lines
526 containing key=value pairs, blank lines and lines beginning
529 config ENV_VARS_UBOOT_RUNTIME_CONFIG
530 bool "Add run-time information to the environment"
532 Enable this in order to add variables describing certain
533 run-time determined information about the hardware to the
534 environment. These will be named board_name, board_rev.
537 config SPL_ENV_IS_NOWHERE
538 bool "SPL Environment is not stored"
539 default y if ENV_IS_NOWHERE
541 Similar to ENV_IS_NOWHERE, used for SPL environment.
543 config SPL_ENV_IS_IN_MMC
544 bool "SPL Environment in an MMC device"
545 depends on !SPL_ENV_IS_NOWHERE
546 depends on ENV_IS_IN_MMC
549 Similar to ENV_IS_IN_MMC, used for SPL environment.
551 config SPL_ENV_IS_IN_FAT
552 bool "SPL Environment is in a FAT filesystem"
553 depends on !SPL_ENV_IS_NOWHERE
554 depends on ENV_IS_IN_FAT
557 Similar to ENV_IS_IN_FAT, used for SPL environment.
559 config SPL_ENV_IS_IN_EXT4
560 bool "SPL Environment is in a EXT4 filesystem"
561 depends on !SPL_ENV_IS_NOWHERE
562 depends on ENV_IS_IN_EXT4
565 Similar to ENV_IS_IN_EXT4, used for SPL environment.
567 config SPL_ENV_IS_IN_NAND
568 bool "SPL Environment in a NAND device"
569 depends on !SPL_ENV_IS_NOWHERE
570 depends on ENV_IS_IN_NAND
573 Similar to ENV_IS_IN_NAND, used for SPL environment.
575 config SPL_ENV_IS_IN_SPI_FLASH
576 bool "SPL Environment is in SPI flash"
577 depends on !SPL_ENV_IS_NOWHERE
578 depends on ENV_IS_IN_SPI_FLASH
581 Similar to ENV_IS_IN_SPI_FLASH, used for SPL environment.
583 config SPL_ENV_IS_IN_FLASH
584 bool "SPL Environment in flash memory"
585 depends on !SPL_ENV_IS_NOWHERE
586 depends on ENV_IS_IN_FLASH
589 Similar to ENV_IS_IN_FLASH, used for SPL environment.
595 config TPL_ENV_IS_NOWHERE
596 bool "TPL Environment is not stored"
597 default y if ENV_IS_NOWHERE
599 Similar to ENV_IS_NOWHERE, used for TPL environment.
601 config TPL_ENV_IS_IN_MMC
602 bool "TPL Environment in an MMC device"
603 depends on !TPL_ENV_IS_NOWHERE
604 depends on ENV_IS_IN_MMC
607 Similar to ENV_IS_IN_MMC, used for TPL environment.
609 config TPL_ENV_IS_IN_FAT
610 bool "TPL Environment is in a FAT filesystem"
611 depends on !TPL_ENV_IS_NOWHERE
612 depends on ENV_IS_IN_FAT
615 Similar to ENV_IS_IN_FAT, used for TPL environment.
617 config TPL_ENV_IS_IN_EXT4
618 bool "TPL Environment is in a EXT4 filesystem"
619 depends on !TPL_ENV_IS_NOWHERE
620 depends on ENV_IS_IN_EXT4
623 Similar to ENV_IS_IN_EXT4, used for TPL environment.
625 config TPL_ENV_IS_IN_NAND
626 bool "TPL Environment in a NAND device"
627 depends on !TPL_ENV_IS_NOWHERE
628 depends on ENV_IS_IN_NAND
631 Similar to ENV_IS_IN_NAND, used for TPL environment.
633 config TPL_ENV_IS_IN_SPI_FLASH
634 bool "TPL Environment is in SPI flash"
635 depends on !TPL_ENV_IS_NOWHERE
636 depends on ENV_IS_IN_SPI_FLASH
639 Similar to ENV_IS_IN_SPI_FLASH, used for TPL environment.
641 config TPL_ENV_IS_IN_FLASH
642 bool "TPL Environment in flash memory"
643 depends on !TPL_ENV_IS_NOWHERE
644 depends on ENV_IS_IN_FLASH
647 Similar to ENV_IS_IN_FLASH, used for TPL environment.