====
DTSh
====
**DTSh** is a Devicetree Source (DTS) files viewer with a shell-like command line interface:
- *navigate* and *visualize* the devicetree
- *search* for devices, bindings, buses or interrupts with flexible criteria
- redirect command output to files (text, HTML, SVG) to *document* hardware configurations
or illustrate notes
- *rich* Textual User Interface, command line auto-completion, command history, user themes
::
$ dtsh build/zephyr/zephyr.dts
dtsh (0.2.3): A Devicetree Shell
How to exit: q, or quit, or exit, or press Ctrl-D
/
> cd &flash_controller
/soc/flash-controller@4001e000
> tree -l
Description
─────────────────────────────────────────────────────────────────
flash-controller@4001e000 Nordic NVMC (Non-Volatile Memory Controller)
└── flash@0 Flash node
└── partitions This binding is used to describe fixed partitions of a flash (or…
├── partition@0 Each child node of the fixed-partitions node represents…
├── partition@c000 Each child node of the fixed-partitions node represents…
├── partition@82000 Each child node of the fixed-partitions node represents…
└── partition@f8000 Each child node of the fixed-partitions node represents…
You can use it with:
- all DTS files generated by **Zephyr** at build-time (aka ``build/zephyr/zephyr.dts``)
- arbitrary DTS files with bindings compatible with Zephyr's `Devicetre bindings syntax <https://docs.zephyrproject.org/latest/build/dts/bindings-syntax.html>`_
Status
******
DTSh 0.2.x mirror and package the code base that serves as a proposal to upstream DTSh
as a new Zephyr extension to West: `RFC - DTSh, shell-like interface with Devicetree <https://github.com/zephyrproject-rtos/zephyr/pull/59863>`_
This is the stable and maintained branch: if you have DTSh 0.1.x installed, please upgrade with
e.g. ``pip install -U dtsh``.
Please refer to the `DTSh project documentation <http://dottspina.github.io/dtsh>`_.
Raw data
{
"_id": null,
"home_page": "https://github.com/dottspina/dtsh",
"name": "dtsh",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "devicetree, zephyr, dts, embedded",
"author": "Christophe Dufaza",
"author_email": "chris@openmarl.org",
"download_url": "https://files.pythonhosted.org/packages/39/1c/7cf003533af75da92266a671eb26f8bb34f474db566fa0b4ec41e7079d2b/dtsh-0.2.3.1.tar.gz",
"platform": null,
"description": "====\nDTSh\n====\n\n**DTSh** is a Devicetree Source (DTS) files viewer with a shell-like command line interface:\n\n- *navigate* and *visualize* the devicetree\n- *search* for devices, bindings, buses or interrupts with flexible criteria\n- redirect command output to files (text, HTML, SVG) to *document* hardware configurations\n or illustrate notes\n- *rich* Textual User Interface, command line auto-completion, command history, user themes\n\n::\n\n $ dtsh build/zephyr/zephyr.dts\n dtsh (0.2.3): A Devicetree Shell\n How to exit: q, or quit, or exit, or press Ctrl-D\n\n /\n > cd &flash_controller\n\n /soc/flash-controller@4001e000\n > tree -l\n Description\n \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n flash-controller@4001e000 Nordic NVMC (Non-Volatile Memory Controller)\n \u2514\u2500\u2500 flash@0 Flash node\n \u2514\u2500\u2500 partitions This binding is used to describe fixed partitions of a flash (or\u2026\n \u251c\u2500\u2500 partition@0 Each child node of the fixed-partitions node represents\u2026\n \u251c\u2500\u2500 partition@c000 Each child node of the fixed-partitions node represents\u2026\n \u251c\u2500\u2500 partition@82000 Each child node of the fixed-partitions node represents\u2026\n \u2514\u2500\u2500 partition@f8000 Each child node of the fixed-partitions node represents\u2026\n\nYou can use it with:\n\n- all DTS files generated by **Zephyr** at build-time (aka ``build/zephyr/zephyr.dts``)\n- arbitrary DTS files with bindings compatible with Zephyr's `Devicetre bindings syntax <https://docs.zephyrproject.org/latest/build/dts/bindings-syntax.html>`_\n\nStatus\n******\n\nDTSh 0.2.x mirror and package the code base that serves as a proposal to upstream DTSh\nas a new Zephyr extension to West: `RFC - DTSh, shell-like interface with Devicetree <https://github.com/zephyrproject-rtos/zephyr/pull/59863>`_\n\nThis is the stable and maintained branch: if you have DTSh 0.1.x installed, please upgrade with\ne.g. ``pip install -U dtsh``.\n\nPlease refer to the `DTSh project documentation <http://dottspina.github.io/dtsh>`_.\n",
"bugtrack_url": null,
"license": "Apache License version 2.0",
"summary": "Shell-like interface with Zephyr Devicetree",
"version": "0.2.3.1",
"project_urls": {
"Homepage": "https://github.com/dottspina/dtsh"
},
"split_keywords": [
"devicetree",
" zephyr",
" dts",
" embedded"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "366d912d584822ea661e394ff049e10cf750bad17e811ab082fcf5bb8246b900",
"md5": "a7ed3349d8ecd2a2f19095ac31deafd4",
"sha256": "9bbf059f088a6ab2e9a630087ba5e52c07f1d4a7e57d4813395ab701e0ad9807"
},
"downloads": -1,
"filename": "dtsh-0.2.3.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a7ed3349d8ecd2a2f19095ac31deafd4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 192087,
"upload_time": "2024-10-11T21:04:52",
"upload_time_iso_8601": "2024-10-11T21:04:52.324754Z",
"url": "https://files.pythonhosted.org/packages/36/6d/912d584822ea661e394ff049e10cf750bad17e811ab082fcf5bb8246b900/dtsh-0.2.3.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "391c7cf003533af75da92266a671eb26f8bb34f474db566fa0b4ec41e7079d2b",
"md5": "136d44d55868c911706149dac108b6a0",
"sha256": "d4d494809b6128cb0433046a395b99da1d00d0394c9565ebb18fe81ca9cad639"
},
"downloads": -1,
"filename": "dtsh-0.2.3.1.tar.gz",
"has_sig": false,
"md5_digest": "136d44d55868c911706149dac108b6a0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 205043,
"upload_time": "2024-10-11T21:04:54",
"upload_time_iso_8601": "2024-10-11T21:04:54.520934Z",
"url": "https://files.pythonhosted.org/packages/39/1c/7cf003533af75da92266a671eb26f8bb34f474db566fa0b4ec41e7079d2b/dtsh-0.2.3.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-11 21:04:54",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "dottspina",
"github_project": "dtsh",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "PyYAML",
"specs": [
[
">=",
"6.0"
]
]
},
{
"name": "rich",
"specs": [
[
"==",
"13.7.1"
]
]
},
{
"name": "gnureadline",
"specs": []
}
],
"lcname": "dtsh"
}