Simon Glass | 0649cd0 | 2017-08-03 12:21:49 -0600 | [diff] [blame] | 1 | menu "Environment" |
| 2 | |
Simon Glass | c1c3fe2 | 2017-08-03 12:21:59 -0600 | [diff] [blame] | 3 | choice |
| 4 | prompt "Select the location of the environment" |
| 5 | default ENV_IS_IN_MMC if ARCH_SUNXI |
Simon Glass | c1c3fe2 | 2017-08-03 12:21:59 -0600 | [diff] [blame] | 6 | default ENV_IS_IN_MMC if ARCH_EXYNOS4 |
| 7 | default ENV_IS_IN_MMC if MX6SX || MX7D |
Simon Glass | c1c3fe2 | 2017-08-03 12:21:59 -0600 | [diff] [blame] | 8 | default ENV_IS_IN_MMC if TEGRA30 || TEGRA124 |
| 9 | default ENV_IS_IN_MMC if TEGRA_ARMV8_COMMON |
Andy Shevchenko | e94c126 | 2017-08-18 13:14:47 +0300 | [diff] [blame] | 10 | default ENV_IS_IN_FLASH if ARCH_CINTEGRATOR |
Simon Glass | c1c3fe2 | 2017-08-03 12:21:59 -0600 | [diff] [blame] | 11 | default ENV_IS_IN_FLASH if ARCH_INTEGRATOR_CP |
| 12 | default ENV_IS_IN_FLASH if M548x || M547x || M5282 || MCF547x_8x |
| 13 | default ENV_IS_IN_FLASH if MCF532x || MCF52x2 |
| 14 | default ENV_IS_IN_FLASH if MPC86xx || MPC83xx |
| 15 | default ENV_IS_IN_FLASH if ARCH_MPC8572 || ARCH_MPC8548 || ARCH_MPC8641 |
| 16 | default ENV_IS_IN_FLASH if SH && !CPU_SH4 |
Andy Shevchenko | e94c126 | 2017-08-18 13:14:47 +0300 | [diff] [blame] | 17 | default ENV_IS_IN_SPI_FLASH if ARMADA_XP |
Simon Glass | c1c3fe2 | 2017-08-03 12:21:59 -0600 | [diff] [blame] | 18 | default ENV_IS_IN_SPI_FLASH if INTEL_BAYTRAIL |
Bin Meng | 3a85647 | 2017-10-18 18:20:54 -0700 | [diff] [blame] | 19 | default ENV_IS_IN_SPI_FLASH if INTEL_BRASWELL |
Simon Glass | c1c3fe2 | 2017-08-03 12:21:59 -0600 | [diff] [blame] | 20 | default ENV_IS_IN_SPI_FLASH if INTEL_BROADWELL |
| 21 | default ENV_IS_IN_SPI_FLASH if NORTHBRIDGE_INTEL_IVYBRIDGE |
| 22 | default ENV_IS_IN_SPI_FLASH if INTEL_QUARK |
| 23 | default ENV_IS_IN_SPI_FLASH if INTEL_QUEENSBAY |
Andy Shevchenko | e94c126 | 2017-08-18 13:14:47 +0300 | [diff] [blame] | 24 | default ENV_IS_IN_FAT if ARCH_BCM283X |
Simon Glass | c1c3fe2 | 2017-08-03 12:21:59 -0600 | [diff] [blame] | 25 | default ENV_IS_IN_FAT if MMC_OMAP_HS && TI_COMMON_CMD_OPTIONS |
| 26 | default ENV_IS_NOWHERE |
| 27 | help |
| 28 | At present the environment can be stored in only one place. Use this |
| 29 | option to select the location. This is either a device (where the |
| 30 | environemnt information is simply written to a fixed location or |
| 31 | partition on the device) or a filesystem (where the environment |
| 32 | information is written to a file). |
| 33 | |
| 34 | config ENV_IS_NOWHERE |
| 35 | bool "Environment is not stored" |
| 36 | help |
| 37 | Define this if you don't want to or can't have an environment stored |
| 38 | on a storage medium. In this case the environemnt will still exist |
| 39 | while U-Boot is running, but once U-Boot exits it will not be |
| 40 | stored. U-Boot will therefore always start up with a default |
| 41 | environment. |
| 42 | |
Simon Glass | 0649cd0 | 2017-08-03 12:21:49 -0600 | [diff] [blame] | 43 | config ENV_IS_IN_EEPROM |
| 44 | bool "Environment in EEPROM" |
| 45 | depends on !CHAIN_OF_TRUST |
| 46 | help |
| 47 | Use this if you have an EEPROM or similar serial access |
| 48 | device and a driver for it. |
| 49 | |
| 50 | - CONFIG_ENV_OFFSET: |
| 51 | - CONFIG_ENV_SIZE: |
| 52 | |
| 53 | These two #defines specify the offset and size of the |
| 54 | environment area within the total memory of your EEPROM. |
| 55 | |
Simon Glass | 0649cd0 | 2017-08-03 12:21:49 -0600 | [diff] [blame] | 56 | Note that we consider the length of the address field to |
| 57 | still be one byte because the extra address bits are hidden |
| 58 | in the chip address. |
| 59 | |
Simon Glass | 0649cd0 | 2017-08-03 12:21:49 -0600 | [diff] [blame] | 60 | - CONFIG_ENV_EEPROM_IS_ON_I2C |
| 61 | define this, if you have I2C and SPI activated, and your |
| 62 | EEPROM, which holds the environment, is on the I2C bus. |
| 63 | |
| 64 | - CONFIG_I2C_ENV_EEPROM_BUS |
| 65 | if you have an Environment on an EEPROM reached over |
| 66 | I2C muxes, you can define here, how to reach this |
| 67 | EEPROM. For example: |
| 68 | |
| 69 | #define CONFIG_I2C_ENV_EEPROM_BUS 1 |
| 70 | |
| 71 | EEPROM which holds the environment, is reached over |
| 72 | a pca9547 i2c mux with address 0x70, channel 3. |
| 73 | |
| 74 | config ENV_IS_IN_FAT |
| 75 | bool "Environment is in a FAT filesystem" |
| 76 | depends on !CHAIN_OF_TRUST |
| 77 | select FAT_WRITE |
| 78 | help |
Simon Glass | 91d3aa0 | 2017-08-03 12:21:50 -0600 | [diff] [blame] | 79 | Define this if you want to use the FAT file system for the environment. |
Simon Glass | 0649cd0 | 2017-08-03 12:21:49 -0600 | [diff] [blame] | 80 | |
Simon Glass | 91d3aa0 | 2017-08-03 12:21:50 -0600 | [diff] [blame] | 81 | - CONFIG_FAT_WRITE: |
| 82 | This must be enabled. Otherwise it cannot save the environment file. |
Simon Glass | 0649cd0 | 2017-08-03 12:21:49 -0600 | [diff] [blame] | 83 | |
| 84 | config ENV_IS_IN_FLASH |
| 85 | bool "Environment in flash memory" |
| 86 | depends on !CHAIN_OF_TRUST |
| 87 | help |
| 88 | Define this if you have a flash device which you want to use for the |
| 89 | environment. |
| 90 | |
| 91 | a) The environment occupies one whole flash sector, which is |
| 92 | "embedded" in the text segment with the U-Boot code. This |
| 93 | happens usually with "bottom boot sector" or "top boot |
| 94 | sector" type flash chips, which have several smaller |
| 95 | sectors at the start or the end. For instance, such a |
| 96 | layout can have sector sizes of 8, 2x4, 16, Nx32 kB. In |
| 97 | such a case you would place the environment in one of the |
| 98 | 4 kB sectors - with U-Boot code before and after it. With |
| 99 | "top boot sector" type flash chips, you would put the |
| 100 | environment in one of the last sectors, leaving a gap |
| 101 | between U-Boot and the environment. |
| 102 | |
| 103 | CONFIG_ENV_OFFSET: |
| 104 | |
| 105 | Offset of environment data (variable area) to the |
| 106 | beginning of flash memory; for instance, with bottom boot |
| 107 | type flash chips the second sector can be used: the offset |
| 108 | for this sector is given here. |
| 109 | |
| 110 | CONFIG_ENV_OFFSET is used relative to CONFIG_SYS_FLASH_BASE. |
| 111 | |
| 112 | CONFIG_ENV_ADDR: |
| 113 | |
| 114 | This is just another way to specify the start address of |
| 115 | the flash sector containing the environment (instead of |
| 116 | CONFIG_ENV_OFFSET). |
| 117 | |
| 118 | CONFIG_ENV_SECT_SIZE: |
| 119 | |
| 120 | Size of the sector containing the environment. |
| 121 | |
| 122 | |
| 123 | b) Sometimes flash chips have few, equal sized, BIG sectors. |
| 124 | In such a case you don't want to spend a whole sector for |
| 125 | the environment. |
| 126 | |
| 127 | CONFIG_ENV_SIZE: |
| 128 | |
| 129 | If you use this in combination with CONFIG_ENV_IS_IN_FLASH |
| 130 | and CONFIG_ENV_SECT_SIZE, you can specify to use only a part |
| 131 | of this flash sector for the environment. This saves |
| 132 | memory for the RAM copy of the environment. |
| 133 | |
| 134 | It may also save flash memory if you decide to use this |
| 135 | when your environment is "embedded" within U-Boot code, |
| 136 | since then the remainder of the flash sector could be used |
| 137 | for U-Boot code. It should be pointed out that this is |
| 138 | STRONGLY DISCOURAGED from a robustness point of view: |
| 139 | updating the environment in flash makes it always |
| 140 | necessary to erase the WHOLE sector. If something goes |
| 141 | wrong before the contents has been restored from a copy in |
| 142 | RAM, your target system will be dead. |
| 143 | |
| 144 | CONFIG_ENV_ADDR_REDUND |
| 145 | CONFIG_ENV_SIZE_REDUND |
| 146 | |
| 147 | These settings describe a second storage area used to hold |
| 148 | a redundant copy of the environment data, so that there is |
| 149 | a valid backup copy in case there is a power failure during |
| 150 | a "saveenv" operation. |
| 151 | |
| 152 | BE CAREFUL! Any changes to the flash layout, and some changes to the |
| 153 | source code will make it necessary to adapt <board>/u-boot.lds* |
| 154 | accordingly! |
| 155 | |
| 156 | config ENV_IS_IN_MMC |
| 157 | bool "Environment in an MMC device" |
| 158 | depends on !CHAIN_OF_TRUST |
Simon Glass | 0649cd0 | 2017-08-03 12:21:49 -0600 | [diff] [blame] | 159 | help |
| 160 | Define this if you have an MMC device which you want to use for the |
| 161 | environment. |
| 162 | |
| 163 | CONFIG_SYS_MMC_ENV_DEV: |
| 164 | |
| 165 | Specifies which MMC device the environment is stored in. |
| 166 | |
| 167 | CONFIG_SYS_MMC_ENV_PART (optional): |
| 168 | |
| 169 | Specifies which MMC partition the environment is stored in. If not |
| 170 | set, defaults to partition 0, the user area. Common values might be |
| 171 | 1 (first MMC boot partition), 2 (second MMC boot partition). |
| 172 | |
| 173 | CONFIG_ENV_OFFSET: |
| 174 | CONFIG_ENV_SIZE: |
| 175 | |
| 176 | These two #defines specify the offset and size of the environment |
| 177 | area within the specified MMC device. |
| 178 | |
| 179 | If offset is positive (the usual case), it is treated as relative to |
| 180 | the start of the MMC partition. If offset is negative, it is treated |
| 181 | as relative to the end of the MMC partition. This can be useful if |
| 182 | your board may be fitted with different MMC devices, which have |
| 183 | different sizes for the MMC partitions, and you always want the |
| 184 | environment placed at the very end of the partition, to leave the |
| 185 | maximum possible space before it, to store other data. |
| 186 | |
| 187 | These two values are in units of bytes, but must be aligned to an |
| 188 | MMC sector boundary. |
| 189 | |
| 190 | CONFIG_ENV_OFFSET_REDUND (optional): |
| 191 | |
| 192 | Specifies a second storage area, of CONFIG_ENV_SIZE size, used to |
| 193 | hold a redundant copy of the environment data. This provides a |
| 194 | valid backup copy in case the other copy is corrupted, e.g. due |
| 195 | to a power failure during a "saveenv" operation. |
| 196 | |
| 197 | This value may also be positive or negative; this is handled in the |
| 198 | same way as CONFIG_ENV_OFFSET. |
| 199 | |
| 200 | This value is also in units of bytes, but must also be aligned to |
| 201 | an MMC sector boundary. |
| 202 | |
| 203 | CONFIG_ENV_SIZE_REDUND (optional): |
| 204 | |
| 205 | This value need not be set, even when CONFIG_ENV_OFFSET_REDUND is |
| 206 | set. If this value is set, it must be set to the same value as |
| 207 | CONFIG_ENV_SIZE. |
| 208 | |
| 209 | config ENV_IS_IN_NAND |
| 210 | bool "Environment in a NAND device" |
| 211 | depends on !CHAIN_OF_TRUST |
| 212 | help |
| 213 | Define this if you have a NAND device which you want to use for the |
| 214 | environment. |
| 215 | |
| 216 | - CONFIG_ENV_OFFSET: |
| 217 | - CONFIG_ENV_SIZE: |
| 218 | |
| 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. |
| 222 | |
| 223 | - CONFIG_ENV_OFFSET_REDUND (optional): |
| 224 | |
| 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. |
| 230 | |
| 231 | - CONFIG_ENV_RANGE (optional): |
| 232 | |
| 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. |
| 238 | |
| 239 | - CONFIG_ENV_OFFSET_OOB (optional): |
| 240 | |
| 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. |
| 246 | |
| 247 | config ENV_IS_IN_NVRAM |
| 248 | bool "Environment in a non-volatile RAM" |
| 249 | depends on !CHAIN_OF_TRUST |
| 250 | help |
| 251 | Define this if you have some non-volatile memory device |
| 252 | (NVRAM, battery buffered SRAM) which you want to use for the |
| 253 | environment. |
| 254 | |
| 255 | - CONFIG_ENV_ADDR: |
| 256 | - CONFIG_ENV_SIZE: |
| 257 | |
| 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 |
| 261 | provision. |
| 262 | |
| 263 | config ENV_IS_IN_ONENAND |
| 264 | bool "Environment is in OneNAND" |
| 265 | depends on !CHAIN_OF_TRUST |
| 266 | help |
| 267 | Define this if you want to put your local device's environment in |
| 268 | OneNAND. |
| 269 | |
| 270 | - CONFIG_ENV_ADDR: |
| 271 | - CONFIG_ENV_SIZE: |
| 272 | |
| 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 |
| 276 | provision. |
| 277 | |
| 278 | config ENV_IS_IN_REMOTE |
| 279 | bool "Environment is in remove memory space" |
| 280 | depends on !CHAIN_OF_TRUST |
| 281 | help |
| 282 | Define this if you have a remote memory space which you |
| 283 | want to use for the local device's environment. |
| 284 | |
| 285 | - CONFIG_ENV_ADDR: |
| 286 | - CONFIG_ENV_SIZE: |
| 287 | |
| 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. |
| 292 | |
| 293 | config ENV_IS_IN_SPI_FLASH |
| 294 | bool "Environment is in SPI flash" |
| 295 | depends on !CHAIN_OF_TRUST |
| 296 | help |
| 297 | Define this if you have a SPI Flash memory device which you |
| 298 | want to use for the environment. |
| 299 | |
| 300 | - CONFIG_ENV_OFFSET: |
| 301 | - CONFIG_ENV_SIZE: |
| 302 | |
| 303 | These two #defines specify the offset and size of the |
| 304 | environment area within the SPI Flash. CONFIG_ENV_OFFSET must be |
| 305 | aligned to an erase sector boundary. |
| 306 | |
| 307 | - CONFIG_ENV_SECT_SIZE: |
| 308 | |
| 309 | Define the SPI flash's sector size. |
| 310 | |
| 311 | - CONFIG_ENV_OFFSET_REDUND (optional): |
| 312 | |
| 313 | This setting describes a second storage area of CONFIG_ENV_SIZE |
| 314 | size used to hold a redundant copy of the environment data, so |
| 315 | that there is a valid backup copy in case there is a power failure |
| 316 | during a "saveenv" operation. CONFIG_ENV_OFFSET_REDUND must be |
| 317 | aligned to an erase sector boundary. |
| 318 | |
| 319 | - CONFIG_ENV_SPI_BUS (optional): |
| 320 | - CONFIG_ENV_SPI_CS (optional): |
| 321 | |
| 322 | Define the SPI bus and chip select. If not defined they will be 0. |
| 323 | |
| 324 | - CONFIG_ENV_SPI_MAX_HZ (optional): |
| 325 | |
| 326 | Define the SPI max work clock. If not defined then use 1MHz. |
| 327 | |
| 328 | - CONFIG_ENV_SPI_MODE (optional): |
| 329 | |
| 330 | Define the SPI work mode. If not defined then use SPI_MODE_3. |
| 331 | |
| 332 | config ENV_IS_IN_UBI |
| 333 | bool "Environment in a UBI volume" |
| 334 | depends on !CHAIN_OF_TRUST |
| 335 | help |
| 336 | Define this if you have an UBI volume that you want to use for the |
| 337 | environment. This has the benefit of wear-leveling the environment |
| 338 | accesses, which is important on NAND. |
| 339 | |
| 340 | - CONFIG_ENV_UBI_PART: |
| 341 | |
| 342 | Define this to a string that is the mtd partition containing the UBI. |
| 343 | |
| 344 | - CONFIG_ENV_UBI_VOLUME: |
| 345 | |
| 346 | Define this to the name of the volume that you want to store the |
| 347 | environment in. |
| 348 | |
| 349 | - CONFIG_ENV_UBI_VOLUME_REDUND: |
| 350 | |
| 351 | Define this to the name of another volume to store a second copy of |
| 352 | the environment in. This will enable redundant environments in UBI. |
| 353 | It is assumed that both volumes are in the same MTD partition. |
| 354 | |
| 355 | - CONFIG_UBI_SILENCE_MSG |
| 356 | - CONFIG_UBIFS_SILENCE_MSG |
| 357 | |
| 358 | You will probably want to define these to avoid a really noisy system |
| 359 | when storing the env in UBI. |
| 360 | |
Simon Glass | c1c3fe2 | 2017-08-03 12:21:59 -0600 | [diff] [blame] | 361 | endchoice |
Simon Glass | 0649cd0 | 2017-08-03 12:21:49 -0600 | [diff] [blame] | 362 | |
Simon Glass | 0649cd0 | 2017-08-03 12:21:49 -0600 | [diff] [blame] | 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 TI_COMMON_CMD_OPTIONS || ARCH_ZYNQMP || ARCH_AT91 |
| 367 | help |
| 368 | Define this to a string that is the name of the block device. |
| 369 | |
| 370 | config ENV_FAT_DEVICE_AND_PART |
| 371 | string "Device and partition for where to store the environemt in FAT" |
| 372 | depends on ENV_IS_IN_FAT |
| 373 | default "0:1" if TI_COMMON_CMD_OPTIONS |
| 374 | default "0:auto" if ARCH_ZYNQMP |
| 375 | default "0" if ARCH_AT91 |
| 376 | help |
| 377 | Define this to a string to specify the partition of the device. It can |
| 378 | be as following: |
| 379 | |
| 380 | "D:P", "D:0", "D", "D:" or "D:auto" (D, P are integers. And P >= 1) |
| 381 | - "D:P": device D partition P. Error occurs if device D has no |
| 382 | partition table. |
| 383 | - "D:0": device D. |
| 384 | - "D" or "D:": device D partition 1 if device D has partition |
| 385 | table, or the whole device D if has no partition |
| 386 | table. |
| 387 | - "D:auto": first partition in device D with bootable flag set. |
| 388 | If none, first valid partition in device D. If no |
| 389 | partition table then means device D. |
| 390 | |
| 391 | config ENV_FAT_FILE |
| 392 | string "Name of the FAT file to use for the environemnt" |
| 393 | depends on ENV_IS_IN_FAT |
| 394 | default "uboot.env" |
| 395 | help |
| 396 | It's a string of the FAT file name. This file use to store the |
| 397 | environment. |
| 398 | |
| 399 | if ARCH_SUNXI |
| 400 | |
| 401 | config ENV_OFFSET |
| 402 | hex "Environment Offset" |
| 403 | depends on !ENV_IS_IN_UBI |
| 404 | depends on !ENV_IS_NOWHERE |
| 405 | default 0x88000 if ARCH_SUNXI |
| 406 | help |
| 407 | Offset from the start of the device (or partition) |
| 408 | |
| 409 | config ENV_SIZE |
| 410 | hex "Environment Size" |
| 411 | depends on !ENV_IS_NOWHERE |
| 412 | default 0x20000 if ARCH_SUNXI |
| 413 | help |
| 414 | Size of the environment storage area |
| 415 | |
| 416 | config ENV_UBI_PART |
| 417 | string "UBI partition name" |
| 418 | depends on ENV_IS_IN_UBI |
| 419 | help |
| 420 | MTD partition containing the UBI device |
| 421 | |
| 422 | config ENV_UBI_VOLUME |
| 423 | string "UBI volume name" |
| 424 | depends on ENV_IS_IN_UBI |
| 425 | help |
| 426 | Name of the volume that you want to store the environment in. |
| 427 | |
| 428 | endif |
| 429 | |
Klaus Goger | 81f53b0 | 2017-12-11 17:56:08 +0100 | [diff] [blame] | 430 | if ARCH_ROCKCHIP |
| 431 | |
| 432 | config ENV_OFFSET |
| 433 | hex |
| 434 | depends on !ENV_IS_IN_UBI |
| 435 | depends on !ENV_IS_NOWHERE |
| 436 | default 0x3f8000 |
| 437 | help |
| 438 | Offset from the start of the device (or partition) |
| 439 | |
| 440 | config ENV_SIZE |
| 441 | hex |
| 442 | default 0x8000 |
| 443 | help |
| 444 | Size of the environment storage area |
| 445 | |
| 446 | endif |
| 447 | |
Simon Glass | 0649cd0 | 2017-08-03 12:21:49 -0600 | [diff] [blame] | 448 | endmenu |