zephyr

History

Martí Bolívar 74abb2bf95 devicetree: add first-class node label helpers Add the following new macros: - DT_FOREACH_NODELABEL - DT_FOREACH_NODELABEL_VARGS - DT_INST_FOREACH_NODELABEL - DT_INST_FOREACH_NODELABEL_VARGS These are for-each helpers for iterating over the node labels of a devicetree node. Since node labels are unique in the entire devicetree, their token representations can be useful as unique IDs in code as well. As a first user of these, add: - DT_NODELABEL_STRING_ARRAY - DT_INST_NODELABEL_STRING_ARRAY The motivating use case for these macros is to allow looking up a struct device by devicetree node label in Zephyr shell utilities. The work on the shells themselves is deferred to other patches. To make working with the string array helpers easier, add: - DT_NUM_NODELABELS - DT_INST_NUM_NODELABELS Signed-off-by: Martí Bolívar <mbolivar@amperecomputing.com>		2024-06-12 18:49:54 +02:00
..
python-devicetree	dtlib: Allow deleting the root node	2024-06-06 00:42:10 -07:00
gen_defines.py	devicetree: add first-class node label helpers	2024-06-12 18:49:54 +02:00
gen_driver_kconfig_dts.py	scripts: dts: gen_driver_kconfig_dts: Skip empty yaml files	2023-02-19 20:46:44 -05:00
gen_dts_cmake.py	treewide: Disable automatic argparse argument shortening	2023-01-26 20:12:36 +09:00
README.txt

README.txt

This directory used to contain the edtlib.py and dtlib.py libraries
and tests, alongside the gen_defines.py script that uses them for
converting DTS to the C macros used by Zephyr.

The libraries and tests have now been moved to the 'python-devicetree'
subdirectory.

We are now in the process of extracting edtlib and dtlib into a
standalone source code library that we intend to share with other
projects.

Links related to the work making this standalone:

    https://pypi.org/project/devicetree/
    https://python-devicetree.readthedocs.io/en/latest/
    https://github.com/zephyrproject-rtos/python-devicetree

The 'python-devicetree' subdirectory you find here next to this
README.txt matches the standalone python-devicetree repository linked
above.

For now, the 'main' copy will continue to be hosted here in the zephyr
repository. We will mirror changes into the standalone repository as
needed; you can just ignore it for now.

Code in the zephyr repository which needs these libraries will import
devicetree.edtlib from now on, but the code will continue to be found
by manipulating sys.path for now.

Eventually, as APIs stabilize, the python-devicetree code in this
repository will disappear, and a standalone repository will be the
'main' one.