Kconfig: Simple aesthetic/grammar fixes to top-level Kconfig
[platform/kernel/u-boot.git] / Kconfig
1 #
2 # For a description of the syntax of this configuration file,
3 # see the file Documentation/kbuild/kconfig-language.txt in the
4 # Linux kernel source tree.
5 #
6 mainmenu "U-Boot $UBOOTVERSION Configuration"
7
8 config UBOOTVERSION
9         string
10         option env="UBOOTVERSION"
11
12 # Allow defaults in arch-specific code to override any given here
13 source "arch/Kconfig"
14
15 menu "General setup"
16
17 config LOCALVERSION
18         string "Local version - append to U-Boot release"
19         help
20           Append an extra string to the end of your U-Boot version.
21           This will show up in your boot log, for example.
22           The string you set here will be appended after the contents of
23           any files with a filename matching localversion* in your
24           object and source tree, in that order.  Your total string can
25           be a maximum of 64 characters.
26
27 config LOCALVERSION_AUTO
28         bool "Automatically append version information to the version string"
29         default y
30         help
31           This will try to automatically determine if the current tree is a
32           release tree by looking for Git tags that belong to the current
33           top of tree revision.
34
35           A string of the format -gxxxxxxxx will be added to the localversion
36           if a Git-based tree is found.  The string generated by this will be
37           appended after any matching localversion* files, and after the value
38           set in CONFIG_LOCALVERSION.
39
40           (The actual string used here is the first eight characters produced
41           by running the command:
42
43             $ git rev-parse --verify HEAD
44
45           which is done within the script "scripts/setlocalversion".)
46
47 config CC_OPTIMIZE_FOR_SIZE
48         bool "Optimize for size"
49         default y
50         help
51           Enabling this option will pass "-Os" instead of "-O2" to gcc
52           resulting in a smaller U-Boot image.
53
54           This option is enabled by default for U-Boot.
55
56 config SYS_MALLOC_F
57         bool "Enable malloc() pool before relocation"
58         default y if DM
59         help
60           Before relocation, memory is very limited on many platforms. Still,
61           we can provide a small malloc() pool if needed. Driver model in
62           particular needs this to operate, so that it can allocate the
63           initial serial device and any others that are needed.
64
65 config SYS_MALLOC_F_LEN
66         hex "Size of malloc() pool before relocation"
67         depends on SYS_MALLOC_F
68         default 0x400
69         help
70           Before relocation, memory is very limited on many platforms. Still,
71           we can provide a small malloc() pool if needed. Driver model in
72           particular needs this to operate, so that it can allocate the
73           initial serial device and any others that are needed.
74
75 menuconfig EXPERT
76         bool "Configure standard U-Boot features (expert users)"
77         default y
78         help
79           This option allows certain base U-Boot options and settings
80           to be disabled or tweaked. This is for specialized
81           environments which can tolerate a "non-standard" U-Boot.
82           Use this only if you really know what you are doing.
83
84 if EXPERT
85         config SYS_MALLOC_CLEAR_ON_INIT
86         bool "Init with zeros the memory reserved for malloc (slow)"
87         default y
88         help
89           This setting is enabled by default. The reserved malloc
90           memory is initialized with zeros, so first malloc calls
91           will return the pointer to the zeroed memory. But this
92           slows the boot time.
93
94           It is recommended to disable it, when CONFIG_SYS_MALLOC_LEN
95           value, has more than few MiB, e.g. when uses bzip2 or bmp logo.
96           Then the boot time can be significantly reduced.
97           Warning:
98           When disabling this, please check if malloc calls, maybe
99           should be replaced by calloc - if one expects zeroed memory.
100 endif
101 endmenu         # General setup
102
103 menu "Boot images"
104
105 config SUPPORT_SPL
106         bool
107
108 config SUPPORT_TPL
109         bool
110
111 config SPL
112         bool
113         depends on SUPPORT_SPL
114         prompt "Enable SPL"
115         help
116           If you want to build SPL as well as the normal image, say Y.
117
118 config SPL_SYS_MALLOC_SIMPLE
119         bool
120         depends on SPL
121         prompt "Only use malloc_simple functions in the SPL"
122         help
123           Say Y here to only use the *_simple malloc functions from
124           malloc_simple.c, rather then using the versions from dlmalloc.c;
125           this will make the SPL binary smaller at the cost of more heap
126           usage as the *_simple malloc functions do not re-use free-ed mem.
127
128 config SPL_STACK_R
129         depends on SPL
130         bool "Enable SDRAM location for SPL stack"
131         help
132           SPL starts off execution in SRAM and thus typically has only a small
133           stack available. Since SPL sets up DRAM while in its board_init_f()
134           function, it is possible for the stack to move there before
135           board_init_r() is reached. This option enables a special SDRAM
136           location for the SPL stack. U-Boot SPL switches to this after
137           board_init_f() completes, and before board_init_r() starts.
138
139 config SPL_STACK_R_ADDR
140         depends on SPL_STACK_R
141         hex "SDRAM location for SPL stack"
142         help
143           Specify the address in SDRAM for the SPL stack. This will be set up
144           before board_init_r() is called.
145
146 config SPL_STACK_R_MALLOC_SIMPLE_LEN
147         depends on SPL_STACK_R && SPL_SYS_MALLOC_SIMPLE
148         hex "Size of malloc_simple heap after switching to DRAM SPL stack"
149         default 0x100000
150         help
151           Specify the amount of the stack to use as memory pool for
152           malloc_simple after switching the stack to DRAM. This may be set
153           to give board_init_r() a larger heap then the initial heap in
154           SRAM which is limited to SYS_MALLOC_F_LEN bytes.
155
156 config SPL_SEPARATE_BSS
157         depends on SPL
158         bool "BSS section is in a different memory region from text"
159         help
160           Some platforms need a large BSS region in SPL and can provide this
161           because RAM is already set up. In this case BSS can be moved to RAM.
162           This option should then be enabled so that the correct device tree
163           location is used. Normally we put the device tree at the end of BSS
164           but with this option enabled, it goes at _image_binary_end.
165
166 config TPL
167         bool
168         depends on SPL && SUPPORT_TPL
169         prompt "Enable TPL"
170         help
171           If you want to build TPL as well as the normal image and SPL, say Y.
172
173 config FIT
174         bool "Support Flattened Image Tree"
175         help
176           This option allows to boot the new uImage structrure,
177           Flattened Image Tree.  FIT is formally a FDT, which can include
178           images of various types (kernel, FDT blob, ramdisk, etc.)
179           in a single blob.  To boot this new uImage structure,
180           pass the address of the blob to the "bootm" command.
181           FIT is very flexible, supporting compression, multiple images,
182           multiple configurations, verification through hashing and also
183           verified boot (secure boot using RSA). This option enables that
184           feature.
185
186 config FIT_VERBOSE
187         bool "Display verbose messages on FIT boot"
188         depends on FIT
189
190 config FIT_SIGNATURE
191         bool "Enable signature verification of FIT uImages"
192         depends on FIT
193         depends on DM
194         select RSA
195         help
196           This option enables signature verification of FIT uImages,
197           using a hash signed and verified using RSA. If
198           CONFIG_SHA_PROG_HW_ACCEL is defined, i.e support for progressive
199           hashing is available using hardware, then then RSA library will use
200           it. See doc/uImage.FIT/signature.txt for more details.
201
202           WARNING: When relying on signed FIT images with a required signature
203           check the legacy image format is disabled by default, so that
204           unsigned images cannot be loaded. If a board needs the legacy image
205           format support in this case, enable it using
206           CONFIG_IMAGE_FORMAT_LEGACY.
207
208 config FIT_BEST_MATCH
209         bool "Select the best match for the kernel device tree"
210         depends on FIT
211         help
212           When no configuration is explicitly selected, default to the
213           one whose fdt's compatibility field best matches that of
214           U-Boot itself. A match is considered "best" if it matches the
215           most specific compatibility entry of U-Boot's fdt's root node.
216           The order of entries in the configuration's fdt is ignored.
217
218 config FIT_VERBOSE
219         bool "Show verbose messages when FIT images fails"
220         depends on FIT
221         help
222           Generally a system will have valid FIT images so debug messages
223           are a waste of code space. If you are debugging your images then
224           you can enable this option to get more verbose information about
225           failures.
226
227 config OF_BOARD_SETUP
228         bool "Set up board-specific details in device tree before boot"
229         depends on OF_LIBFDT
230         help
231           This causes U-Boot to call ft_board_setup() before booting into
232           the Operating System. This function can set up various
233           board-specific information in the device tree for use by the OS.
234           The device tree is then passed to the OS.
235
236 config OF_SYSTEM_SETUP
237         bool "Set up system-specific details in device tree before boot"
238         depends on OF_LIBFDT
239         help
240           This causes U-Boot to call ft_system_setup() before booting into
241           the Operating System. This function can set up various
242           system-specific information in the device tree for use by the OS.
243           The device tree is then passed to the OS.
244
245 config OF_STDOUT_VIA_ALIAS
246         bool "Update the device-tree stdout alias from U-Boot"
247         depends on OF_LIBFDT
248         help
249           This uses U-Boot's serial alias from the aliases node to update
250           the device tree passed to the OS. The "linux,stdout-path" property
251           in the chosen node is set to point to the correct serial node.
252           This option currently references CONFIG_CONS_INDEX, which is
253           incorrect when used with device tree as this option does not
254           exist / should not be used.
255
256 config SYS_EXTRA_OPTIONS
257         string "Extra Options (DEPRECATED)"
258         help
259           The old configuration infrastructure (= mkconfig + boards.cfg)
260           provided the extra options field. If you have something like
261           "HAS_BAR,BAZ=64", the optional options
262             #define CONFIG_HAS
263             #define CONFIG_BAZ  64
264           will be defined in include/config.h.
265           This option was prepared for the smooth migration from the old
266           configuration to Kconfig. Since this option will be removed sometime,
267           new boards should not use this option.
268
269 config SYS_TEXT_BASE
270         depends on SPARC || ARC || X86 || ARCH_UNIPHIER || ARCH_ZYNQMP || \
271                 (M68K && !TARGET_ASTRO_MCF5373L) || MICROBLAZE
272         depends on !EFI_APP
273         hex "Text Base"
274         help
275           TODO: Move CONFIG_SYS_TEXT_BASE for all the architecture
276
277 config SPL_LOAD_FIT
278         bool "Enable SPL loading U-Boot as a FIT"
279         depends on FIT
280         help
281           Normally with the SPL framework a legacy image is generated as part
282           of the build. This contains U-Boot along with information as to
283           where it should be loaded. This option instead enables generation
284           of a FIT (Flat Image Tree) which provides more flexibility. In
285           particular it can handle selecting from multiple device tree
286           and passing the correct one to U-Boot.
287
288 config SYS_CLK_FREQ
289         depends on ARC || ARCH_SUNXI
290         int "CPU clock frequency"
291         help
292           TODO: Move CONFIG_SYS_CLK_FREQ for all the architecture
293
294 endmenu         # Boot images
295
296 source "common/Kconfig"
297
298 source "cmd/Kconfig"
299
300 source "dts/Kconfig"
301
302 source "net/Kconfig"
303
304 source "drivers/Kconfig"
305
306 source "fs/Kconfig"
307
308 source "lib/Kconfig"
309
310 source "test/Kconfig"