1 config BR2_TARGET_UBOOT
4 Build "Das U-Boot" Boot Monitor
9 default BR2_TARGET_UBOOT_BUILD_SYSTEM_LEGACY
11 config BR2_TARGET_UBOOT_BUILD_SYSTEM_LEGACY
14 Select this option if you use an old U-Boot (older than 2015.04),
15 so that we use the old build system.
17 config BR2_TARGET_UBOOT_BUILD_SYSTEM_KCONFIG
20 Select this option if you use a recent U-Boot version (2015.04 or
21 newer), so that we use the Kconfig build system.
25 if BR2_TARGET_UBOOT_BUILD_SYSTEM_LEGACY
26 config BR2_TARGET_UBOOT_BOARDNAME
27 string "U-Boot board name"
29 One of U-Boot supported boards to be built.
30 This will be suffixed with _config to meet U-Boot standard naming.
31 See boards.cfg in U-Boot source code for the list of available
36 prompt "U-Boot Version"
38 Select the specific U-Boot version you want to use
40 config BR2_TARGET_UBOOT_LATEST_VERSION
43 config BR2_TARGET_UBOOT_CUSTOM_VERSION
46 This option allows to use a specific official versions
48 config BR2_TARGET_UBOOT_CUSTOM_TARBALL
51 config BR2_TARGET_UBOOT_CUSTOM_GIT
52 bool "Custom Git repository"
54 config BR2_TARGET_UBOOT_CUSTOM_HG
55 bool "Custom Mercurial repository"
57 config BR2_TARGET_UBOOT_CUSTOM_SVN
58 bool "Custom Subversion repository"
62 config BR2_TARGET_UBOOT_CUSTOM_VERSION_VALUE
63 string "U-Boot version"
64 depends on BR2_TARGET_UBOOT_CUSTOM_VERSION
66 config BR2_TARGET_UBOOT_CUSTOM_TARBALL_LOCATION
67 string "URL of custom U-Boot tarball"
68 depends on BR2_TARGET_UBOOT_CUSTOM_TARBALL
70 if BR2_TARGET_UBOOT_CUSTOM_GIT || BR2_TARGET_UBOOT_CUSTOM_HG || BR2_TARGET_UBOOT_CUSTOM_SVN
72 config BR2_TARGET_UBOOT_CUSTOM_REPO_URL
73 string "URL of custom repository"
74 default BR2_TARGET_UBOOT_CUSTOM_GIT_REPO_URL \
75 if BR2_TARGET_UBOOT_CUSTOM_GIT_REPO_URL != "" # legacy
77 config BR2_TARGET_UBOOT_CUSTOM_REPO_VERSION
78 string "Custom repository version"
79 default BR2_TARGET_UBOOT_CUSTOM_GIT_VERSION \
80 if BR2_TARGET_UBOOT_CUSTOM_GIT_VERSION != "" # legacy
82 Revision to use in the typical format used by Git/Mercurial/Subversion
83 E.G. a sha id, a tag, branch, ..
87 config BR2_TARGET_UBOOT_VERSION
89 default "2017.03" if BR2_TARGET_UBOOT_LATEST_VERSION
90 default BR2_TARGET_UBOOT_CUSTOM_VERSION_VALUE \
91 if BR2_TARGET_UBOOT_CUSTOM_VERSION
92 default "custom" if BR2_TARGET_UBOOT_CUSTOM_TARBALL
93 default BR2_TARGET_UBOOT_CUSTOM_REPO_VERSION \
94 if BR2_TARGET_UBOOT_CUSTOM_GIT || BR2_TARGET_UBOOT_CUSTOM_HG || BR2_TARGET_UBOOT_CUSTOM_SVN
96 config BR2_TARGET_UBOOT_PATCH
97 string "Custom U-Boot patches"
98 default BR2_TARGET_UBOOT_CUSTOM_PATCH_DIR if BR2_TARGET_UBOOT_CUSTOM_PATCH_DIR != "" # legacy
100 A space-separated list of patches to apply to U-Boot.
101 Each patch can be described as an URL, a local file path,
102 or a directory. In the case of a directory, all files
103 matching *.patch in the directory will be applied.
105 Most users may leave this empty
107 if BR2_TARGET_UBOOT_BUILD_SYSTEM_KCONFIG
109 prompt "U-Boot configuration"
110 default BR2_TARGET_UBOOT_USE_DEFCONFIG
112 config BR2_TARGET_UBOOT_USE_DEFCONFIG
113 bool "Using an in-tree board defconfig file"
115 config BR2_TARGET_UBOOT_USE_CUSTOM_CONFIG
116 bool "Using a custom board (def)config file"
120 config BR2_TARGET_UBOOT_BOARD_DEFCONFIG
121 string "Board defconfig"
122 depends on BR2_TARGET_UBOOT_USE_DEFCONFIG
124 Name of the board for which U-Boot should be built, without
125 the _defconfig suffix.
127 config BR2_TARGET_UBOOT_CUSTOM_CONFIG_FILE
128 string "Configuration file path"
129 depends on BR2_TARGET_UBOOT_USE_CUSTOM_CONFIG
131 Path to the U-Boot configuration file.
134 config BR2_TARGET_UBOOT_NEEDS_DTC
135 bool "U-Boot needs dtc"
136 select BR2_PACKAGE_HOST_DTC
138 Select this option if your U-Boot board configuration
139 requires the Device Tree compiler to be available.
141 config BR2_TARGET_UBOOT_NEEDS_OPENSSL
142 bool "U-Boot needs OpenSSL"
144 Select this option if your U-Boot board configuration
145 requires OpenSSL to be available on the host. This is
146 typically the case when the board configuration has
147 CONFIG_FIT_SIGNATURE enabled.
149 menu "U-Boot binary format"
151 config BR2_TARGET_UBOOT_FORMAT_AIS
154 AIS (Application Image Script) is a format defined by TI.
155 It is required to load code/data on OMAP-L1 processors.
156 u-boot.ais contains U-Boot with the SPL support.
158 config BR2_TARGET_UBOOT_FORMAT_BIN
162 config BR2_TARGET_UBOOT_FORMAT_DTB_BIN
163 bool "u-boot-dtb.bin"
165 config BR2_TARGET_UBOOT_FORMAT_DTB_IMG
166 bool "u-boot-dtb.img"
168 config BR2_TARGET_UBOOT_FORMAT_IMG
171 config BR2_TARGET_UBOOT_FORMAT_IMX
174 config BR2_TARGET_UBOOT_FORMAT_NAND_BIN
175 bool "u-boot-nand.bin"
177 config BR2_TARGET_UBOOT_FORMAT_KWB
179 bool "u-boot.kwb (Marvell)"
181 config BR2_TARGET_UBOOT_FORMAT_LDR
185 config BR2_TARGET_UBOOT_FORMAT_ELF
188 config BR2_TARGET_UBOOT_FORMAT_SB
190 bool "u-boot.sb (Freescale i.MX28)"
192 config BR2_TARGET_UBOOT_FORMAT_SD
194 bool "u-boot.sd (Freescale i.MX28)"
196 This is Freescale i.MX28 SB format, with a header for booting
199 U-boot includes an mxsboot tool to generate this format,
200 starting from 2011.12.
202 See doc/README.mxs (or doc/README.mx28_common before 2013.07)
204 config BR2_TARGET_UBOOT_FORMAT_NAND
206 bool "u-boot.nand (Freescale i.MX28)"
208 This is Freescale i.MX28 BootStream format (.sb), with a header
209 for booting from a NAND flash.
211 U-boot includes an mxsboot tool to generate this format,
212 starting from 2011.12.
214 There are two possibilities when preparing an image writable to
216 1) The NAND was not written at all yet or the BCB (Boot Control
217 Blocks) is broken. In this case, the NAND image 'u-boot.nand'
219 2) The NAND flash was already written with a good BCB. This
220 applies after 'u-boot.nand' was correctly written. There is no
221 need to write the BCB again. In this case, the bootloader can be
222 upgraded by writing 'u-boot.sb'.
224 To satisfy both cases, the 'u-boot.nand' image obtained from
225 mxsboot as well as the U-Boot make target 'u-boot.sb' are copied
226 to the binaries directory.
228 See doc/README.mxs (or doc/README.mx28_common before 2013.07)
230 if BR2_TARGET_UBOOT_FORMAT_NAND
232 config BR2_TARGET_UBOOT_FORMAT_NAND_PAGE_SIZE
236 The NAND page size of the targets NAND flash in bytes as a
237 decimal integer value.
239 The value provided here is passed to the -w option of mxsboot.
241 config BR2_TARGET_UBOOT_FORMAT_NAND_OOB_SIZE
245 The NAND OOB size of the targets NAND flash in bytes as a
246 decimal integer value.
248 The value provided here is passed to the -o option of mxsboot.
250 config BR2_TARGET_UBOOT_FORMAT_NAND_ERASE_SIZE
251 int "NAND erase size"
254 The NAND eraseblock size of the targets NAND flash in bytes as
255 a decimal integer value.
257 The value provided here is passed to the -e option of mxsboot.
261 config BR2_TARGET_UBOOT_FORMAT_CUSTOM
262 bool "Custom (specify below)"
264 On some platforms, the standard U-Boot binary is not called
265 u-boot.bin, but u-boot<something>.bin. If this is your case,
266 you should select this option and specify the correct name(s)
267 in BR2_TARGET_UBOOT_FORMAT_CUSTOM_NAME.
269 config BR2_TARGET_UBOOT_FORMAT_CUSTOM_NAME
270 string "U-Boot binary format: custom names"
271 depends on BR2_TARGET_UBOOT_FORMAT_CUSTOM
273 In case the U-Boot binary for the target platform is not among
274 the default names, one or more custom names can be listed here.
275 Use space to separate multiple names.
281 config BR2_TARGET_UBOOT_OMAP_IFT
282 depends on BR2_TARGET_UBOOT_FORMAT_BIN
283 depends on BR2_arm || BR2_armeb
284 select BR2_PACKAGE_HOST_OMAP_U_BOOT_UTILS
285 bool "produce a .ift signed image (OMAP)"
287 Use gpsign to produce an image of u-boot.bin signed with
288 a Configuration Header for booting on OMAP processors.
289 This allows U-Boot to boot without the need for an
290 intermediate bootloader (e.g. x-loader) if it is written
291 on the first sector of the boot medium.
292 This only works for some media, such as NAND. Check your
293 chip documentation for details. You might also want to
294 read the documentation of gpsign, the tool that generates
296 https://github.com/nmenon/omap-u-boot-utils/blob/master/README
298 if BR2_TARGET_UBOOT_OMAP_IFT
300 config BR2_TARGET_UBOOT_OMAP_IFT_CONFIG
301 string "gpsign Configuration Header config file"
303 The Configuration Header (CH) config file defines the
304 desired content of the CH for the signed image.
305 It usually contains external RAM settings and
306 possibly other external devices initialization.
307 The omap-u-boot-utils software contains example
308 configuration files for some boards:
309 https://github.com/nmenon/omap-u-boot-utils/tree/master/configs
313 config BR2_TARGET_UBOOT_SPL
314 bool "Install U-Boot SPL binary image"
315 depends on !BR2_TARGET_XLOADER
317 Install the U-Boot SPL binary image to the images
319 SPL is a first stage bootloader loaded into internal
320 memory in charge of enabling and configuring the
321 external memory (DDR), and load the u-boot program
324 config BR2_TARGET_UBOOT_SPL_NAME
325 string "U-Boot SPL binary image name"
326 default "spl/u-boot-spl.bin"
327 depends on BR2_TARGET_UBOOT_SPL
329 A space-separated list of SPL binaries, generated during
330 u-boot build. For most platform it is spl/u-boot-spl.bin but
331 not always. It is MLO on OMAP and SPL on i.MX6 for example.
333 config BR2_TARGET_UBOOT_ZYNQ_IMAGE
334 bool "Generate image for Xilinx Zynq"
336 depends on BR2_TARGET_UBOOT_SPL
337 depends on BR2_TARGET_UBOOT_FORMAT_DTB_IMG
339 Generate the BOOT.BIN file from U-Boot's SPL. The image
340 boots the Xilinx Zynq chip without any FPGA bitstream.
341 A bitstream can be loaded by the U-Boot. The SPL searchs
342 for u-boot-dtb.img file so this U-Boot format is required
345 config BR2_TARGET_UBOOT_ALTERA_SOCFPGA_IMAGE_CRC
346 bool "CRC image for Altera SoC FPGA (mkpimage)"
348 depends on BR2_TARGET_UBOOT_SPL || BR2_TARGET_UBOOT_FORMAT_DTB_BIN
350 Pass the U-Boot image through the mkpimage tool to enable
351 booting on the Altera SoC FPGA based platforms.
353 On some platforms, it's the SPL that needs to be passed
354 through mkpimage. On some other platforms there is no SPL
355 because the internal SRAM is big enough to store the full
356 U-Boot. In this case, it's directly the full U-Boot image
357 that is passed through mkpimage.
359 If BR2_TARGET_UBOOT_SPL is enabled then
360 BR2_TARGET_UBOOT_SPL_NAME is converted by mkpimage using
363 Otherwise the full u-boot-dtb.bin is converted using
364 mkpimage header version 1.
366 In either case the resulting file will be given a .crc
369 menuconfig BR2_TARGET_UBOOT_ENVIMAGE
370 bool "Environment image"
372 Generate a valid binary environment image from a text file
373 describing the key=value pairs of the environment.
375 The environment image will be called uboot-env.bin.
377 if BR2_TARGET_UBOOT_ENVIMAGE
379 config BR2_TARGET_UBOOT_ENVIMAGE_SOURCE
380 string "Source files for environment"
382 Text files describing the environment. Files should have
383 lines of the form var=value, one per line. Blank lines and
384 lines starting with a # are ignored.
386 Multiple source files are concatenated in the order listed.
388 config BR2_TARGET_UBOOT_ENVIMAGE_SIZE
389 string "Size of environment"
391 Size of envronment, can be prefixed with 0x for hexadecimal
394 config BR2_TARGET_UBOOT_ENVIMAGE_REDUNDANT
395 bool "Environment has two copies"
397 Some platforms define in their U-Boot configuration that the
398 U-Boot environment should be duplicated in two locations (for
399 extra safety). Check your U-Boot configuration for the
400 CONFIG_ENV_ADDR_REDUND and CONFIG_ENV_SIZE_REDUND settings to
401 see if this is the case for your platform.
403 If it is the case, then you should enable this option to
404 ensure that the U-Boot environment image generated by
405 Buildroot is compatible with the "redundant environment"
408 endif # BR2_TARGET_UBOOT_ENVIMAGE
410 endif # BR2_TARGET_UBOOT