doc/driver-model/fdt-fixup.txt

1 Pre-relocation device tree manipulation
17 "extensions" of each other, where one device only differs from another in the
23 addition of the daughter board to the device realizes the "extension" of
24 functionality to the device described previously.
27 variations of the device. This means that the software somehow needs to cope
32 device tree overlay mechanism: There exists one "base" device tree, which
34 device. At the start of the kernel, the presence and type of the daughter
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
50 after the driver model has been initialized. While migrating to a live device
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
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  |
102 	/* Collect information about device's hardware and store them in e.g.
105 	/* Do device tree manipulation using the values previously collected */
111 detected components are added to the device tree, as well as a "subtractive"
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
129 * The application of device tree overlay should be possible in board_fixup_fdt,