A python-kivy project to help exploring a device tree hierarchy
I strongly advise to install inside a [Mini]Conda environment :)
- Install [Mini]Conda: https://waylonwalker.com/install-miniconda/
- Install Kivy:
conda install kivy -c conda-forge
- Install other dependencies:
gitpython
colour
- Clone this repository and initialize its git submodules
$ cd ~ # or wherever you would like to clone it :)
$ git clone --recurse-submodules https://github.com/griloHBG/DeviceTreeExplorer
-
Navigate to the
arch/<architecture>/boot/dts
of your local linux kernel repository -
Run the
main.py
and pass a*.dtsi
or*.dts
(prefferably) as argumentEx:
$ conda activate $ alias device-tree-explorer="python3 ~/DeviceTreeExplorer/main.py" $ cd linux-toradex/arch/arm/boot/dts $ device-tree-explorer imx6dl-colibri-eval-v3.dts
Or:
$ conda activate $ alias device-tree-explorer="python3 ~/DeviceTreeExplorer/main.py" $ device-tree-explorer ~/linux-toradex/arch/arm/boot/dts/imx6dl-colibri-eval-v3.dts
-
Top:
- Current kernel branch (
toradex_5.4.y
in the example above) - To which architecture the current file belongs (
arm
in the example above) - Path to the file current opened: clicking here, you can navigate and open another files
- TODO: recently opened files :)
- TODO: highlight *.dts files with different color
- Current kernel branch (
-
Left:
- The content of the current opened file (there is no way to save modifications)
- Big Search: recursively search on all directly or indirectly included files (the result is shown on the right)
- Little Search: to search only inside the opened file (the usual text search)
- Go to line by its line number
- TODO: sanity check on input
- Amount of lines of the current file
-
Right:
- Delete all results generated by a single search
- Take a look at all hits according to the string searched
- Click on the line number to go to a specific search hit
- It is possible to delete all results from a single file
-
The vertical divisor is draggable