====
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.4): 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/ca/70/8df4a96c7d094d26358b349227242c8d8190a32a103feaf42079d96f40ca/dtsh-0.2.4.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.4): 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.4",
"project_urls": {
"Homepage": "https://github.com/dottspina/dtsh"
},
"split_keywords": [
"devicetree",
" zephyr",
" dts",
" embedded"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2f65597b671f65a8d4972b61b1225bc9f7e05a810e31f4c33dcdd6e2194b39ac",
"md5": "560bdac000383ea72e648b6afd269856",
"sha256": "ac7de5eafb40f04964edd53021f8a36e294c85b0ad5c47f7d1c67739d781bcbd"
},
"downloads": -1,
"filename": "dtsh-0.2.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "560bdac000383ea72e648b6afd269856",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 245959,
"upload_time": "2024-12-09T07:22:48",
"upload_time_iso_8601": "2024-12-09T07:22:48.429674Z",
"url": "https://files.pythonhosted.org/packages/2f/65/597b671f65a8d4972b61b1225bc9f7e05a810e31f4c33dcdd6e2194b39ac/dtsh-0.2.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ca708df4a96c7d094d26358b349227242c8d8190a32a103feaf42079d96f40ca",
"md5": "a49bdf18fe8bbfb61969f33f70cab634",
"sha256": "d1a67907e9df18b76276f469fc0301c81d5535a19d94cdbb404b3d35aeba895f"
},
"downloads": -1,
"filename": "dtsh-0.2.4.tar.gz",
"has_sig": false,
"md5_digest": "a49bdf18fe8bbfb61969f33f70cab634",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 257408,
"upload_time": "2024-12-09T07:22:50",
"upload_time_iso_8601": "2024-12-09T07:22:50.664972Z",
"url": "https://files.pythonhosted.org/packages/ca/70/8df4a96c7d094d26358b349227242c8d8190a32a103feaf42079d96f40ca/dtsh-0.2.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-09 07:22:50",
"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"
}