Device Tree frowand

Top Device Tree page

Device Tree stuff from Frank Rowand

Updates on tools shown in the talk
 dtdiff          - in linux source tree as scripts/dtc/dtx_diff,  merged 4.6-rc1 - --annotate merged 5.0-rc1

dtc --annotate  - in linux source tree, merged 5.0-rc1

dt_node_info    - remains a proof of concept dt_stat

dt_to_config    - vastly improved, upstream in Linux 4.8-rc1 

Another option for uploading FDT and EDT from a target over a serial console is serio.

Embedded Linux Conference Europe (ELCE) - October 6, 2015

 * [[Media:Dt_debugging_elce_2015_151006_0421.pdf | PDF slides, as presented ]]
 * [[Media:Dt_debugging_elce_2015.pdf | PDF slides, pre-conference version ]]
 * 29: diff shown was reverse of the command
 * 83: duplicate of 82
 * [[Media:Dtdiff_lcna_2015_150811_1802.patch | make dtdiff work for .dts files in the Linux kernel source tree and in single file mode]]
 * [[Media:Dt_stat_150811_1802.patch | create dt_stat and dt_node_info scripts]]
 * [[Media:Dt_property_access_150918_2310.patch | Script and program to convert console debug messages to report of which properties in a device tree file were accessed (or access was attempted) on the target system.]]
 * Version 150811_1802 had a fatal bug. Fixed in version 150918_2310.
 * [[Media:Print_property_access_150811_1802.patch | Kernel changes to add debug messages needed by the dt_prop script.]]
 * newer version of kernel changes for dt_prop in "Solving Device Tree Issues - Part 3".
 * [[Media:Get_fdt_and_edt_over_serial_console.txt | notes on how to upload FDT and EDT from a target over a serial console (150531_0029)]]

Linuxcon North America / Linux Plumbers Conference refereed track - August 19, 2015

 * [[Media:Dt_debugging_lcna_2015.pdf | PDF slides ]]
 * [[Media:Dtdiff_lcna_2015_150811_1802.patch | make dtdiff work for .dts files in the Linux kernel source tree and in single file mode]]
 * [[Media:Dt_stat_150811_1802.patch | create dt_stat and dt_node_info scripts]]
 * [[Media:Dt_property_access_150918_2310.patch | Script and program to convert console debug messages to report of which properties in a device tree file were accessed (or access was attempted) on the target system.]]
 * Version 150811_1802 had a fatal bug. Fixed in version 150918_2310.
 * [[Media:Print_property_access_150811_1802.patch | Kernel changes to add debug messages needed by the dt_prop script.]]
 * newer version of kernel changes for dt_prop in "Solving Device Tree Issues - Part 3".
 * [[Media:Get_fdt_and_edt_over_serial_console.txt | notes on how to upload FDT and EDT from a target over a serial console (150531_0029)]]

LinuxCon Japan - June 4, 2015

 * [[Media:Dt_debugging_lcj_2015.pdf | PDF slides ]]
 * [[Media:Dtdiff_add_cpp.patch | patch to make dtdiff work for .dts files in the Linux kernel source tree and in single file mode (v 150531_0043)]]
 * [[Media:Dt_stat.patch | patch to create dt_stat and dt_node_info scripts ( v 150527_1902 v 150707_1852)]]
 * [[Media:Get_fdt_and_edt_over_serial_console.txt | notes on how to upload FDT and EDT from a target over a serial console (150531_0029)]]

Resources for "Solving Device Tree Issues - Part 2" talk
dt_to_config is not upstream yet is upstream in Linux 4.8-rc1. It is also available here:
 * [[Media:Dt_to_config_160718_1640.tar | tar of scripts/dtc/dt_to_config ]]

dt_to_config requires scripts/dtc/dtx_diff, which is available in Linux 4.6-rc1 and later.

Resources for "Solving Device Tree Issues - Part 3" talk

 * [[Media:Patches 161003 1822.tar | tar of patches ]] to patch 4.7-rc7 4.8-rc7 kernel and to create dt_prop and dts_diff.

devicetree man pages
man pages for devicetree are a work in progress. This is a workspace to hold current progress until the work is mainlined. Source files are being added to the list of files processed by docbook as the docbook comments in the source files are updated. man pages are not created for source files that have not been audited.

The current version of the man pages is:


 * [[Media:Docbook_devicetree_160620_0145.tar | 160620_0145 tar]]
 * Adds rest of of/drivers/*.c


 * [[Media:Docbook_devicetree_160613_1940.tar | 160613_1940 tar]]
 * of/drivers/address.c
 * of/drivers/base.c
 * of/drivers/device.c

The man pages are created from the docbook comments in the Linux kernel source.

The man pages are available in two formats
 * html
 * via the man command.

installing and using the html man pages
create a location to download and install
 * pick a location, I use 'me/devicetree_docs'
 * dest_relative="me/devicetree_docs"
 * create the location
 * dest="$(pwd)/${dest_relative}"
 * mkdir -p ${dest_relative}
 * cd ${dest}

Download [[Media:Docbook_devicetree_160620_0145.tar | the tar]] containing the html tar, the man tar, and the patches tar to the current directory

unpack the individual tars from the bundle unpack the html tar determine the URL to use to access the man pages enter the above URL in your favorite browser
 * tar -xf Docbook_devicetree_160620_0145.tar
 * tar -xf docbook_devicetree_html_160620_0145.tgz
 * echo "file://${dest}/devicetree.html"

installing and using the man command pages
create a location to download and install
 * pick a location, I use 'me/devicetree_docs'
 * dest_relative="me/devicetree_docs"
 * create the location
 * dest="$(pwd)/${dest_relative}"
 * mkdir -p ${dest_relative}
 * cd ${dest}

Download [[Media:Docbook_devicetree_160620_0145.tar | the tar]] containing the html tar, the man tar, and the patches tar to the current directory

unpack the individual tars from the bundle unpack the man tar create the directory tree that the man command expects use the man command in one of two ways MANPATH="${dest}/man" man OF_FUNCTION eg.   MANPATH="${dest}/man" man of_node_get export MANPATH="${dest}/man" man OF_FUNCTION eg  export MANPATH="${dest}/man" man of_node_get man of_node_put
 * tar -xf Docbook_devicetree_160620_0145.tar
 * tar -xf docbook_devicetree_man_160620_0145.tgz
 * ln -s devicetree man/man9

installing the source patches and building the docbook results
If you want to compile the docbook results yourself, do the following.

Download the Linux kernel source tree
 * mkdir my_kernel_source
 * cd my_kernel_source
 * git clone git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
 * cd linux
 * checkout the kernel version that the patches were created on. Pick one of:
 * git checkout af8c34ce6ae3
 * git checkout v4.7-rc2

Download [[Media:Docbook_devicetree_160620_0145.tar | the tar]] containing the html tar, the man tar, and the patches tar to the current directory

Unpack the individual tars from the bundle
 * tar -xf Docbook_devicetree_160620_0145.tar

Unpack the source patches tar
 * tar -xf docbook_devicetree_patch_160620_0145.tgz

Apply the patches If you do not have quilt installed, you can instead apply each of the patches in patches/. Apply the patches in the order listed in patches/series.
 * quilt push -a

Build the docbook targets
 * mkdir ../build
 * export KBUILD_OUTPUT=../build
 * make DOCBOOKS="devicetree.xml" mandocs
 * make DOCBOOKS="devicetree.xml" htmldocs

The generated objects will be under the build directory ../build/Documentation/DocBook/

image test


This is a photograph from one of my desert trips. If you have arrived early to one of my conference talks, you have probably seen photos from my desert trips.

This spot of color is low in the hills of Death Valley.

temporary parking spot
Links to pages that are under construction, so that the pages will not get deleted.