doc/driver-model/fdt-fixup.txt

1 Pre-relocation device tree manipulation
32 device tree overlay mechanism: There exists one "base" device tree, which
35 boards is then detected, and the corresponding device tree overlays are applied
42 In the U-Boot boot loader, support for device tree overlays has recently been
43 integrated, and is used on some boards to alter the device tree that is later
44 passed to Linux. But since U-Boot's driver model, which is device tree-based as
46 device tree starts cropping up in U-Boot itself as well.
48 An additional problem with the device tree in U-Boot is that it is read-only,
49 and the current mechanisms don't allow easy manipulation of the device tree
51 tree (at least after the relocation) would greatly simplify the solution of
56 call-back function, which is passed a writeable pointer to the device tree.
57 This function is called before the device tree is relocated, and specifically
59 "sees" all modifications to the device tree made in this function. Furthermore,
67 To take advantage of the pre-relocation device tree manipulation mechanism,
73 The passed-in void pointer is a writeable pointer to the device tree, which can
74 be used to manipulate the device tree using e.g. functions from
76 successful execution of the device tree manipulation or something else for a
84 Device Tree Control
85 -> [*] Board-specific manipulation of Device Tree
88 | WARNING: The actual manipulation of the device tree has  |
91 | changes made to the device tree either, its references   |
92 | into the device tree will be invalid after manipulating  |
105 	/* Do device tree manipulation using the values previously collected */
111 detected components are added to the device tree, as well as a "subtractive"
112 approach, meaning that nodes for absent components are removed from the tree,
121 subsequently deactivated in the device tree if they are not present.
123 Note that the dm_i2c_simple_probe function does not use the device tree, hence
124 it is safe to call it after the tree has already been manipulated.
129 * The application of device tree overlay should be possible in board_fixup_fdt,