1 menu "Environment" 2 3 config ENV_IS_NOWHERE 4 bool "Environment is not stored" 5 depends on !ENV_IS_IN_EEPROM 6 depends on !ENV_IS_IN_FAT 7 depends on !ENV_IS_IN_FLASH 8 depends on !ENV_IS_IN_MMC 9 depends on !ENV_IS_IN_NAND 10 depends on !ENV_IS_IN_NVRAM 11 depends on !ENV_IS_IN_ONENAND 12 depends on !ENV_IS_IN_REMOTE 13 depends on !ENV_IS_IN_SPI_FLASH 14 depends on !ENV_IS_IN_UBI 15 default y 16 help 17 Define this if you don't want to or can't have an environment stored 18 on a storage medium. In this case the environemnt will still exist 19 while U-Boot is running, but once U-Boot exits it will not be 20 stored. U-Boot will therefore always start up with a default 21 environment. 22 23 config ENV_IS_IN_EEPROM 24 bool "Environment in EEPROM" 25 depends on !CHAIN_OF_TRUST 26 help 27 Use this if you have an EEPROM or similar serial access 28 device and a driver for it. 29 30 - CONFIG_ENV_OFFSET: 31 - CONFIG_ENV_SIZE: 32 33 These two #defines specify the offset and size of the 34 environment area within the total memory of your EEPROM. 35 36 Note that we consider the length of the address field to 37 still be one byte because the extra address bits are hidden 38 in the chip address. 39 40 - CONFIG_ENV_EEPROM_IS_ON_I2C 41 define this, if you have I2C and SPI activated, and your 42 EEPROM, which holds the environment, is on the I2C bus. 43 44 - CONFIG_I2C_ENV_EEPROM_BUS 45 if you have an Environment on an EEPROM reached over 46 I2C muxes, you can define here, how to reach this 47 EEPROM. For example: 48 49 #define CONFIG_I2C_ENV_EEPROM_BUS 1 50 51 EEPROM which holds the environment, is reached over 52 a pca9547 i2c mux with address 0x70, channel 3. 53 54 config ENV_IS_IN_FAT 55 bool "Environment is in a FAT filesystem" 56 depends on !CHAIN_OF_TRUST 57 default y if ARCH_BCM283X 58 default y if ARCH_SUNXI && MMC 59 default y if MMC_OMAP_HS && TI_COMMON_CMD_OPTIONS 60 select FS_FAT 61 select FAT_WRITE 62 help 63 Define this if you want to use the FAT file system for the environment. 64 65 config ENV_IS_IN_EXT4 66 bool "Environment is in a EXT4 filesystem" 67 depends on !CHAIN_OF_TRUST 68 select EXT4_WRITE 69 help 70 Define this if you want to use the EXT4 file system for the environment. 71 72 config ENV_IS_IN_FLASH 73 bool "Environment in flash memory" 74 depends on !CHAIN_OF_TRUST 75 default y if ARCH_CINTEGRATOR 76 default y if ARCH_INTEGRATOR_CP 77 default y if M548x || M547x || M5282 || MCF547x_8x 78 default y if MCF532x || MCF52x2 79 default y if MPC86xx || MPC83xx 80 default y if ARCH_MPC8572 || ARCH_MPC8548 || ARCH_MPC8641 81 default y if SH && !CPU_SH4 82 help 83 Define this if you have a flash device which you want to use for the 84 environment. 85 86 a) The environment occupies one whole flash sector, which is 87 "embedded" in the text segment with the U-Boot code. This 88 happens usually with "bottom boot sector" or "top boot 89 sector" type flash chips, which have several smaller 90 sectors at the start or the end. For instance, such a 91 layout can have sector sizes of 8, 2x4, 16, Nx32 kB. In 92 such a case you would place the environment in one of the 93 4 kB sectors - with U-Boot code before and after it. With 94 "top boot sector" type flash chips, you would put the 95 environment in one of the last sectors, leaving a gap 96 between U-Boot and the environment. 97 98 CONFIG_ENV_OFFSET: 99 100 Offset of environment data (variable area) to the 101 beginning of flash memory; for instance, with bottom boot 102 type flash chips the second sector can be used: the offset 103 for this sector is given here. 104 105 CONFIG_ENV_OFFSET is used relative to CONFIG_SYS_FLASH_BASE. 106 107 CONFIG_ENV_ADDR: 108 109 This is just another way to specify the start address of 110 the flash sector containing the environment (instead of 111 CONFIG_ENV_OFFSET). 112 113 CONFIG_ENV_SECT_SIZE: 114 115 Size of the sector containing the environment. 116 117 118 b) Sometimes flash chips have few, equal sized, BIG sectors. 119 In such a case you don't want to spend a whole sector for 120 the environment. 121 122 CONFIG_ENV_SIZE: 123 124 If you use this in combination with CONFIG_ENV_IS_IN_FLASH 125 and CONFIG_ENV_SECT_SIZE, you can specify to use only a part 126 of this flash sector for the environment. This saves 127 memory for the RAM copy of the environment. 128 129 It may also save flash memory if you decide to use this 130 when your environment is "embedded" within U-Boot code, 131 since then the remainder of the flash sector could be used 132 for U-Boot code. It should be pointed out that this is 133 STRONGLY DISCOURAGED from a robustness point of view: 134 updating the environment in flash makes it always 135 necessary to erase the WHOLE sector. If something goes 136 wrong before the contents has been restored from a copy in 137 RAM, your target system will be dead. 138 139 CONFIG_ENV_ADDR_REDUND 140 CONFIG_ENV_SIZE_REDUND 141 142 These settings describe a second storage area used to hold 143 a redundant copy of the environment data, so that there is 144 a valid backup copy in case there is a power failure during 145 a "saveenv" operation. 146 147 BE CAREFUL! Any changes to the flash layout, and some changes to the 148 source code will make it necessary to adapt <board>/u-boot.lds* 149 accordingly! 150 151 config ENV_IS_IN_MMC 152 bool "Environment in an MMC device" 153 depends on !CHAIN_OF_TRUST 154 depends on MMC 155 default y if ARCH_SUNXI 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 160 help 161 Define this if you have an MMC device which you want to use for the 162 environment. 163 164 CONFIG_SYS_MMC_ENV_DEV: 165 166 Specifies which MMC device the environment is stored in. 167 168 CONFIG_SYS_MMC_ENV_PART (optional): 169 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). 173 174 CONFIG_ENV_OFFSET: 175 CONFIG_ENV_SIZE: 176 177 These two #defines specify the offset and size of the environment 178 area within the specified MMC device. 179 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. 187 188 These two values are in units of bytes, but must be aligned to an 189 MMC sector boundary. 190 191 CONFIG_ENV_OFFSET_REDUND (optional): 192 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. 197 198 This value may also be positive or negative; this is handled in the 199 same way as CONFIG_ENV_OFFSET. 200 201 This value is also in units of bytes, but must also be aligned to 202 an MMC sector boundary. 203 204 CONFIG_ENV_SIZE_REDUND (optional): 205 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 208 CONFIG_ENV_SIZE. 209 210 config 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 248 config 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 264 config 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 279 config ENV_IS_IN_REMOTE 280 bool "Environment is in remove memory space" 281 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 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 304 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 327 - CONFIG_ENV_SPI_BUS (optional): 328 - CONFIG_ENV_SPI_CS (optional): 329 330 Define the SPI bus and chip select. If not defined they will be 0. 331 332 - CONFIG_ENV_SPI_MAX_HZ (optional): 333 334 Define the SPI max work clock. If not defined then use 1MHz. 335 336 - CONFIG_ENV_SPI_MODE (optional): 337 338 Define the SPI work mode. If not defined then use SPI_MODE_3. 339 340 config ENV_IS_IN_UBI 341 bool "Environment in a UBI volume" 342 depends on !CHAIN_OF_TRUST 343 help 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. 347 348 - CONFIG_ENV_UBI_PART: 349 350 Define this to a string that is the mtd partition containing the UBI. 351 352 - CONFIG_ENV_UBI_VOLUME: 353 354 Define this to the name of the volume that you want to store the 355 environment in. 356 357 - CONFIG_ENV_UBI_VOLUME_REDUND: 358 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. 362 363 - CONFIG_UBI_SILENCE_MSG 364 - CONFIG_UBIFS_SILENCE_MSG 365 366 You will probably want to define these to avoid a really noisy system 367 when storing the env in UBI. 368 369 config ENV_FAT_INTERFACE 370 string "Name of the block device for the environment" 371 depends on ENV_IS_IN_FAT 372 default "mmc" if ARCH_SUNXI 373 default "mmc" if TI_COMMON_CMD_OPTIONS || ARCH_ZYNQMP || ARCH_AT91 374 help 375 Define this to a string that is the name of the block device. 376 377 config ENV_FAT_DEVICE_AND_PART 378 string "Device and partition for where to store the environemt in FAT" 379 depends on ENV_IS_IN_FAT 380 default "0:1" if TI_COMMON_CMD_OPTIONS 381 default "0:auto" if ARCH_ZYNQMP 382 default "0:auto" if ARCH_SUNXI && MMC_SUNXI_SLOT_EXTRA = -1 383 default "1:auto" if ARCH_SUNXI && MMC_SUNXI_SLOT_EXTRA != -1 384 default "0" if ARCH_AT91 385 help 386 Define this to a string to specify the partition of the device. It can 387 be as following: 388 389 "D:P", "D:0", "D", "D:" or "D:auto" (D, P are integers. And P >= 1) 390 - "D:P": device D partition P. Error occurs if device D has no 391 partition table. 392 - "D:0": device D. 393 - "D" or "D:": device D partition 1 if device D has partition 394 table, or the whole device D if has no partition 395 table. 396 - "D:auto": first partition in device D with bootable flag set. 397 If none, first valid partition in device D. If no 398 partition table then means device D. 399 400 config ENV_FAT_FILE 401 string "Name of the FAT file to use for the environemnt" 402 depends on ENV_IS_IN_FAT 403 default "uboot.env" 404 help 405 It's a string of the FAT file name. This file use to store the 406 environment. 407 408 config ENV_EXT4_INTERFACE 409 string "Name of the block device for the environment" 410 depends on ENV_IS_IN_EXT4 411 help 412 Define this to a string that is the name of the block device. 413 414 config ENV_EXT4_DEVICE_AND_PART 415 string "Device and partition for where to store the environemt in EXT4" 416 depends on ENV_IS_IN_EXT4 417 help 418 Define this to a string to specify the partition of the device. It can 419 be as following: 420 421 "D:P", "D:0", "D", "D:" or "D:auto" (D, P are integers. And P >= 1) 422 - "D:P": device D partition P. Error occurs if device D has no 423 partition table. 424 - "D:0": device D. 425 - "D" or "D:": device D partition 1 if device D has partition 426 table, or the whole device D if has no partition 427 table. 428 - "D:auto": first partition in device D with bootable flag set. 429 If none, first valid partition in device D. If no 430 partition table then means device D. 431 432 config ENV_EXT4_FILE 433 string "Name of the EXT4 file to use for the environemnt" 434 depends on ENV_IS_IN_EXT4 435 default "uboot.env" 436 help 437 It's a string of the EXT4 file name. This file use to store the 438 environment (explicit path to the file) 439 440 if ARCH_SUNXI 441 442 config ENV_OFFSET 443 hex "Environment Offset" 444 depends on !ENV_IS_IN_UBI 445 depends on !ENV_IS_NOWHERE 446 default 0x88000 if ARCH_SUNXI 447 help 448 Offset from the start of the device (or partition) 449 450 config ENV_SIZE 451 hex "Environment Size" 452 depends on !ENV_IS_NOWHERE 453 default 0x20000 if ARCH_SUNXI 454 help 455 Size of the environment storage area 456 457 config ENV_UBI_PART 458 string "UBI partition name" 459 depends on ENV_IS_IN_UBI 460 help 461 MTD partition containing the UBI device 462 463 config ENV_UBI_VOLUME 464 string "UBI volume name" 465 depends on ENV_IS_IN_UBI 466 help 467 Name of the volume that you want to store the environment in. 468 469 endif 470 471 if ARCH_ROCKCHIP 472 473 config ENV_OFFSET 474 hex 475 depends on !ENV_IS_IN_UBI 476 depends on !ENV_IS_NOWHERE 477 default 0x3f8000 478 help 479 Offset from the start of the device (or partition) 480 481 config ENV_SIZE 482 hex 483 default 0x8000 484 help 485 Size of the environment storage area 486 487 endif 488 489 endmenu 490