tools/dtoc/fdt.py

2 # SPDX-License-Identifier: GPL-2.0+
15 # This deals with a device tree, presenting it as an assortment of Node and
17 # contains the base classes and defines the high-level API. You can use
20 # This implementation uses a libfdt Python library to access the device tree,
32     """A device tree property
35         name: Property name (as per the device tree)
102                     TYPE_INT: a byte-swapped integer stored as a 4-byte string
103                     TYPE_BYTE: a byte stored as a single-byte string
109         count = len(strings) - 1
110         if count > 0 and not strings[-1]:
111             for string in strings[:-1]:
125                 return TYPE_STRING, strings[:-1]
167         The device tree is marked dirty so that the value will be written to
171             val: Integer value (32-bit, single cell)
189         """Sync property changes back to the device tree
191         This updates the device tree blob with any changes to this property
195             auto_resize: Resize the device tree automatically if it does not
206                                     (libfdt.NOSPACE,)) == -libfdt.NOSPACE:
214     """A device tree node
217         offset: Integer offset in the device tree
218         name: Device tree node tname
220         _fdt: Device tree object
268         searching into subnodes so that the entire tree is built.
278             sep = '' if self.path[-1] == '/' else '/'
290         Note: This does not take account of property offsets - these will not
303         if offset != -libfdt.FDT_ERR_NOTFOUND:
332         """Add a new property to the device tree with an integer value of 0.
342         The device tree is marked dirty so that the value will be written to
353         """Update an integer property int the device tree.
357         The device tree is marked dirty so that the value will be written to
369         The device tree is marked dirty so that the value will be written to
381         The device tree is marked dirty so that the value will be written to
386             val: String value to set (will be \0-terminated in DT)
393         The device tree is marked dirty so that the value will be written to
417         """Sync node changes back to the device tree
419         This updates the device tree blob with any changes to this node and its
423             auto_resize: Resize the device tree automatically if it does not
436                     if offset != -libfdt.NOSPACE:
459     """Provides simple access to a flat device tree blob using libfdts.
463       _root: Root of device tree (a Node object)
480             data: Device-tree data blob
501         """Scan a device tree, building up a tree of Node objects
515         """Get the root Node of the device tree
541         """Flush device tree changes back to the file
543         If the device tree has changed in memory, write it back to the file.
552             auto_resize: Resize the device tree automatically if it does not
562         """Pack the device tree down to its minimum size
565         build up in the device tree binary.
630             offset: Offset within the 'struct' region of the device tree
632             Position of @offset within the device tree binary