Google Git
Sign in
android / platform / external / dtc / 097679758642db81b27795f463c184acdd8a3a74
commit097679758642db81b27795f463c184acdd8a3a74[log] [tgz]
authorAndroid Build Coastguard Worker <android-build-coastguard-worker@google.com>Tue Aug 09 01:11:20 2022 +0000
committerAndroid Build Coastguard Worker <android-build-coastguard-worker@google.com>Tue Aug 09 01:11:20 2022 +0000
tree5c4a0685e75d0d6a1a1e7ba61d76d3120bddff9e
parent259a8d6c9b7264595caf51bc9bb56fd2770ac3e1 [diff]
parentd59fda22f3a4529dcedc926dd9e436a85d0b8574 [diff]
Snap for 8920978 from d59fda22f3a4529dcedc926dd9e436a85d0b8574 to udc-release

Change-Id: I45f23b4ab06f3de4a882ecd7d1d65af87b8a57c8
tree: 5c4a0685e75d0d6a1a1e7ba61d76d3120bddff9e
  1. Documentation/
  2. fuzzing/
  3. libfdt/
  4. pylibfdt/
  5. scripts/
  6. tests/
  7. .cirrus.yml
  8. .editorconfig
  9. .gitignore
  10. .travis.yml
  11. Android.bp
  12. BSD-2-Clause
  13. checks.c
  14. CONTRIBUTING.md
  15. convert-dtsv0-lexer.l
  16. data.c
  17. dtc-lexer.l
  18. dtc-parser.y
  19. dtc.c
  20. dtc.h
  21. dtdiff
  22. fdtdump.c
  23. fdtget.c
  24. fdtoverlay.c
  25. fdtput.c
  26. flattree.c
  27. fstree.c
  28. GPL
  29. livetree.c
  30. Makefile
  31. Makefile.convert-dtsv0
  32. Makefile.dtc
  33. Makefile.utils
  34. MANIFEST.in
  35. meson.build
  36. meson_options.txt
  37. METADATA
  38. MODULE_LICENSE_GPL
  39. NOTICE
  40. OWNERS
  41. README.license
  42. README.md
  43. README.version
  44. setup.py
  45. srcpos.c
  46. srcpos.h
  47. TODO
  48. treesource.c
  49. util.c
  50. util.h
  51. version_gen.h.in
  52. version_non_gen.h
  53. yamltree.c
README.md

Device Tree Compiler and libfdt

The source tree contains the Device Tree Compiler (dtc) toolchain for working with device tree source and binary files and also libfdt, a utility library for reading and manipulating the binary format.

dtc and libfdt are maintained by:

Python library

A Python library wrapping libfdt is also available. To build this you will need to install swig and Python development files. On Debian distributions:

$ sudo apt-get install swig python3-dev

The library provides an Fdt class which you can use like this:

$ PYTHONPATH=../pylibfdt python3
>>> import libfdt
>>> fdt = libfdt.Fdt(open('test_tree1.dtb', mode='rb').read())
>>> node = fdt.path_offset('/subnode@1')
>>> print(node)
124
>>> prop_offset = fdt.first_property_offset(node)
>>> prop = fdt.get_property_by_offset(prop_offset)
>>> print('%s=%s' % (prop.name, prop.as_str()))
compatible=subnode1
>>> node2 = fdt.path_offset('/')
>>> print(fdt.getprop(node2, 'compatible').as_str())
test_tree1

You will find tests in tests/pylibfdt_tests.py showing how to use each method. Help is available using the Python help command, e.g.:

$ cd pylibfdt
$ python3 -c "import libfdt; help(libfdt)"

If you add new features, please check code coverage:

$ sudo apt-get install python3-coverage
$ cd tests
# It's just 'coverage' on most other distributions
$ python3-coverage run pylibfdt_tests.py
$ python3-coverage html
# Open 'htmlcov/index.html' in your browser

The library can be installed with pip from a local source tree:

$ pip install . [--user|--prefix=/path/to/install_dir]

Or directly from a remote git repo:

$ pip install git+git://git.kernel.org/pub/scm/utils/dtc/dtc.git@main

The install depends on libfdt shared library being installed on the host system first. Generally, using --user or --prefix is not necessary and pip will use the default location for the Python installation which varies if the user is root or not.

You can also install everything via make if you like, but pip is recommended.

To install both libfdt and pylibfdt you can use:

$ make install [PREFIX=/path/to/install_dir]

To disable building the python library, even if swig and Python are available, use:

$ make NO_PYTHON=1

More work remains to support all of libfdt, including access to numeric values.

Mailing lists