board/csky: fixup gdb instructions in readme.txt
[buildroot-gz.git] / boot / uboot / Config.in
blobc33861bac61645f36e5ce1c9cca0eb1ef5b7bf37
1 config BR2_TARGET_UBOOT
2         bool "U-Boot"
3         help
4           Build "Das U-Boot" Boot Monitor
6 if BR2_TARGET_UBOOT
7 choice
8         prompt "Build system"
9         default BR2_TARGET_UBOOT_BUILD_SYSTEM_LEGACY
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 2015.04),
15           so that we use the old build system.
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 or
21           newer), so that we use the Kconfig build system.
23 endchoice
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 naming.
31           See boards.cfg in U-Boot source code for the list of available
32           configurations.
33 endif
35 choice
36         prompt "U-Boot Version"
37         help
38           Select the specific U-Boot version you want to use
40 config BR2_TARGET_UBOOT_LATEST_VERSION
41         bool "2017.03"
43 config BR2_TARGET_UBOOT_CUSTOM_VERSION
44         bool "Custom version"
45         help
46           This option allows to use a specific official versions
48 config BR2_TARGET_UBOOT_CUSTOM_TARBALL
49         bool "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"
60 endchoice
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
81         help
82           Revision to use in the typical format used by Git/Mercurial/Subversion
83           E.G. a sha id, a tag, branch, ..
85 endif
87 config BR2_TARGET_UBOOT_VERSION
88         string
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
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.
105           Most users may leave this empty
107 if BR2_TARGET_UBOOT_BUILD_SYSTEM_KCONFIG
108 choice
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"
118 endchoice
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.
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 endif
134 config BR2_TARGET_UBOOT_NEEDS_DTC
135         bool "U-Boot needs dtc"
136         select BR2_PACKAGE_HOST_DTC
137         help
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"
143         help
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
152         bool "u-boot.ais"
153         help
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
159         bool "u-boot.bin"
160         default y
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
169         bool "u-boot.img"
171 config BR2_TARGET_UBOOT_FORMAT_IMX
172         bool "u-boot.imx"
174 config BR2_TARGET_UBOOT_FORMAT_NAND_BIN
175         bool "u-boot-nand.bin"
177 config BR2_TARGET_UBOOT_FORMAT_KWB
178         depends on BR2_arm
179         bool "u-boot.kwb (Marvell)"
181 config BR2_TARGET_UBOOT_FORMAT_LDR
182         depends on BR2_bfin
183         bool "u-boot.ldr"
185 config BR2_TARGET_UBOOT_FORMAT_ELF
186         bool "u-boot.elf"
188 config BR2_TARGET_UBOOT_FORMAT_SB
189         depends on BR2_arm
190         bool "u-boot.sb (Freescale i.MX28)"
192 config BR2_TARGET_UBOOT_FORMAT_SD
193         depends on BR2_arm
194         bool "u-boot.sd (Freescale i.MX28)"
195         help
196           This is Freescale i.MX28 SB format, with a header for booting
197           from an SD card.
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
205         depends on BR2_arm
206         bool "u-boot.nand (Freescale i.MX28)"
207         help
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
215           NAND flash:
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'
218           needs to written.
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
233         int "NAND page size"
234         default 2048
235         help
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
242         int "NAND OOB size"
243         default 64
244         help
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"
252         default 131072
253         help
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.
259 endif
261 config BR2_TARGET_UBOOT_FORMAT_CUSTOM
262         bool "Custom (specify below)"
263         help
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
272         help
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.
276           Example:
277           u-boot_magic.bin
279 endmenu
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)"
286         help
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
295           the .ift image, at:
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"
302         help
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
311 endif
313 config BR2_TARGET_UBOOT_SPL
314         bool "Install U-Boot SPL binary image"
315         depends on !BR2_TARGET_XLOADER
316         help
317           Install the U-Boot SPL binary image to the images
318           directory.
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
322           into DDR.
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
328         help
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"
335         depends on BR2_arm
336         depends on BR2_TARGET_UBOOT_SPL
337         depends on BR2_TARGET_UBOOT_FORMAT_DTB_IMG
338         help
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
343           to be set.
345 config BR2_TARGET_UBOOT_ALTERA_SOCFPGA_IMAGE_CRC
346         bool "CRC image for Altera SoC FPGA (mkpimage)"
347         depends on BR2_arm
348         depends on BR2_TARGET_UBOOT_SPL || BR2_TARGET_UBOOT_FORMAT_DTB_BIN
349         help
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
361           header version 0.
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
367           extension.
369 menuconfig BR2_TARGET_UBOOT_ENVIMAGE
370         bool "Environment image"
371         help
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"
381         help
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"
390         help
391           Size of envronment, can be prefixed with 0x for hexadecimal
392           values.
394 config BR2_TARGET_UBOOT_ENVIMAGE_REDUNDANT
395         bool "Environment has two copies"
396         help
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"
406           mechanism of U-Boot.
408 endif # BR2_TARGET_UBOOT_ENVIMAGE
410 endif # BR2_TARGET_UBOOT