blob: 9a0622154ad0befb28ba76509b6a310e7dfe089d [file] [log] [blame]
Masahiro Yamada9fadbc82014-09-22 19:59:05 +09001#
2# Device Tree Control
3#
Masahiro Yamada9fadbc82014-09-22 19:59:05 +09004
5config SUPPORT_OF_CONTROL
6 bool
7
8menu "Device Tree Control"
Masahiro Yamada9fadbc82014-09-22 19:59:05 +09009 depends on SUPPORT_OF_CONTROL
10
11config OF_CONTROL
12 bool "Run-time configuration via Device Tree"
13 help
14 This feature provides for run-time configuration of U-Boot
15 via a flattened device tree.
16
mario.six@gdsys.cc7e9b9d62017-02-22 16:07:22 +010017config OF_BOARD_FIXUP
18 bool "Board-specific manipulation of Device Tree"
19 help
20 In certain circumstances it is necessary to be able to modify
21 U-Boot's device tree (e.g. to delete device from it). This option
22 make the Device Tree writeable and provides a board-specific
23 "board_fix_fdt" callback (called during pre-relocation time), which
24 enables the board initialization to modifiy the Device Tree. The
25 modified copy is subsequently used by U-Boot after relocation.
26
Masahiro Yamada1e35f392015-08-12 07:31:54 +090027config SPL_OF_CONTROL
28 bool "Enable run-time configuration via Device Tree in SPL"
29 depends on SPL && OF_CONTROL
Simon Glass400d0402015-02-27 22:06:38 -070030 help
31 Some boards use device tree in U-Boot but only have 4KB of SRAM
32 which is not enough to support device tree. Enable this option to
33 allow such boards to be supported by U-Boot SPL.
34
Masahiro Yamada9fadbc82014-09-22 19:59:05 +090035choice
36 prompt "Provider of DTB for DT control"
37 depends on OF_CONTROL
38
39config OF_SEPARATE
40 bool "Separate DTB for DT control"
41 depends on !SANDBOX
42 help
43 If this option is enabled, the device tree will be built and
44 placed as a separate u-boot.dtb file alongside the U-Boot image.
45
46config OF_EMBED
47 bool "Embedded DTB for DT control"
48 help
49 If this option is enabled, the device tree will be picked up and
Simon Glassd9b64ea2015-08-31 18:47:52 -060050 built into the U-Boot image. This is suitable for local debugging
51 and development only and is not recommended for production devices.
52 Boards in the mainline U-Boot tree should not use it.
Masahiro Yamada9fadbc82014-09-22 19:59:05 +090053
Alex Deymo5b661ec2017-04-02 01:25:20 -070054config OF_BOARD
55 bool "Provided by the board at runtime"
56 depends on !SANDBOX
57 help
58 If this option is enabled, the device tree will be provided by
59 the board at runtime if the board supports it, instead of being
60 bundled with the image.
61
Masahiro Yamada9fadbc82014-09-22 19:59:05 +090062config OF_HOSTFILE
63 bool "Host filed DTB for DT control"
64 depends on SANDBOX
65 help
66 If this option is enabled, DTB will be read from a file on startup.
67 This is only useful for Sandbox. Use the -d flag to U-Boot to
68 specify the file to read.
69
70endchoice
71
Masahiro Yamada8c65b9d2014-09-22 19:59:06 +090072config DEFAULT_DEVICE_TREE
73 string "Default Device Tree for DT control"
Simon Glass644f5bc2016-02-22 22:55:44 -070074 depends on OF_CONTROL
Masahiro Yamada8c65b9d2014-09-22 19:59:06 +090075 help
76 This option specifies the default Device Tree used for DT control.
Robert P. J. Dayeb61df52014-10-21 16:44:32 -040077 It can be overridden from the command line:
Masahiro Yamada8c65b9d2014-09-22 19:59:06 +090078 $ make DEVICE_TREE=<device-tree-name>
79
Simon Glass963817b2016-02-22 22:55:57 -070080config OF_LIST
81 string "List of device tree files to include for DT control"
82 depends on SPL_LOAD_FIT
Michal Simek9b2e95a2016-05-04 15:14:11 +020083 default DEFAULT_DEVICE_TREE
Simon Glass963817b2016-02-22 22:55:57 -070084 help
85 This option specifies a list of device tree files to use for DT
86 control. These will be packaged into a FIT. At run-time, SPL will
87 select the correct DT to use by examining the hardware (e.g.
88 reading a board ID value). This is a list of device tree files
89 (without the directory or .dtb suffix) separated by <space>.
90
Simon Glass89caf332015-06-23 15:38:29 -060091config OF_SPL_REMOVE_PROPS
92 string "List of device tree properties to drop for SPL"
Masahiro Yamadaddb9aa972015-08-28 20:28:42 +090093 depends on SPL_OF_CONTROL
Vikas Manochab6cca7d2017-03-24 14:47:44 -070094 default "interrupt-parent" if SPL_PINCTRL && SPL_CLK
95 default "clocks clock-names interrupt-parent" if SPL_PINCTRL
Masahiro Yamadaf03811c2016-02-03 20:51:36 +090096 default "pinctrl-0 pinctrl-names interrupt-parent" if SPL_CLK
Simon Glass89caf332015-06-23 15:38:29 -060097 default "pinctrl-0 pinctrl-names clocks clock-names interrupt-parent"
98 help
99 Since SPL normally runs in a reduced memory space, the device tree
100 is cut down to only what is needed to load and start U-Boot. Only
101 nodes marked with the property "u-boot,dm-pre-reloc" will be
102 included. In addition, some properties are not used by U-Boot and
103 can be discarded. This option defines the list of properties to
104 discard.
105
Simon Glass7bc65f32016-07-04 11:58:06 -0600106config SPL_OF_PLATDATA
107 bool "Generate platform data for use in SPL"
108 depends on SPL_OF_CONTROL
109 help
110 For very constrained SPL environments the overhead of decoding
111 device tree nodes and converting their contents into platform data
112 is too large. This overhead includes libfdt code as well as the
113 device tree contents itself. The latter is fairly compact, but the
114 former can add 3KB or more to a Thumb 2 Image.
115
116 This option enables generation of platform data from the device
117 tree as C code. This code creates devices using U_BOOT_DEVICE()
118 declarations. The benefit is that it allows driver code to access
119 the platform data directly in C structures, avoidin the libfdt
120 overhead.
121
122 This option works by generating C structure declarations for each
123 compatible string, then adding platform data and U_BOOT_DEVICE
124 declarations for each node. See README.platdata for more
125 information.
126
Masahiro Yamada9fadbc82014-09-22 19:59:05 +0900127endmenu