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
This standalone repo includes the same features as what we have in
Zephyr, but in its own 'devicetree' python package with PyPI
integration, etc.
To avoid making this a hard fork, move the code that's being made
standalone around in Zephyr into a new scripts/dts/python-devicetree
subdirectory, and handle the package and sys.path changes in the
various places in the tree that use it.
From now on, it will be possible to update the standalone repository
by just recursively copying scripts/dts/python-devicetree's contents
into it and committing the results.
This is an interim step; do NOT 'pip install devicetree' yet.
The code in the zephyr repository is still the canonical location.
(In the long term, people will get the devicetree package from PyPI
just like they do the 'yaml' package today, but that won't happen for
the foreseeable future.)
This commit is purely intended to avoid a hard fork for the standalone
code, and no functional changes besides the package structure and
location of the code itself are expected.
Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>
32 lines
1.2 KiB
Text
32 lines
1.2 KiB
Text
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.
|