]> rtime.felk.cvut.cz Git - coffee/buildroot.git/blob - boot/uboot/Config.in
boot/*/Config.in: re-wrap help text
[coffee/buildroot.git] / boot / uboot / Config.in
1 config BR2_TARGET_UBOOT
2         bool "U-Boot"
3         help
4           Build "Das U-Boot" Boot Monitor
5
6 if BR2_TARGET_UBOOT
7 choice
8         prompt "Build system"
9         default BR2_TARGET_UBOOT_BUILD_SYSTEM_LEGACY
10
11 config BR2_TARGET_UBOOT_BUILD_SYSTEM_LEGACY
12         bool "Legacy"
13         help
14           Select this option if you use an old U-Boot (older than
15           2015.04), so that we use the old build system.
16
17 config BR2_TARGET_UBOOT_BUILD_SYSTEM_KCONFIG
18         bool "Kconfig"
19         help
20           Select this option if you use a recent U-Boot version (2015.04
21           or newer), so that we use the Kconfig build system.
22
23 endchoice
24
25 if BR2_TARGET_UBOOT_BUILD_SYSTEM_LEGACY
26 config BR2_TARGET_UBOOT_BOARDNAME
27         string "U-Boot board name"
28         help
29           One of U-Boot supported boards to be built.
30           This will be suffixed with _config to meet U-Boot standard
31           naming. See boards.cfg in U-Boot source code for the list of
32           available configurations.
33 endif
34
35 choice
36         prompt "U-Boot Version"
37         help
38           Select the specific U-Boot version you want to use
39
40 config BR2_TARGET_UBOOT_LATEST_VERSION
41         bool "2018.01"
42
43 config BR2_TARGET_UBOOT_CUSTOM_VERSION
44         bool "Custom version"
45         help
46           This option allows to use a specific official versions
47
48 config BR2_TARGET_UBOOT_CUSTOM_TARBALL
49         bool "Custom tarball"
50
51 config BR2_TARGET_UBOOT_CUSTOM_GIT
52         bool "Custom Git repository"
53
54 config BR2_TARGET_UBOOT_CUSTOM_HG
55         bool "Custom Mercurial repository"
56
57 config BR2_TARGET_UBOOT_CUSTOM_SVN
58         bool "Custom Subversion repository"
59
60 endchoice
61
62 config BR2_TARGET_UBOOT_CUSTOM_VERSION_VALUE
63         string "U-Boot version"
64         depends on BR2_TARGET_UBOOT_CUSTOM_VERSION
65
66 config BR2_TARGET_UBOOT_CUSTOM_TARBALL_LOCATION
67         string "URL of custom U-Boot tarball"
68         depends on BR2_TARGET_UBOOT_CUSTOM_TARBALL
69
70 if BR2_TARGET_UBOOT_CUSTOM_GIT || BR2_TARGET_UBOOT_CUSTOM_HG || BR2_TARGET_UBOOT_CUSTOM_SVN
71
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
76
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
81         help
82           Revision to use in the typical format used by
83           Git/Mercurial/Subversion E.G. a sha id, a tag, branch, ..
84
85 endif
86
87 config BR2_TARGET_UBOOT_VERSION
88         string
89         default "2018.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
95
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
99         help
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.
104
105           Most users may leave this empty
106
107 if BR2_TARGET_UBOOT_BUILD_SYSTEM_KCONFIG
108 choice
109         prompt "U-Boot configuration"
110         default BR2_TARGET_UBOOT_USE_DEFCONFIG
111
112 config BR2_TARGET_UBOOT_USE_DEFCONFIG
113         bool "Using an in-tree board defconfig file"
114
115 config BR2_TARGET_UBOOT_USE_CUSTOM_CONFIG
116         bool "Using a custom board (def)config file"
117
118 endchoice
119
120 config BR2_TARGET_UBOOT_BOARD_DEFCONFIG
121         string "Board defconfig"
122         depends on BR2_TARGET_UBOOT_USE_DEFCONFIG
123         help
124           Name of the board for which U-Boot should be built, without
125           the _defconfig suffix.
126
127 config BR2_TARGET_UBOOT_CUSTOM_CONFIG_FILE
128         string "Configuration file path"
129         depends on BR2_TARGET_UBOOT_USE_CUSTOM_CONFIG
130         help
131           Path to the U-Boot configuration file.
132
133 config BR2_TARGET_UBOOT_CONFIG_FRAGMENT_FILES
134         string "Additional configuration fragment files"
135         help
136           A space-separated list of configuration fragment files,
137           that will be merged to the main U-Boot configuration file.
138 endif
139
140 config BR2_TARGET_UBOOT_NEEDS_DTC
141         bool "U-Boot needs dtc"
142         select BR2_PACKAGE_HOST_DTC
143         help
144           Select this option if your U-Boot board configuration
145           requires the Device Tree compiler to be available.
146
147 config BR2_TARGET_UBOOT_NEEDS_PYLIBFDT
148         bool "U-Boot needs pylibfdt"
149         help
150           Select this option if your U-Boot board configuration
151           requires the Python libfdt library to be available.
152
153 config BR2_TARGET_UBOOT_NEEDS_OPENSSL
154         bool "U-Boot needs OpenSSL"
155         help
156           Select this option if your U-Boot board configuration
157           requires OpenSSL to be available on the host. This is
158           typically the case when the board configuration has
159           CONFIG_FIT_SIGNATURE enabled.
160
161 config BR2_TARGET_UBOOT_NEEDS_ATF_BL31
162         bool "U-Boot needs ATF BL31"
163         depends on BR2_TARGET_ARM_TRUSTED_FIRMWARE
164         depends on !BR2_TARGET_ARM_TRUSTED_FIRMWARE_UBOOT_AS_BL33
165         select BR2_TARGET_ARM_TRUSTED_FIRMWARE_BL31
166         help
167           Some specific platforms (such as Allwinner A64/H5)
168           encapsulate the BL31 part of ATF inside U-Boot. This option
169           makes sure ATF gets built prior to U-Boot, and that the BL31
170           variable pointing to ATF's BL31 binary, is passed during the
171           Buildroot build.
172
173 menu "U-Boot binary format"
174
175 config BR2_TARGET_UBOOT_FORMAT_AIS
176         bool "u-boot.ais"
177         help
178           AIS (Application Image Script) is a format defined by TI.
179           It is required to load code/data on OMAP-L1 processors.
180           u-boot.ais contains U-Boot with the SPL support.
181
182 config BR2_TARGET_UBOOT_FORMAT_BIN
183         bool "u-boot.bin"
184         default y
185
186 config BR2_TARGET_UBOOT_FORMAT_DTB_BIN
187         bool "u-boot-dtb.bin"
188
189 config BR2_TARGET_UBOOT_FORMAT_DTB_IMG
190         bool "u-boot-dtb.img"
191
192 config BR2_TARGET_UBOOT_FORMAT_IMG
193         bool "u-boot.img"
194
195 config BR2_TARGET_UBOOT_FORMAT_IMX
196         bool "u-boot.imx"
197
198 config BR2_TARGET_UBOOT_FORMAT_NAND_BIN
199         bool "u-boot-nand.bin"
200
201 config BR2_TARGET_UBOOT_FORMAT_KWB
202         bool "u-boot.kwb (Marvell)"
203         depends on BR2_arm
204
205 config BR2_TARGET_UBOOT_FORMAT_LDR
206         bool "u-boot.ldr"
207         depends on BR2_bfin
208
209 config BR2_TARGET_UBOOT_FORMAT_ELF
210         bool "u-boot.elf"
211
212 config BR2_TARGET_UBOOT_FORMAT_SB
213         bool "u-boot.sb (Freescale i.MX28)"
214         depends on BR2_arm
215
216 config BR2_TARGET_UBOOT_FORMAT_SD
217         bool "u-boot.sd (Freescale i.MX28)"
218         depends on BR2_arm
219         help
220           This is Freescale i.MX28 SB format, with a header for booting
221           from an SD card.
222
223           U-boot includes an mxsboot tool to generate this format,
224           starting from 2011.12.
225
226           See doc/README.mxs (or doc/README.mx28_common before 2013.07)
227
228 config BR2_TARGET_UBOOT_FORMAT_NAND
229         bool "u-boot.nand (Freescale i.MX28)"
230         depends on BR2_arm
231         help
232           This is Freescale i.MX28 BootStream format (.sb), with a
233           header for booting from a NAND flash.
234
235           U-boot includes an mxsboot tool to generate this format,
236           starting from 2011.12.
237
238           There are two possibilities when preparing an image writable
239           to NAND flash:
240           1) The NAND was not written at all yet or the BCB (Boot
241           Control Blocks) is broken. In this case, the NAND image
242           'u-boot.nand' needs to written.
243           2) The NAND flash was already written with a good BCB. This
244           applies after 'u-boot.nand' was correctly written. There is no
245           need to write the BCB again. In this case, the bootloader can
246           be upgraded by writing 'u-boot.sb'.
247
248           To satisfy both cases, the 'u-boot.nand' image obtained from
249           mxsboot as well as the U-Boot make target 'u-boot.sb' are
250           copied to the binaries directory.
251
252           See doc/README.mxs (or doc/README.mx28_common before 2013.07)
253
254 if BR2_TARGET_UBOOT_FORMAT_NAND
255
256 config BR2_TARGET_UBOOT_FORMAT_NAND_PAGE_SIZE
257         int "NAND page size"
258         default 2048
259         help
260           The NAND page size of the targets NAND flash in bytes as a
261           decimal integer value.
262
263           The value provided here is passed to the -w option of mxsboot.
264
265 config BR2_TARGET_UBOOT_FORMAT_NAND_OOB_SIZE
266         int "NAND OOB size"
267         default 64
268         help
269           The NAND OOB size of the targets NAND flash in bytes as a
270           decimal integer value.
271
272           The value provided here is passed to the -o option of mxsboot.
273
274 config BR2_TARGET_UBOOT_FORMAT_NAND_ERASE_SIZE
275         int "NAND erase size"
276         default 131072
277         help
278           The NAND eraseblock size of the targets NAND flash in bytes as
279           a decimal integer value.
280
281           The value provided here is passed to the -e option of mxsboot.
282
283 endif
284
285 config BR2_TARGET_UBOOT_FORMAT_CUSTOM
286         bool "Custom (specify below)"
287         help
288           On some platforms, the standard U-Boot binary is not called
289           u-boot.bin, but u-boot<something>.bin. If this is your case,
290           you should select this option and specify the correct name(s)
291           in BR2_TARGET_UBOOT_FORMAT_CUSTOM_NAME.
292
293 config BR2_TARGET_UBOOT_FORMAT_CUSTOM_NAME
294         string "U-Boot binary format: custom names"
295         depends on BR2_TARGET_UBOOT_FORMAT_CUSTOM
296         help
297           In case the U-Boot binary for the target platform is not among
298           the default names, one or more custom names can be listed
299           here.
300           Use space to separate multiple names.
301           Example:
302           u-boot_magic.bin
303
304 endmenu
305
306 config BR2_TARGET_UBOOT_OMAP_IFT
307         bool "produce a .ift signed image (OMAP)"
308         depends on BR2_TARGET_UBOOT_FORMAT_BIN
309         depends on BR2_arm || BR2_armeb
310         select BR2_PACKAGE_HOST_OMAP_U_BOOT_UTILS
311         help
312           Use gpsign to produce an image of u-boot.bin signed with
313           a Configuration Header for booting on OMAP processors.
314           This allows U-Boot to boot without the need for an
315           intermediate bootloader (e.g. x-loader) if it is written
316           on the first sector of the boot medium.
317           This only works for some media, such as NAND. Check your
318           chip documentation for details. You might also want to
319           read the documentation of gpsign, the tool that generates
320           the .ift image, at:
321           https://github.com/nmenon/omap-u-boot-utils/blob/master/README
322
323 if BR2_TARGET_UBOOT_OMAP_IFT
324
325 config BR2_TARGET_UBOOT_OMAP_IFT_CONFIG
326         string "gpsign Configuration Header config file"
327         help
328           The Configuration Header (CH) config file defines the
329           desired content of the CH for the signed image.
330           It usually contains external RAM settings and
331           possibly other external devices initialization.
332           The omap-u-boot-utils software contains example
333           configuration files for some boards:
334           https://github.com/nmenon/omap-u-boot-utils/tree/master/configs
335
336 endif
337
338 config BR2_TARGET_UBOOT_SPL
339         bool "Install U-Boot SPL binary image"
340         depends on !BR2_TARGET_XLOADER
341         help
342           Install the U-Boot SPL binary image to the images
343           directory.
344           SPL is a first stage bootloader loaded into internal
345           memory in charge of enabling and configuring the
346           external memory (DDR), and load the u-boot program
347           into DDR.
348
349 config BR2_TARGET_UBOOT_SPL_NAME
350         string "U-Boot SPL/TPL binary image name(s)"
351         default "spl/u-boot-spl.bin"
352         depends on BR2_TARGET_UBOOT_SPL
353         help
354           A space-separated list of SPL/TPL binaries, generated during
355           u-boot build. For most platform SPL name is spl/u-boot-spl.bin
356           and TPL name is tpl/u-boot-tpl.bin but not always. SPL name is
357           MLO on OMAP and SPL on i.MX6 for example.
358
359 config BR2_TARGET_UBOOT_ZYNQ_IMAGE
360         bool "Generate image for Xilinx Zynq"
361         depends on BR2_arm
362         depends on BR2_TARGET_UBOOT_SPL
363         depends on BR2_TARGET_UBOOT_FORMAT_DTB_IMG
364         help
365           Generate the BOOT.BIN file from U-Boot's SPL. The image
366           boots the Xilinx Zynq chip without any FPGA bitstream.
367           A bitstream can be loaded by the U-Boot. The SPL searchs
368           for u-boot-dtb.img file so this U-Boot format is required
369           to be set.
370
371 config BR2_TARGET_UBOOT_ALTERA_SOCFPGA_IMAGE_CRC
372         bool "CRC image for Altera SoC FPGA (mkpimage)"
373         depends on BR2_arm
374         depends on BR2_TARGET_UBOOT_SPL || BR2_TARGET_UBOOT_FORMAT_DTB_BIN
375         help
376           Pass the U-Boot image through the mkpimage tool to enable
377           booting on the Altera SoC FPGA based platforms.
378
379           On some platforms, it's the SPL that needs to be passed
380           through mkpimage. On some other platforms there is no SPL
381           because the internal SRAM is big enough to store the full
382           U-Boot. In this case, it's directly the full U-Boot image
383           that is passed through mkpimage.
384
385           If BR2_TARGET_UBOOT_SPL is enabled then
386           BR2_TARGET_UBOOT_SPL_NAME is converted by mkpimage using
387           header version 0.
388
389           Otherwise the full u-boot-dtb.bin is converted using
390           mkpimage header version 1.
391
392           In either case the resulting file will be given a .crc
393           extension.
394
395 menuconfig BR2_TARGET_UBOOT_ENVIMAGE
396         bool "Environment image"
397         help
398           Generate a valid binary environment image from a text file
399           describing the key=value pairs of the environment.
400
401           The environment image will be called uboot-env.bin.
402
403 if BR2_TARGET_UBOOT_ENVIMAGE
404
405 config BR2_TARGET_UBOOT_ENVIMAGE_SOURCE
406         string "Source files for environment"
407         help
408           Text files describing the environment. Files should have
409           lines of the form var=value, one per line. Blank lines and
410           lines starting with a # are ignored.
411
412           Multiple source files are concatenated in the order listed.
413
414 config BR2_TARGET_UBOOT_ENVIMAGE_SIZE
415         string "Size of environment"
416         help
417           Size of envronment, can be prefixed with 0x for hexadecimal
418           values.
419
420 config BR2_TARGET_UBOOT_ENVIMAGE_REDUNDANT
421         bool "Environment has two copies"
422         help
423           Some platforms define in their U-Boot configuration that the
424           U-Boot environment should be duplicated in two locations (for
425           extra safety). Check your U-Boot configuration for the
426           CONFIG_ENV_ADDR_REDUND and CONFIG_ENV_SIZE_REDUND settings to
427           see if this is the case for your platform.
428
429           If it is the case, then you should enable this option to
430           ensure that the U-Boot environment image generated by
431           Buildroot is compatible with the "redundant environment"
432           mechanism of U-Boot.
433
434 endif # BR2_TARGET_UBOOT_ENVIMAGE
435
436 config BR2_TARGET_UBOOT_BOOT_SCRIPT
437         bool "Generate a U-Boot boot script"
438         help
439           Generate a U-Boot boot script, given a file listing U-Boot
440           commands to be executed at boot time. The generated boot
441           script will be called 'boot.scr'.
442
443 if BR2_TARGET_UBOOT_BOOT_SCRIPT
444
445 config BR2_TARGET_UBOOT_BOOT_SCRIPT_SOURCE
446         string "U-Boot boot script source"
447         help
448           Source file to generate the U-Boot boot script.
449
450 endif
451
452 if BR2_TARGET_UBOOT_BUILD_SYSTEM_KCONFIG
453
454 config BR2_TARGET_UBOOT_CUSTOM_DTS_PATH
455         string "Device Tree Source file paths"
456         help
457           Space-separated list of paths to device tree source files
458           that will be copied to arch/ARCH/dts/ before starting the
459           build.
460
461           To use this device tree source file, the U-Boot configuration
462           file must refer to it.
463
464 endif
465
466 endif # BR2_TARGET_UBOOT