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.01" 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_IMG
163 bool "u-boot-dtb.img"
165 config BR2_TARGET_UBOOT_FORMAT_IMG
168 config BR2_TARGET_UBOOT_FORMAT_IMX
171 config BR2_TARGET_UBOOT_FORMAT_NAND_BIN
172 bool "u-boot-nand.bin"
174 config BR2_TARGET_UBOOT_FORMAT_KWB
176 bool "u-boot.kwb (Marvell)"
178 config BR2_TARGET_UBOOT_FORMAT_LDR
182 config BR2_TARGET_UBOOT_FORMAT_ELF
185 config BR2_TARGET_UBOOT_FORMAT_SB
187 bool "u-boot.sb (Freescale i.MX28)"
189 config BR2_TARGET_UBOOT_FORMAT_SD
191 bool "u-boot.sd (Freescale i.MX28)"
193 This is Freescale i.MX28 SB format, with a header for booting
196 U-boot includes an mxsboot tool to generate this format,
197 starting from 2011.12.
199 See doc/README.mxs (or doc/README.mx28_common before 2013.07)
201 config BR2_TARGET_UBOOT_FORMAT_NAND
203 bool "u-boot.nand (Freescale i.MX28)"
205 This is Freescale i.MX28 BootStream format (.sb), with a header
206 for booting from a NAND flash.
208 U-boot includes an mxsboot tool to generate this format,
209 starting from 2011.12.
211 There are two possibilities when preparing an image writable to
213 1) The NAND was not written at all yet or the BCB (Boot Control
214 Blocks) is broken. In this case, the NAND image 'u-boot.nand'
216 2) The NAND flash was already written with a good BCB. This
217 applies after 'u-boot.nand' was correctly written. There is no
218 need to write the BCB again. In this case, the bootloader can be
219 upgraded by writing 'u-boot.sb'.
221 To satisfy both cases, the 'u-boot.nand' image obtained from
222 mxsboot as well as the U-Boot make target 'u-boot.sb' are copied
223 to the binaries directory.
225 See doc/README.mxs (or doc/README.mx28_common before 2013.07)
227 if BR2_TARGET_UBOOT_FORMAT_NAND
229 config BR2_TARGET_UBOOT_FORMAT_NAND_PAGE_SIZE
233 The NAND page size of the targets NAND flash in bytes as a
234 decimal integer value.
236 The value provided here is passed to the -w option of mxsboot.
238 config BR2_TARGET_UBOOT_FORMAT_NAND_OOB_SIZE
242 The NAND OOB size of the targets NAND flash in bytes as a
243 decimal integer value.
245 The value provided here is passed to the -o option of mxsboot.
247 config BR2_TARGET_UBOOT_FORMAT_NAND_ERASE_SIZE
248 int "NAND erase size"
251 The NAND eraseblock size of the targets NAND flash in bytes as
252 a decimal integer value.
254 The value provided here is passed to the -e option of mxsboot.
258 config BR2_TARGET_UBOOT_FORMAT_CUSTOM
259 bool "Custom (specify below)"
261 On some platforms, the standard U-Boot binary is not called
262 u-boot.bin, but u-boot<something>.bin. If this is your case,
263 you should select this option and specify the correct name(s)
264 in BR2_TARGET_UBOOT_FORMAT_CUSTOM_NAME.
266 config BR2_TARGET_UBOOT_FORMAT_CUSTOM_NAME
267 string "U-Boot binary format: custom names"
268 depends on BR2_TARGET_UBOOT_FORMAT_CUSTOM
270 In case the U-Boot binary for the target platform is not among
271 the default names, one or more custom names can be listed here.
272 Use space to separate multiple names.
278 config BR2_TARGET_UBOOT_OMAP_IFT
279 depends on BR2_TARGET_UBOOT_FORMAT_BIN
280 depends on BR2_arm || BR2_armeb
281 select BR2_PACKAGE_HOST_OMAP_U_BOOT_UTILS
282 bool "produce a .ift signed image (OMAP)"
284 Use gpsign to produce an image of u-boot.bin signed with
285 a Configuration Header for booting on OMAP processors.
286 This allows U-Boot to boot without the need for an
287 intermediate bootloader (e.g. x-loader) if it is written
288 on the first sector of the boot medium.
289 This only works for some media, such as NAND. Check your
290 chip documentation for details. You might also want to
291 read the documentation of gpsign, the tool that generates
293 https://github.com/nmenon/omap-u-boot-utils/blob/master/README
295 if BR2_TARGET_UBOOT_OMAP_IFT
297 config BR2_TARGET_UBOOT_OMAP_IFT_CONFIG
298 string "gpsign Configuration Header config file"
300 The Configuration Header (CH) config file defines the
301 desired content of the CH for the signed image.
302 It usually contains external RAM settings and
303 possibly other external devices initialization.
304 The omap-u-boot-utils software contains example
305 configuration files for some boards:
306 https://github.com/nmenon/omap-u-boot-utils/tree/master/configs
310 config BR2_TARGET_UBOOT_SPL
311 bool "Install U-Boot SPL binary image"
312 depends on !BR2_TARGET_XLOADER
314 Install the U-Boot SPL binary image to the images
316 SPL is a first stage bootloader loaded into internal
317 memory in charge of enabling and configuring the
318 external memory (DDR), and load the u-boot program
321 config BR2_TARGET_UBOOT_SPL_NAME
322 string "U-Boot SPL binary image name"
323 default "spl/u-boot-spl.bin"
324 depends on BR2_TARGET_UBOOT_SPL
326 A space-separated list of SPL binaries, generated during
327 u-boot build. For most platform it is spl/u-boot-spl.bin
328 but not always. It is MLO on OMAP for example.
330 config BR2_TARGET_UBOOT_ZYNQ_IMAGE
331 bool "Generate image for Xilinx Zynq"
333 depends on BR2_TARGET_UBOOT_SPL
334 depends on BR2_TARGET_UBOOT_FORMAT_DTB_IMG
336 Generate the BOOT.BIN file from U-Boot's SPL. The image
337 boots the Xilinx Zynq chip without any FPGA bitstream.
338 A bitstream can be loaded by the U-Boot. The SPL searchs
339 for u-boot-dtb.img file so this U-Boot format is required
342 config BR2_TARGET_UBOOT_ALTERA_SOCFPGA_IMAGE_CRC
343 bool "CRC SPL image for Altera SoC FPGA"
345 depends on BR2_TARGET_UBOOT_SPL
347 Generate SPL image fixed by the mkpimage tool to enable
348 booting on the Altera SoC FPGA based platforms.
350 menuconfig BR2_TARGET_UBOOT_ENVIMAGE
351 bool "Environment image"
353 Generate a valid binary environment image from a text file
354 describing the key=value pairs of the environment.
356 The environment image will be called uboot-env.bin.
358 if BR2_TARGET_UBOOT_ENVIMAGE
360 config BR2_TARGET_UBOOT_ENVIMAGE_SOURCE
361 string "Source files for environment"
363 Text files describing the environment. Files should have
364 lines of the form var=value, one per line. Blank lines and
365 lines starting with a # are ignored.
367 Multiple source files are concatenated in the order listed.
369 config BR2_TARGET_UBOOT_ENVIMAGE_SIZE
370 string "Size of environment"
372 Size of envronment, can be prefixed with 0x for hexadecimal
375 config BR2_TARGET_UBOOT_ENVIMAGE_REDUNDANT
376 bool "Environment has two copies"
378 Some platforms define in their U-Boot configuration that the
379 U-Boot environment should be duplicated in two locations (for
380 extra safety). Check your U-Boot configuration for the
381 CONFIG_ENV_ADDR_REDUND and CONFIG_ENV_SIZE_REDUND settings to
382 see if this is the case for your platform.
384 If it is the case, then you should enable this option to
385 ensure that the U-Boot environment image generated by
386 Buildroot is compatible with the "redundant environment"
389 endif # BR2_TARGET_UBOOT_ENVIMAGE
391 endif # BR2_TARGET_UBOOT