zephyr

History

Martí Bolívar 0c29e07e30 devicetree: better DT_PROP_BY_IDX()/DT_FOREACH_PROP_ELEM() support Support use of these macros with properties of type phandle and string by allowing iterating over: - a phandle as if it were a phandles of length 1, for convenience and consistency with our ability to take its length (and getting 1) - the non-null characters in a string: we exclude the null for consistency with the return value of DT_PROP_LEN() on string properties, which, like strlen(), does not include the null With this and a previous patch expanding the usage of DT_PROP_LEN(), there is now a relationship between being able to take a property's logical length with DT_PROP_LEN() and being able to iterate over its logical elements with DT_FOREACH_PROP_ELEM(). Explain this in the documentation. Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>		2023-05-16 18:14:26 +02:00
..
python-devicetree	edtlib: finish adding type annotations	2023-04-17 08:58:14 -07:00
README.txt	dts: separate DT libraries from gen_defines.py	2021-04-02 08:28:12 -05:00
gen_defines.py	devicetree: better DT_PROP_BY_IDX()/DT_FOREACH_PROP_ELEM() support	2023-05-16 18:14:26 +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

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.