common/Kconfig.boot

   1 menu "Boot options"
   2
   3 menu "Boot images"
   4
   5 config ANDROID_BOOT_IMAGE
   6         bool "Enable support for Android Boot Images"
   7         default y if FASTBOOT
   8         help
   9           This enables support for booting images which use the Android
  10           image format header.
  11
  12 config FIT
  13         bool "Support Flattened Image Tree"
  14         select MD5
  15         select SHA1
  16         help
  17           This option allows you to boot the new uImage structure,
  18           Flattened Image Tree.  FIT is formally a FDT, which can include
  19           images of various types (kernel, FDT blob, ramdisk, etc.)
  20           in a single blob.  To boot this new uImage structure,
  21           pass the address of the blob to the "bootm" command.
  22           FIT is very flexible, supporting compression, multiple images,
  23           multiple configurations, verification through hashing and also
  24           verified boot (secure boot using RSA).
  25
  26 if FIT
  27
  28 config FIT_EXTERNAL_OFFSET
  29         hex "FIT external data offset"
  30         default 0x0
  31         help
  32           This specifies a data offset in fit image.
  33           The offset is from data payload offset to the beginning of
  34           fit image header. When specifies a offset, specific data
  35           could be put in the hole between data payload and fit image
  36           header, such as CSF data on i.MX platform.
  37
  38 config FIT_ENABLE_SHA256_SUPPORT
  39         bool "Support SHA256 checksum of FIT image contents"
  40         default y
  41         select SHA256
  42         help
  43           Enable this to support SHA256 checksum of FIT image contents. A
  44           SHA256 checksum is a 256-bit (32-byte) hash value used to check that
  45           the image contents have not been corrupted.
  46
  47 config FIT_ENABLE_SHA384_SUPPORT
  48         bool "Support SHA384 checksum of FIT image contents"
  49         default n
  50         select SHA384
  51         help
  52           Enable this to support SHA384 checksum of FIT image contents. A
  53           SHA384 checksum is a 384-bit (48-byte) hash value used to check that
  54           the image contents have not been corrupted. Use this for the highest
  55           security.
  56
  57 config FIT_ENABLE_SHA512_SUPPORT
  58         bool "Support SHA512 checksum of FIT image contents"
  59         default n
  60         select SHA512
  61         help
  62           Enable this to support SHA512 checksum of FIT image contents. A
  63           SHA512 checksum is a 512-bit (64-byte) hash value used to check that
  64           the image contents have not been corrupted.
  65
  66 config FIT_SIGNATURE
  67         bool "Enable signature verification of FIT uImages"
  68         depends on DM
  69         select HASH
  70         select RSA
  71         select RSA_VERIFY
  72         select IMAGE_SIGN_INFO
  73         help
  74           This option enables signature verification of FIT uImages,
  75           using a hash signed and verified using RSA. If
  76           CONFIG_SHA_PROG_HW_ACCEL is defined, i.e support for progressive
  77           hashing is available using hardware, then the RSA library will use
  78           it. See doc/uImage.FIT/signature.txt for more details.
  79
  80           WARNING: When relying on signed FIT images with a required signature
  81           check the legacy image format is disabled by default, so that
  82           unsigned images cannot be loaded. If a board needs the legacy image
  83           format support in this case, enable it using
  84           CONFIG_LEGACY_IMAGE_FORMAT.
  85
  86 config FIT_SIGNATURE_MAX_SIZE
  87         hex "Max size of signed FIT structures"
  88         depends on FIT_SIGNATURE
  89         default 0x10000000
  90         help
  91           This option sets a max size in bytes for verified FIT uImages.
  92           A sane value of 256MB protects corrupted DTB structures from overlapping
  93           device memory. Assure this size does not extend past expected storage
  94           space.
  95
  96 config FIT_ENABLE_RSASSA_PSS_SUPPORT
  97         bool "Support rsassa-pss signature scheme of FIT image contents"
  98         depends on FIT_SIGNATURE
  99         default n
 100         help
 101           Enable this to support the pss padding algorithm as described
 102           in the rfc8017 (https://tools.ietf.org/html/rfc8017).
 103
 104 config FIT_CIPHER
 105         bool "Enable ciphering data in a FIT uImages"
 106         depends on DM
 107         select AES
 108         help
 109           Enable the feature of data ciphering/unciphering in the tool mkimage
 110           and in the u-boot support of the FIT image.
 111
 112 config FIT_VERBOSE
 113         bool "Show verbose messages when FIT images fail"
 114         help
 115           Generally a system will have valid FIT images so debug messages
 116           are a waste of code space. If you are debugging your images then
 117           you can enable this option to get more verbose information about
 118           failures.
 119
 120 config FIT_BEST_MATCH
 121         bool "Select the best match for the kernel device tree"
 122         help
 123           When no configuration is explicitly selected, default to the
 124           one whose fdt's compatibility field best matches that of
 125           U-Boot itself. A match is considered "best" if it matches the
 126           most specific compatibility entry of U-Boot's fdt's root node.
 127           The order of entries in the configuration's fdt is ignored.
 128
 129 config FIT_IMAGE_POST_PROCESS
 130         bool "Enable post-processing of FIT artifacts after loading by U-Boot"
 131         depends on TI_SECURE_DEVICE
 132         help
 133           Allows doing any sort of manipulation to blobs after they got extracted
 134           from FIT images like stripping off headers or modifying the size of the
 135           blob, verification, authentication, decryption etc. in a platform or
 136           board specific way. In order to use this feature a platform or board-
 137           specific implementation of board_fit_image_post_process() must be
 138           provided. Also, anything done during this post-processing step would
 139           need to be comprehended in how the images were prepared before being
 140           injected into the FIT creation (i.e. the blobs would have been pre-
 141           processed before being added to the FIT image).
 142
 143 if SPL
 144
 145 config SPL_FIT
 146         bool "Support Flattened Image Tree within SPL"
 147         depends on SPL
 148         select SPL_OF_LIBFDT
 149
 150 config SPL_FIT_PRINT
 151         bool "Support FIT printing within SPL"
 152         depends on SPL_FIT
 153         help
 154           Support printing the content of the fitImage in a verbose manner in SPL.
 155
 156 config SPL_FIT_SIGNATURE
 157         bool "Enable signature verification of FIT firmware within SPL"
 158         depends on SPL_DM
 159         select SPL_FIT
 160         select SPL_CRYPTO_SUPPORT
 161         select SPL_HASH_SUPPORT
 162         select SPL_RSA
 163         select SPL_RSA_VERIFY
 164         select SPL_IMAGE_SIGN_INFO
 165
 166 config SPL_LOAD_FIT
 167         bool "Enable SPL loading U-Boot as a FIT (basic fitImage features)"
 168         select SPL_FIT
 169         help
 170           Normally with the SPL framework a legacy image is generated as part
 171           of the build. This contains U-Boot along with information as to
 172           where it should be loaded. This option instead enables generation
 173           of a FIT (Flat Image Tree) which provides more flexibility. In
 174           particular it can handle selecting from multiple device tree
 175           and passing the correct one to U-Boot.
 176
 177 config SPL_LOAD_FIT_ADDRESS
 178         hex "load address of fit image"
 179         depends on SPL_LOAD_FIT
 180         default 0x0
 181         help
 182           Specify the load address of the fit image that will be loaded
 183           by SPL.
 184
 185 config SPL_LOAD_FIT_APPLY_OVERLAY
 186         bool "Enable SPL applying DT overlays from FIT"
 187         depends on SPL_LOAD_FIT
 188         select OF_LIBFDT_OVERLAY
 189         help
 190           The device tree is loaded from the FIT image. Allow the SPL is to
 191           also load device-tree overlays from the FIT image an apply them
 192           over the device tree.
 193
 194 config SPL_LOAD_FIT_APPLY_OVERLAY_BUF_SZ
 195         depends on SPL_LOAD_FIT_APPLY_OVERLAY
 196         default 0x10000
 197         hex "size of temporary buffer used to load the overlays"
 198         help
 199           The size of the area where the overlays will be loaded and
 200           uncompress. Must be at least as large as biggest overlay
 201           (uncompressed)
 202
 203 config SPL_LOAD_FIT_FULL
 204         bool "Enable SPL loading U-Boot as a FIT (full fitImage features)"
 205         select SPL_FIT
 206         help
 207           Normally with the SPL framework a legacy image is generated as part
 208           of the build. This contains U-Boot along with information as to
 209           where it should be loaded. This option instead enables generation
 210           of a FIT (Flat Image Tree) which provides more flexibility. In
 211           particular it can handle selecting from multiple device tree
 212           and passing the correct one to U-Boot.
 213
 214 config SPL_FIT_IMAGE_POST_PROCESS
 215         bool "Enable post-processing of FIT artifacts after loading by the SPL"
 216         depends on SPL_LOAD_FIT
 217         help
 218           Allows doing any sort of manipulation to blobs after they got extracted
 219           from the U-Boot FIT image like stripping off headers or modifying the
 220           size of the blob, verification, authentication, decryption etc. in a
 221           platform or board specific way. In order to use this feature a platform
 222           or board-specific implementation of board_fit_image_post_process() must
 223           be provided. Also, anything done during this post-processing step would
 224           need to be comprehended in how the images were prepared before being
 225           injected into the FIT creation (i.e. the blobs would have been pre-
 226           processed before being added to the FIT image).
 227
 228 config SPL_FIT_SOURCE
 229         string ".its source file for U-Boot FIT image"
 230         depends on SPL_FIT
 231         help
 232           Specifies a (platform specific) FIT source file to generate the
 233           U-Boot FIT image. This could specify further image to load and/or
 234           execute.
 235
 236 config USE_SPL_FIT_GENERATOR
 237         bool "Use a script to generate the .its script"
 238         default y if SPL_FIT && !ARCH_SUNXI
 239
 240 config SPL_FIT_GENERATOR
 241         string ".its file generator script for U-Boot FIT image"
 242         depends on USE_SPL_FIT_GENERATOR
 243         default "arch/arm/mach-rockchip/make_fit_atf.py" if SPL_LOAD_FIT && ARCH_ROCKCHIP
 244         default "arch/arm/mach-zynqmp/mkimage_fit_atf.sh" if SPL_LOAD_FIT && ARCH_ZYNQMP
 245         default "arch/riscv/lib/mkimage_fit_opensbi.sh" if SPL_LOAD_FIT && RISCV
 246         help
 247           Specifies a (platform specific) script file to generate the FIT
 248           source file used to build the U-Boot FIT image file. This gets
 249           passed a list of supported device tree file stub names to
 250           include in the generated image.
 251
 252 endif # SPL
 253
 254 endif # FIT
 255
 256 config LEGACY_IMAGE_FORMAT
 257         bool "Enable support for the legacy image format"
 258         default y if !FIT_SIGNATURE
 259         help
 260           This option enables the legacy image format. It is enabled by
 261           default for backward compatibility, unless FIT_SIGNATURE is
 262           set where it is disabled so that unsigned images cannot be
 263           loaded. If a board needs the legacy image format support in this
 264           case, enable it here.
 265
 266 config OF_BOARD_SETUP
 267         bool "Set up board-specific details in device tree before boot"
 268         depends on OF_LIBFDT
 269         help
 270           This causes U-Boot to call ft_board_setup() before booting into
 271           the Operating System. This function can set up various
 272           board-specific information in the device tree for use by the OS.
 273           The device tree is then passed to the OS.
 274
 275 config OF_SYSTEM_SETUP
 276         bool "Set up system-specific details in device tree before boot"
 277         depends on OF_LIBFDT
 278         help
 279           This causes U-Boot to call ft_system_setup() before booting into
 280           the Operating System. This function can set up various
 281           system-specific information in the device tree for use by the OS.
 282           The device tree is then passed to the OS.
 283
 284 config OF_STDOUT_VIA_ALIAS
 285         bool "Update the device-tree stdout alias from U-Boot"
 286         depends on OF_LIBFDT
 287         help
 288           This uses U-Boot's serial alias from the aliases node to update
 289           the device tree passed to the OS. The "linux,stdout-path" property
 290           in the chosen node is set to point to the correct serial node.
 291           This option currently references CONFIG_CONS_INDEX, which is
 292           incorrect when used with device tree as this option does not
 293           exist / should not be used.
 294
 295 config SYS_EXTRA_OPTIONS
 296         string "Extra Options (DEPRECATED)"
 297         help
 298           The old configuration infrastructure (= mkconfig + boards.cfg)
 299           provided the extra options field. If you have something like
 300           "HAS_BAR,BAZ=64", the optional options
 301             #define CONFIG_HAS
 302             #define CONFIG_BAZ  64
 303           will be defined in include/config.h.
 304           This option was prepared for the smooth migration from the old
 305           configuration to Kconfig. Since this option will be removed sometime,
 306           new boards should not use this option.
 307
 308 config HAVE_SYS_TEXT_BASE
 309         bool
 310         depends on !NIOS2 && !XTENSA
 311         depends on !EFI_APP
 312         default y
 313
 314 config SYS_TEXT_BASE
 315         depends on HAVE_SYS_TEXT_BASE
 316         default 0x80800000 if ARCH_OMAP2PLUS || ARCH_K3
 317         default 0x4a000000 if ARCH_SUNXI && !MACH_SUN9I && !MACH_SUN8I_V3S
 318         default 0x2a000000 if ARCH_SUNXI && MACH_SUN9I
 319         default 0x42e00000 if ARCH_SUNXI && MACH_SUN8I_V3S
 320         hex "Text Base"
 321         help
 322           The address in memory that U-Boot will be running from, initially.
 323
 324 config SYS_CLK_FREQ
 325         depends on ARC || ARCH_SUNXI || MPC83xx
 326         int "CPU clock frequency"
 327         help
 328           TODO: Move CONFIG_SYS_CLK_FREQ for all the architecture
 329
 330 config ARCH_FIXUP_FDT_MEMORY
 331         bool "Enable arch_fixup_memory_banks() call"
 332         default y
 333         help
 334           Enable FDT memory map syncup before OS boot. This feature can be
 335           used for booting OS with different memory setup where the part of
 336           the memory location should be used for different purpose.
 337
 338 endmenu         # Boot images
 339
 340 endmenu         # Booting