1 # SPDX-License-Identifier: GPL-2.0+
15 # Records the device-tree files known to binman, keyed by filename (e.g.
16 # 'u-boot-spl.dtb')
22 # True to use fake device-tree files for testing (see U_BOOT_DTB_DATA in
36     """Get the Fdt object for a particular device-tree filename
38     Binman keeps track of at least one device-tree file called u-boot.dtb but
43         fname: Filename to look up (e.g. 'u-boot.dtb').
56         fname: Filename to look up (e.g. 'u-boot.dtb').
71         fname: Filename to look up (e.g. 'u-boot.dtb').
120     At present there is only one, that for U-Boot proper.
133     # where Entry_blob_dtb can find them. We can ignore 'u-boot.dtb'
134     # since it is assumed to be the one passed in with options.dt, and
138     fdt_files['u-boot.dtb'] = dtb
143         fdt_subset.discard('u-boot.dtb')
157         Device trees being used (U-Boot proper, SPL, TPL)
163 def GetUpdateNodes(node):  argument
166     The property referenced by this node is added to any device trees which
167     have the given node. Due to removable of unwanted notes, SPL and TPL may
168     not have this node.
171         node: Node object in the main device tree to look up
174         Node objects in each device tree that is in use (U-Boot proper, which
175             is node, SPL and TPL)
177     yield node
179         if dtb != node.GetFdt():
180             other_node = dtb.GetNode(node.path)
184 def AddZeroProp(node, prop):  argument
190     for n in GetUpdateNodes(node):
193 def AddSubnode(node, name):  argument
194     """Add a new subnode to a node in affected device trees
197         node: Node to add to
198         name: name of node to add
204     for n in GetUpdateNodes(node):
210 def AddString(node, prop, value):  argument
215         value: String value (which will be \0-terminated in the DT)
217     for n in GetUpdateNodes(node):
220 def SetInt(node, prop, value):  argument
228     for n in GetUpdateNodes(node):
231 def CheckAddHashProp(node):  argument
232     hash_node = node.FindNode('hash')
236             return "Missing 'algo' property for hash node"
244 def CheckSetHashValue(node, get_data_func):  argument
245     hash_node = node.FindNode('hash')