====
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.5): 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.10",
"maintainer_email": null,
"keywords": "devicetree, zephyr, dts, embedded",
"author": "Christophe Dufaza",
"author_email": "chris@openmarl.org",
"download_url": "https://files.pythonhosted.org/packages/26/fa/cf99439597b005bb3944472ebfc1d63983c443e6941a6bfe6ac230e5e87f/dtsh-0.2.5.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.5): 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.5",
"project_urls": {
"Homepage": "https://github.com/dottspina/dtsh"
},
"split_keywords": [
"devicetree",
" zephyr",
" dts",
" embedded"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "40ff49fa45265a9541befe4abf44047299b1c4a01bf3dbbc16a94e6ef5c19cd6",
"md5": "c103cfc55ea35fcf7422e3e087998ac0",
"sha256": "83e95b1d75548116683462db8159f97ca1d002e6b53a5ed823ce7495cfa0836d"
},
"downloads": -1,
"filename": "dtsh-0.2.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c103cfc55ea35fcf7422e3e087998ac0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 212316,
"upload_time": "2025-10-24T03:55:34",
"upload_time_iso_8601": "2025-10-24T03:55:34.695616Z",
"url": "https://files.pythonhosted.org/packages/40/ff/49fa45265a9541befe4abf44047299b1c4a01bf3dbbc16a94e6ef5c19cd6/dtsh-0.2.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "26facf99439597b005bb3944472ebfc1d63983c443e6941a6bfe6ac230e5e87f",
"md5": "e00dd7789d070d3ea34e35c70215c58e",
"sha256": "463610b32a25c3fe6de6de5d3a8e735413bdaaf7202f3392c3fef359d8427a8c"
},
"downloads": -1,
"filename": "dtsh-0.2.5.tar.gz",
"has_sig": false,
"md5_digest": "e00dd7789d070d3ea34e35c70215c58e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 225651,
"upload_time": "2025-10-24T03:55:36",
"upload_time_iso_8601": "2025-10-24T03:55:36.444244Z",
"url": "https://files.pythonhosted.org/packages/26/fa/cf99439597b005bb3944472ebfc1d63983c443e6941a6bfe6ac230e5e87f/dtsh-0.2.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-24 03:55:36",
"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": []
},
{
"name": "gnureadline",
"specs": []
}
],
"lcname": "dtsh"
}
JSON
