Greg Kroah-Hartman
598cf27219
Link: https://lore.kernel.org/r/20260217200002.683975158@linuxfoundation.org Tested-by: Florian Fainelli <florian.fainelli@broadcom.com> Tested-by: Takeshi Ogasawara <takeshi.ogasawara@futuring-girl.com> Tested-by: Peter Schneider <pschneider1968@googlemail.com> Tested-by: Jon Hunter <jonathanh@nvidia.com> Tested-by: Salvatore Bonaccorso <carnil@debian.org> Tested-by: Brett A C Sheffield <bacs@librecast.net> Tested-by: Mark Brown <broonie@kernel.org> Tested-by: Luna Jernberg <droidbittin@gmail.com> Tested-by: Ronald Warsow <rwarsow@gmx.de> Tested-by: Justin M. Forbes <jforbes@fedoraproject.org> Tested-by: Ron Economos <re@w6rz.net> Tested-by: Miguel Ojeda <ojeda@kernel.org> Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
28 lines
1.1 KiB
ReStructuredText
28 lines
1.1 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0
|
|
|
|
=================================
|
|
Devicetree Dynamic Resolver Notes
|
|
=================================
|
|
|
|
This document describes the implementation of the in-kernel
|
|
DeviceTree resolver, residing in drivers/of/resolver.c
|
|
|
|
How the resolver works
|
|
----------------------
|
|
|
|
The resolver is given as an input an arbitrary tree compiled with the
|
|
proper dtc option and having a /plugin/ tag. This generates the
|
|
appropriate __fixups__ & __local_fixups__ nodes.
|
|
|
|
In sequence the resolver works by the following steps:
|
|
|
|
1. Get the maximum device tree phandle value from the live tree + 1.
|
|
2. Adjust all the local phandles of the tree to resolve by that amount.
|
|
3. Using the __local__fixups__ node information adjust all local references
|
|
by the same amount.
|
|
4. For each property in the __fixups__ node locate the node it references
|
|
in the live tree. This is the label used to tag the node.
|
|
5. Retrieve the phandle of the target of the fixup.
|
|
6. For each fixup in the property locate the node:property:offset location
|
|
and replace it with the phandle value.
|