blob: 00c0aeff893b7a58a716e099892e9d370b41f4ad [file] [log] [blame]
Masahiro Yamada783e6a72014-09-22 19:59:05 +09001#
2# Device Tree Control
3#
Masahiro Yamada783e6a72014-09-22 19:59:05 +09004
5config SUPPORT_OF_CONTROL
6 bool
7
Masahiro Yamadad6a0c782017-10-17 13:42:44 +09008config PYLIBFDT
9 bool
10
11config DTOC
12 bool
13 select PYLIBFDT
14
15config BINMAN
16 bool
17 select DTOC
18
Masahiro Yamada783e6a72014-09-22 19:59:05 +090019menu "Device Tree Control"
Masahiro Yamada783e6a72014-09-22 19:59:05 +090020 depends on SUPPORT_OF_CONTROL
21
22config OF_CONTROL
23 bool "Run-time configuration via Device Tree"
Simon Glassd727ace2023-02-01 13:20:27 -070024 select OF_LIBFDT
25 select OF_REAL
Masahiro Yamada783e6a72014-09-22 19:59:05 +090026 help
27 This feature provides for run-time configuration of U-Boot
28 via a flattened device tree.
29
Simon Glasseaad01a2021-08-07 07:24:02 -060030config OF_REAL
Simon Glass414cc152021-08-07 07:24:03 -060031 bool
Simon Glasseaad01a2021-08-07 07:24:02 -060032 help
33 Indicates that a real devicetree is available which can be accessed
34 at runtime. This means that dev_read_...() functions can be used to
35 read data from the devicetree for each device. This is true if
36 OF_CONTROL is enabled in U-Boot proper.
37
mario.six@gdsys.cc2a792752017-02-22 16:07:22 +010038config OF_BOARD_FIXUP
39 bool "Board-specific manipulation of Device Tree"
40 help
41 In certain circumstances it is necessary to be able to modify
42 U-Boot's device tree (e.g. to delete device from it). This option
43 make the Device Tree writeable and provides a board-specific
44 "board_fix_fdt" callback (called during pre-relocation time), which
45 enables the board initialization to modifiy the Device Tree. The
46 modified copy is subsequently used by U-Boot after relocation.
47
Masahiro Yamadadffb86e2015-08-12 07:31:54 +090048config SPL_OF_CONTROL
49 bool "Enable run-time configuration via Device Tree in SPL"
50 depends on SPL && OF_CONTROL
Sean Anderson327bb3b2019-12-17 21:40:09 -050051 select SPL_OF_LIBFDT if !SPL_OF_PLATDATA
Simon Glasseaad01a2021-08-07 07:24:02 -060052 select SPL_OF_REAL if !SPL_OF_PLATDATA
Simon Glass2860f032015-02-27 22:06:38 -070053 help
54 Some boards use device tree in U-Boot but only have 4KB of SRAM
Walter Lozanoc9acae32019-10-22 11:50:19 -030055 which is not enough to support device tree. Disable this option to
Simon Glass2860f032015-02-27 22:06:38 -070056 allow such boards to be supported by U-Boot SPL.
57
Philipp Tomsichf291ce12017-06-29 11:11:21 +020058config TPL_OF_CONTROL
59 bool "Enable run-time configuration via Device Tree in TPL"
60 depends on TPL && OF_CONTROL
Sean Anderson327bb3b2019-12-17 21:40:09 -050061 select TPL_OF_LIBFDT if !TPL_OF_PLATDATA
Simon Glasseaad01a2021-08-07 07:24:02 -060062 select TPL_OF_REAL if !TPL_OF_PLATDATA
Philipp Tomsichf291ce12017-06-29 11:11:21 +020063 help
64 Some boards use device tree in U-Boot but only have 4KB of SRAM
65 which is not enough to support device tree. Enable this option to
66 allow such boards to be supported by U-Boot TPL.
67
Simon Glass747093d2022-04-30 00:56:53 -060068config VPL_OF_CONTROL
69 bool "Enable run-time configuration via Device Tree in VPL"
70 depends on VPL && OF_CONTROL
71 default y if SPL_OF_CONTROL
72 help
73 Some boards use device tree in U-Boot but only have 4KB of SRAM
74 which is not enough to support device tree. Enable this option to
75 allow such boards to be supported by U-Boot VPL.
76
Simon Glass5e060d82017-05-18 20:08:53 -060077config OF_LIVE
78 bool "Enable use of a live tree"
Bin Mengced4c312021-02-03 21:20:03 +080079 depends on DM && OF_CONTROL
Simon Glass5e060d82017-05-18 20:08:53 -060080 help
81 Normally U-Boot uses a flat device tree which saves space and
82 avoids the need to unpack the tree before use. However a flat
Michal Simek4adc6602018-08-17 10:16:36 +020083 tree does not support modification from within U-Boot since it
Simon Glass5e060d82017-05-18 20:08:53 -060084 can invalidate driver-model device tree offsets. This option
85 enables a live tree which is available after relocation,
86 and can be adjusted as needed.
87
Masahiro Yamada783e6a72014-09-22 19:59:05 +090088choice
89 prompt "Provider of DTB for DT control"
90 depends on OF_CONTROL
91
92config OF_SEPARATE
93 bool "Separate DTB for DT control"
Masahiro Yamada783e6a72014-09-22 19:59:05 +090094 help
95 If this option is enabled, the device tree will be built and
96 placed as a separate u-boot.dtb file alongside the U-Boot image.
97
98config OF_EMBED
99 bool "Embedded DTB for DT control"
100 help
101 If this option is enabled, the device tree will be picked up and
Simon Glass3d3f60c2015-08-31 18:47:52 -0600102 built into the U-Boot image. This is suitable for local debugging
103 and development only and is not recommended for production devices.
104 Boards in the mainline U-Boot tree should not use it.
Masahiro Yamada783e6a72014-09-22 19:59:05 +0900105
Simon Glass836eac72021-12-16 20:59:21 -0700106endchoice
107
Alex Deymo82f766d2017-04-02 01:25:20 -0700108config OF_BOARD
Ilias Apalodimas2e8d2f82021-10-12 00:00:13 +0300109 bool "Provided by the board (e.g a previous loader) at runtime"
Simon Glass275b4832021-12-16 20:59:35 -0700110 default y if SANDBOX || OF_HAS_PRIOR_STAGE
Alex Deymo82f766d2017-04-02 01:25:20 -0700111 help
Simon Glass275b4832021-12-16 20:59:35 -0700112 If this option is enabled, the device tree is provided at runtime by
113 a custom function called board_fdt_blob_setup(). The board must
114 implement this function if it wishes to provide special behaviour.
Alex Deymo82f766d2017-04-02 01:25:20 -0700115
Simon Glass275b4832021-12-16 20:59:35 -0700116 With this option, the device tree build by U-Boot may be overridden or
117 ignored. See OF_HAS_PRIOR_STAGE.
118
119 Note: Boards which use this to handle a device tree passed from an
120 earlier stage should enable OF_HAS_PRIOR_STAGE.
121
122config OF_HAS_PRIOR_STAGE
123 bool
124 help
125 Indicates that a prior stage of the firmware (before U-Boot proper)
126 makes use of device tree and this board normally boots with that prior
127 stage, that provides a devicetree to U-Boot.
128
129 This means that the device tree built in U-Boot should not be packaged
130 in the firmware image. Instead, the prior stage's device tree should
131 be so packaged. At runtime, the prior stage reads this, does any
132 necessary fix-ups, then passes it to U-Boot. See OF_BOARD.
133
134 This option does not preclude using the U-Boot device tree, e.g. for
135 development purposes, but it is not recommended, and likely will not
136 even work, for production systems.
137
138 Note: This option must be set in Kconfig and cannot be enabled or
139 disabled in the board's defconfig file.
Masahiro Yamada783e6a72014-09-22 19:59:05 +0900140
Simon Glassb7d8e852021-12-16 20:59:38 -0700141config OF_OMIT_DTB
142 bool "Omit the device tree output when building"
143 default y if OF_HAS_PRIOR_STAGE && !BINMAN
144 help
145 As a special case, avoid writing a device tree file u-boot.dtb when
146 building. Also don't include that file in u-boot.bin
147
148 This is used for boards which normally provide a devicetree via a
149 runtime mechanism (such as OF_BOARD), to avoid confusion.
150
Masahiro Yamadaf1ef2b62014-09-22 19:59:06 +0900151config DEFAULT_DEVICE_TREE
152 string "Default Device Tree for DT control"
Simon Glass70d41092016-02-22 22:55:44 -0700153 depends on OF_CONTROL
Masahiro Yamadaf1ef2b62014-09-22 19:59:06 +0900154 help
155 This option specifies the default Device Tree used for DT control.
Robert P. J. Day5699ea62014-10-21 16:44:32 -0400156 It can be overridden from the command line:
Masahiro Yamadaf1ef2b62014-09-22 19:59:06 +0900157 $ make DEVICE_TREE=<device-tree-name>
158
Rasmus Villemoesa77f4682021-11-21 14:52:51 +0100159config DEVICE_TREE_INCLUDES
160 string "Extra .dtsi files to include when building DT control"
161 depends on OF_CONTROL
162 help
163 U-Boot's control .dtb is usually built from an in-tree .dts
164 file, plus (if available) an in-tree U-Boot-specific .dtsi
165 file. This option specifies a space-separated list of extra
166 .dtsi files that will also be used.
167
Simon Glasscdf17242016-02-22 22:55:57 -0700168config OF_LIST
Rasmus Villemoes3609e1d2022-01-10 14:34:41 +0100169 string "List of device tree files to include for DT control" if SPL_LOAD_FIT || MULTI_DTB_FIT
170 depends on OF_CONTROL
Michal Simekc409bd02016-05-04 15:14:11 +0200171 default DEFAULT_DEVICE_TREE
Simon Glasscdf17242016-02-22 22:55:57 -0700172 help
173 This option specifies a list of device tree files to use for DT
Michal Simek1be82af2023-05-17 09:17:16 +0200174 control. These will be packaged into a FIT. At run-time, U-Boot
Cooper Jr., Franklind9797402017-06-16 17:25:09 -0500175 or SPL will select the correct DT to use by examining the
176 hardware (e.g. reading a board ID value). This is a list of
177 device tree files (without the directory or .dtb suffix)
178 separated by <space>.
Simon Glasscdf17242016-02-22 22:55:57 -0700179
Jean-Jacques Hiblot557bc972019-10-22 16:39:21 +0200180config OF_OVERLAY_LIST
181 string "List of device tree overlays to include for DT control"
182 depends on SPL_LOAD_FIT_APPLY_OVERLAY
183 help
184 This option specifies a list of device tree overlays to use for DT
185 control. This option can then be used by a FIT generator to include
186 the overlays in the FIT image.
187
Marek Vasut95f4bbd2019-03-08 16:06:55 +0100188choice
Baruch Siach574e3862019-10-07 15:05:47 +0300189 prompt "OF LIST compression"
Marek Vasut95f4bbd2019-03-08 16:06:55 +0100190 depends on MULTI_DTB_FIT
191 default MULTI_DTB_FIT_NO_COMPRESSION
192
193config MULTI_DTB_FIT_LZO
194 bool "LZO"
195 depends on SYS_MALLOC_F
196 select LZO
197 help
198 Compress the FIT image containing the DTBs available for the SPL
199 using LZO compression. (requires lzop on host).
200
201config MULTI_DTB_FIT_GZIP
202 bool "GZIP"
203 depends on SYS_MALLOC_F
204 select GZIP
205 help
206 Compress the FIT image containing the DTBs available for the SPL
207 using GZIP compression. (requires gzip on host)
208
209config MULTI_DTB_FIT_NO_COMPRESSION
210 bool "No compression"
211 help
212 Do not compress the FIT image containing the DTBs available for the SPL.
213 Use this options only if LZO is not available and the DTBs are very small.
214endchoice
215
216choice
217 prompt "Location of uncompressed DTBs"
218 depends on (MULTI_DTB_FIT_GZIP || MULTI_DTB_FIT_LZO)
219 default MULTI_DTB_FIT_DYN_ALLOC if SYS_MALLOC_F
220
221config MULTI_DTB_FIT_DYN_ALLOC
222 bool "Dynamically allocate the memory"
223 depends on SYS_MALLOC_F
224
225config MULTI_DTB_FIT_USER_DEFINED_AREA
226 bool "User-defined location"
227endchoice
228
229config MULTI_DTB_FIT_UNCOMPRESS_SZ
230 hex "Size of memory reserved to uncompress the DTBs"
Marek Vasut95f4bbd2019-03-08 16:06:55 +0100231 default 0x8000
232 help
233 This is the size of this area where the DTBs are uncompressed.
234 If this area is dynamically allocated, make sure that
235 SYS_MALLOC_F_LEN is big enough to contain it.
236
237config MULTI_DTB_FIT_USER_DEF_ADDR
238 hex "Address of memory where dtbs are uncompressed"
239 depends on MULTI_DTB_FIT_USER_DEFINED_AREA
240 help
241 the FIT image containing the DTBs is uncompressed in an area defined
242 at compilation time. This is the address of this area. It must be
243 aligned on 2-byte boundary.
Jean-Jacques Hiblot11955592017-09-15 12:57:24 +0200244
245config DTB_RESELECT
246 bool "Support swapping dtbs at a later point in boot"
247 depends on MULTI_DTB_FIT
248 help
249 It is possible during initial boot you may need to use a generic
250 dtb until you can fully determine the board your running on. This
251 config allows boards to implement a function at a later point
252 during boot to switch to the "correct" dtb.
253
254config MULTI_DTB_FIT
255 bool "Support embedding several DTBs in a FIT image for u-boot"
256 help
Michal Simek1be82af2023-05-17 09:17:16 +0200257 This option provides hooks to allow U-Boot to parse an
Jean-Jacques Hiblot11955592017-09-15 12:57:24 +0200258 appended FIT image and enable board specific code to then select
259 the correct DTB to be used. Use this if you need to support
260 multiple DTBs but don't use the SPL.
261
Jean-Jacques Hiblot2f57c952017-09-15 12:57:32 +0200262
263config SPL_MULTI_DTB_FIT
Simon Glasseaad01a2021-08-07 07:24:02 -0600264 depends on SPL_LOAD_FIT && SPL_OF_REAL
Jean-Jacques Hiblot2f57c952017-09-15 12:57:32 +0200265 bool "Support embedding several DTBs in a FIT image for the SPL"
266 help
267 This option provides the SPL with the ability to select its own
268 DTB at runtime from an appended FIT image containing several DTBs.
269 This allows using the same SPL binary on multiple platforms.
270 The primary purpose is to handle different versions of
271 the same platform without tweaking the platform code if the
272 differences can be expressed in the DTBs (common examples are: bus
273 capabilities, pad configurations).
274
275config SPL_OF_LIST
Rasmus Villemoes3609e1d2022-01-10 14:34:41 +0100276 string "List of device tree files to include for DT control in SPL" if SPL_MULTI_DTB_FIT
277 depends on SPL_OF_CONTROL
Jean-Jacques Hiblot2f57c952017-09-15 12:57:32 +0200278 default OF_LIST
279 help
280 This option specifies a list of device tree files to use for DT
281 control in the SPL. These will be packaged into a FIT. At run-time,
282 the SPL will select the correct DT to use by examining the
283 hardware (e.g. reading a board ID value). This is a list of
284 device tree files (without the directory or .dtb suffix)
285 separated by <space>.
286
287choice
288 prompt "SPL OF LIST compression"
289 depends on SPL_MULTI_DTB_FIT
290 default SPL_MULTI_DTB_FIT_LZO
291
292config SPL_MULTI_DTB_FIT_LZO
293 bool "LZO"
294 depends on SYS_MALLOC_F
295 select SPL_LZO
296 help
297 Compress the FIT image containing the DTBs available for the SPL
298 using LZO compression. (requires lzop on host).
299
300config SPL_MULTI_DTB_FIT_GZIP
301 bool "GZIP"
302 depends on SYS_MALLOC_F
303 select SPL_GZIP
304 help
305 Compress the FIT image containing the DTBs available for the SPL
306 using GZIP compression. (requires gzip on host)
307
308config SPL_MULTI_DTB_FIT_NO_COMPRESSION
309 bool "No compression"
310 help
311 Do not compress the FIT image containing the DTBs available for the SPL.
312 Use this options only if LZO is not available and the DTBs are very small.
313endchoice
314
315choice
Michal Simekb8448052018-07-23 08:38:56 +0200316 prompt "Location of uncompressed DTBs"
Jean-Jacques Hiblot2f57c952017-09-15 12:57:32 +0200317 depends on (SPL_MULTI_DTB_FIT_GZIP || SPL_MULTI_DTB_FIT_LZO)
318 default SPL_MULTI_DTB_FIT_DYN_ALLOC if SYS_MALLOC_F
319
320config SPL_MULTI_DTB_FIT_DYN_ALLOC
321 bool "Dynamically allocate the memory"
322 depends on SYS_MALLOC_F
323
324config SPL_MULTI_DTB_FIT_USER_DEFINED_AREA
325 bool "User-defined location"
326endchoice
327
328config SPL_MULTI_DTB_FIT_UNCOMPRESS_SZ
329 hex "Size of memory reserved to uncompress the DTBs"
330 depends on (SPL_MULTI_DTB_FIT_GZIP || SPL_MULTI_DTB_FIT_LZO)
331 default 0x8000
332 help
333 This is the size of this area where the DTBs are uncompressed.
334 If this area is dynamically allocated, make sure that
335 SPL_SYS_MALLOC_F_LEN is big enough to contain it.
336
337config SPL_MULTI_DTB_FIT_USER_DEF_ADDR
338 hex "Address of memory where dtbs are uncompressed"
339 depends on SPL_MULTI_DTB_FIT_USER_DEFINED_AREA
340 help
341 the FIT image containing the DTBs is uncompressed in an area defined
342 at compilation time. This is the address of this area. It must be
343 aligned on 2-byte boundary.
344
Simon Glassc74e0342023-02-13 08:56:32 -0700345config OF_TAG_MIGRATE
346 bool "Ease migration from old device trees with u-boot,dm- tags"
347 default y
348 help
349 U-Boot moved over to use new tags to mark device tree nodes which need
350 to be processed in SPL, before relocation, etc. Enable this option to
351 detect old tags and handle them.
352
353 Note: This option will be removed after the 2023.07 release.
354
Simon Glassfa78e0a2015-06-23 15:38:29 -0600355config OF_SPL_REMOVE_PROPS
356 string "List of device tree properties to drop for SPL"
Masahiro Yamada897705e2015-08-28 20:28:42 +0900357 depends on SPL_OF_CONTROL
Michal Simekf00d89f2019-02-22 10:50:23 +0100358 default "interrupt-parent interrupts" if SPL_PINCTRL && SPL_CLK
359 default "clocks clock-names interrupt-parent interrupts" if SPL_PINCTRL
360 default "pinctrl-0 pinctrl-names interrupt-parent interrupts" if SPL_CLK
361 default "pinctrl-0 pinctrl-names clocks clock-names interrupt-parent interrupts"
Simon Glassfa78e0a2015-06-23 15:38:29 -0600362 help
363 Since SPL normally runs in a reduced memory space, the device tree
364 is cut down to only what is needed to load and start U-Boot. Only
Simon Glasse316fba2023-02-13 08:56:34 -0700365 nodes marked with the property "bootph-all" will be
Simon Glassfa78e0a2015-06-23 15:38:29 -0600366 included. In addition, some properties are not used by U-Boot and
367 can be discarded. This option defines the list of properties to
368 discard.
369
Anatolij Gustschin43b6e382020-01-12 15:57:42 +0100370config OF_DTB_PROPS_REMOVE
371 bool "Enable removal of device tree properties"
372 depends on OF_CONTROL
373 help
374 Some boards have restricted amount of storage for U-Boot image.
375 If the generated binary doesn't fit into available image storage,
376 the built-in device tree could probably be cut down by removing
377 some not required device tree properties to reduce the image size.
378 Enable this option and define the properties to be removed in the
379 CONFIG_OF_REMOVE_PROPS list. Do not enable this option if you must
380 pass the built-in DTB directly to the kernel!
381
382config OF_REMOVE_PROPS
383 string "List of device tree properties to drop"
384 depends on OF_DTB_PROPS_REMOVE
385 default "interrupt-parent interrupts" if PINCTRL
386 help
387 Some properties are not used by U-Boot and can be discarded.
388 This option defines the list of properties to discard.
389
Simon Glass2789ddb2016-07-04 11:58:06 -0600390config SPL_OF_PLATDATA
391 bool "Generate platform data for use in SPL"
392 depends on SPL_OF_CONTROL
Masahiro Yamadad6a0c782017-10-17 13:42:44 +0900393 select DTOC
Simon Glassab933d82021-03-15 17:25:36 +1300394 select SPL_OF_PLATDATA_DRIVER_RT if !SPL_OF_PLATDATA_INST
Simon Glass2789ddb2016-07-04 11:58:06 -0600395 help
396 For very constrained SPL environments the overhead of decoding
397 device tree nodes and converting their contents into platform data
398 is too large. This overhead includes libfdt code as well as the
399 device tree contents itself. The latter is fairly compact, but the
400 former can add 3KB or more to a Thumb 2 Image.
401
402 This option enables generation of platform data from the device
Simon Glass20e442a2020-12-28 20:34:54 -0700403 tree as C code. This code creates devices using U_BOOT_DRVINFO()
Simon Glass2789ddb2016-07-04 11:58:06 -0600404 declarations. The benefit is that it allows driver code to access
405 the platform data directly in C structures, avoidin the libfdt
406 overhead.
407
408 This option works by generating C structure declarations for each
Simon Glass20e442a2020-12-28 20:34:54 -0700409 compatible string, then adding platform data and U_BOOT_DRVINFO
Simon Goldschmidt3600b462019-01-16 20:40:18 +0100410 declarations for each node. See of-plat.txt for more information.
Simon Glass2789ddb2016-07-04 11:58:06 -0600411
Simon Glasseaad01a2021-08-07 07:24:02 -0600412config SPL_OF_REAL
Sean Andersoneaf73852023-10-14 16:47:46 -0400413 bool "Support a real devicetree in SPL" if SANDBOX
414 depends on SPL_OF_CONTROL
415 select SPL_OF_LIBFDT
Simon Glasseaad01a2021-08-07 07:24:02 -0600416 help
417 Indicates that a real devicetree is available which can be accessed
418 at runtime. This means that dev_read_...() functions can be used to
Sean Andersoneaf73852023-10-14 16:47:46 -0400419 read data from the devicetree for each device. You do not need to
420 enable this option if you have enabled SPL_OF_PLATDATA.
Simon Glasseaad01a2021-08-07 07:24:02 -0600421
Simon Glass5a1b25c2021-02-03 06:01:13 -0700422if SPL_OF_PLATDATA
423
Simon Glasse41651f2020-10-03 11:31:35 -0600424config SPL_OF_PLATDATA_PARENT
425 bool "Support parent information in devices"
Simon Glasse41651f2020-10-03 11:31:35 -0600426 default y
427 help
428 Generally it is useful to be able to access the parent of a device
429 with of-platdata. To save space this can be disabled, but in that
430 case dev_get_parent() will always return NULL;
431
Simon Glass5a1b25c2021-02-03 06:01:13 -0700432config SPL_OF_PLATDATA_INST
433 bool "Declare devices at build time"
434 help
435 Declare devices as udevice instances so that they do not need to be
436 bound when U-Boot starts. This can save time and code space.
437
Simon Glass1ef3af32021-03-15 17:25:15 +1300438config SPL_OF_PLATDATA_NO_BIND
439 bool "Don't allow run-time binding of devices"
440 depends on SPL_OF_PLATDATA_INST
441 default y
442 help
443 This removes the ability to bind devices at run time, thus saving
444 some code space in U-Boot. This can be disabled if binding is needed,
445 at the code of some code size increase.
446
Simon Glass95a58252021-03-15 17:25:35 +1300447config SPL_OF_PLATDATA_RT
448 bool "Use a separate struct for device runtime data"
449 depends on SPL_OF_PLATDATA_INST
450 default y
451 help
452 For systems running SPL from read-only memory it is convenient to
453 separate out the runtime information, so that the devices don't need
454 to be copied before being used. This moves the read-write parts of
455 struct udevice (at present just the flags) into a separate struct,
456 which is allocated at runtime.
457
Simon Glassab933d82021-03-15 17:25:36 +1300458config SPL_OF_PLATDATA_DRIVER_RT
459 bool
460 help
461 Use a separate struct for driver runtime data.
462
463 This enables the driver_rt information, used with of-platdata when
464 of-platdata-inst is not used. It allows finding devices by their
465 driver data.
466
Simon Glass5a1b25c2021-02-03 06:01:13 -0700467endif
468
Simon Glasseaad01a2021-08-07 07:24:02 -0600469config TPL_OF_REAL
470 bool
471 help
472 Indicates that a real devicetree is available which can be accessed
473 at runtime. This means that dev_read_...() functions can be used to
474 read data from the devicetree for each device. This is true if
475 TPL_OF_CONTROL is enabled and not TPL_OF_PLATDATA
476
Philipp Tomsichf291ce12017-06-29 11:11:21 +0200477config TPL_OF_PLATDATA
478 bool "Generate platform data for use in TPL"
479 depends on TPL_OF_CONTROL
Masahiro Yamadad6a0c782017-10-17 13:42:44 +0900480 select DTOC
Simon Glassab933d82021-03-15 17:25:36 +1300481 select TPL_OF_PLATDATA_DRIVER_RT if !TPL_OF_PLATDATA_INST
Philipp Tomsichf291ce12017-06-29 11:11:21 +0200482 help
483 For very constrained SPL environments the overhead of decoding
484 device tree nodes and converting their contents into platform data
485 is too large. This overhead includes libfdt code as well as the
486 device tree contents itself. The latter is fairly compact, but the
487 former can add 3KB or more to a Thumb 2 Image.
488
489 This option enables generation of platform data from the device
Simon Glass20e442a2020-12-28 20:34:54 -0700490 tree as C code. This code creates devices using U_BOOT_DRVINFO()
Philipp Tomsichf291ce12017-06-29 11:11:21 +0200491 declarations. The benefit is that it allows driver code to access
492 the platform data directly in C structures, avoidin the libfdt
493 overhead.
494
495 This option works by generating C structure declarations for each
Simon Glass20e442a2020-12-28 20:34:54 -0700496 compatible string, then adding platform data and U_BOOT_DRVINFO
Simon Goldschmidt3600b462019-01-16 20:40:18 +0100497 declarations for each node. See of-plat.txt for more information.
Philipp Tomsichf291ce12017-06-29 11:11:21 +0200498
Simon Glass5a1b25c2021-02-03 06:01:13 -0700499if TPL_OF_PLATDATA
500
Simon Glasse41651f2020-10-03 11:31:35 -0600501config TPL_OF_PLATDATA_PARENT
502 bool "Support parent information in devices"
Simon Glasse41651f2020-10-03 11:31:35 -0600503 default y
504 help
505 Generally it is useful to be able to access the parent of a device
506 with of-platdata. To save space this can be disabled, but in that
507 case dev_get_parent() will always return NULL;
508
Simon Glass5a1b25c2021-02-03 06:01:13 -0700509config TPL_OF_PLATDATA_INST
510 bool "Declare devices at build time"
511
512 help
513 Declare devices as udevice instances so that they do not need to be
514 bound when U-Boot starts. This can save time and code space.
515
Simon Glass1ef3af32021-03-15 17:25:15 +1300516config TPL_OF_PLATDATA_NO_BIND
517 bool "Don't allow run-time binding of devices"
518 depends on TPL_OF_PLATDATA_INST
519 default y
520 help
521 This removes the ability to bind devices at run time, thus saving
522 some code space in U-Boot. This can be disabled if binding is needed,
523 at the code of some code size increase.
524
Simon Glass95a58252021-03-15 17:25:35 +1300525config TPL_OF_PLATDATA_RT
526 bool "Use a separate struct for device runtime data"
527 depends on TPL_OF_PLATDATA_INST
528 default y
529 help
530 For systems running TPL from read-only memory it is convenient to
531 separate out the runtime information, so that the devices don't need
532 to be copied before being used. This moves the read-write parts of
533 struct udevice (at present just the flags) into a separate struct,
534 which is allocated at runtime.
535
Simon Glassab933d82021-03-15 17:25:36 +1300536config TPL_OF_PLATDATA_DRIVER_RT
537 bool
538 help
539 Use a separate struct for driver runtime data.
540
541 This enables the driver_rt information, used with of-platdata when
542 of-platdata-inst is not used. It allows finding devices by their
543 driver data.
544
Simon Glass5a1b25c2021-02-03 06:01:13 -0700545endif
546
Simon Glass747093d2022-04-30 00:56:53 -0600547config VPL_OF_REAL
548 def_bool y
Tom Rini13ce3512022-06-08 08:24:40 -0400549 depends on VPL
Simon Glass747093d2022-04-30 00:56:53 -0600550 help
551 Indicates that a real devicetree is available which can be accessed
552 at runtime. This means that dev_read_...() functions can be used to
553 read data from the devicetree for each device. This is true if
554 TPL_OF_CONTROL is enabled and not TPL_OF_PLATDATA
555
Masahiro Yamada783e6a72014-09-22 19:59:05 +0900556endmenu