设备树（device tree）学习笔记【转】
转自：https://www.cnblogs.com/pengdonglin137/p/4495056.html
作者信息
作者：彭东林
邮箱：pengdonglin137@163.com
1、反编译设备树
在设备树学习的时候，如果可以看到最终生成的设备树的内容，对于我们学习设备树以及分析问题有很大帮助。这里我们需要使用设备树生成工具dtc的反编译功能
root@pengdl-VirtualBox:~/tq2440/Linux/linux-4.0.1# ./scripts/dtc/dtc -h
Usage: dtc [options] <input file>
Options: -[qI:O:o:V:d:R:S:p:fb:i:H:sW:E:hv]
-q, --quiet
Quiet: -q suppress warnings, -qq errors, -qqq all
-I, --in-format <arg>
Input formats are:
dts - device tree source text
dtb - device tree blob
fs - /proc/device-tree style directory
-o, --out <arg>
Output file
-O, --out-format <arg>
Output formats are:
dts - device tree source text
dtb - device tree blob
asm - assembler source
-V, --out-version <arg>
Blob version to produce, defaults to %d (for dtb and asm output)
-d, --out-dependency <arg>
Output dependency file
-R, --reserve <arg>
tMake space for <number> reserve map entries (for dtb and asm output)
-S, --space <arg>
Make the blob at least <bytes> long (extra space)
-p, --pad <arg>
Add padding to the blob of <bytes> long (extra space)
-b, --boot-cpu <arg>
Set the physical boot cpu
-f, --force
Try to produce output even if the input tree has errors
-i, --include <arg>
Add a path to search for include files
-s, --sort
Sort nodes and properties before outputting (useful for comparing trees)
-H, --phandle <arg>
Valid phandle formats are:
legacy - "linux,phandle" properties only
epapr - "phandle" properties only
both - Both "linux,phandle" and "phandle" properties
-W, --warning <arg>
Enable/disable warnings (prefix with "no-")
-E, --error <arg>
Enable/disable errors (prefix with "no-")
-h, --help
Print this help and exit
-v, --version
Print version and exit
假设我们最终的设备树文件是：arch/arm/boot/dts/s3c2416-smdk2416.dtb
./scripts/dtc/dtc -I dtb -O dts -o output.dts arch/arm/boot/dts/s3c2416-smdk2416.dtb
输出文件output.dts就是反汇编的结果，他就是实际生成的设备树，当然也可以重新将生成的dts文件在编译成dtb文件：
./scripts/dtc/dtc -I dts -O dtb -o s3c2416-smdk2416.dtb output.dts
2、分析工具fdtdump
在Linux的scripts/dtc目录下除了提供dtc工具外，还提供了一个叫做fdtdump的工具，对于分析设备树也非常有帮助。
用法：
fdtdump -h Usage: fdtdump [options] <file> Options: -[dshV] -d, --debug Dump debug information while decoding the file -s, --scan Scan for an embedded fdt in file -h, --help Print this help and exit -V, --version Print version and exit
使用范例：
fdtdump -sd vexpress-v2p-ca9.dtb | tee vexpress.dts.debug
看看输出的文件：
vexpress-v2p-ca9.dtb: found fdt at offset 0
/dts-v1/;
// magic: 0xd00dfeed
// totalsize: 0x2e9c (11932)
// off_dt_struct: 0x38
// off_dt_strings: 0x2bb8
// off_mem_rsvmap: 0x28
// version: 17
// last_comp_version: 16
// boot_cpuid_phys: 0x0
// size_dt_strings: 0x2e4
// size_dt_struct: 0x2b80
// 0038: tag: 0x00000001 (FDT_BEGIN_NODE)
/ {
// 0040: tag: 0x00000003 (FDT_PROP)
// 2bb8: string: model
// 004c: value
model = "V2P-CA9";
可以看到，其中这个工具会同时把分析语句和原始文件打印出来，其中 // 后输出的是分析语句，其他的是原始语句。对分析Linux内核启动时遍历展开设备树镜像很有帮助。
3、Linux配置，支持设备树
make menuconfig ---> Boot options ---> Flattened Device Tree support
4、Linux 编译设备树
可以看看arch/arm/boot/dts/Makefile中你要的那个设备树的dtb文件是否配置上了。
make dtbs
5、从Linux内核代码中编译设备树的工具dtc
在内核源码目录下提供了dtc工具的源码实现， 下面是生成这个工具的命令：
make scripts
6、删除设备树属性的方法
有时我们有这样的需求，需要删除设备树的某些属性， 但是我们又不想修改设备树源文件，那么可以利用delete-property方法。
1 / {
2 ... ...
3 demo1: demo1 {
4 compatible = "demo1";
5 property1 = <1>;
6 property2;
7 property3 = <2>;
8 property4;
9 };
10 };
11
12 &demo1 {
13 /delete-property/property2;
14 /delete-property/property3;
15 };
编译完成后，执行反编译可以看到property2和property3已经消失了：
1 demo1 {
2 compatible = "demo1";
3 property1 = <0x1>;
4 property4;
5 };
7、两个内核新增的设备树调试工具
- ./scripts/dtc/dt_to_config
可以根据传入的设备树解析出每个节点对应那些驱动以及内核是否已经配置，甚至可以通过传递--config-format来直接修改.config文件，如果嫌节点的路径过长，可以传递参数--short-name，用法示例：
# 这里的--include-suspec用于解析设备树中的include字段 $./scripts/dtc/dt_to_config arch/arm/boot/dts/s3c2440-tq2440-dt.dts --include-suspect --config ./.config
-dDc-E-Hx---- : /i2c-gpio-1 : i2c-gpio : arch/arm/mach-ep93xx/core.c : obj-y : x
-dDc-E-H-n--F : /i2c-gpio-1 : i2c-gpio : arch/arm/mach-ixp4xx/avila-setup.c : CONFIG_MACH_AVILA : n
-dDc-E-H-n--F : /i2c-gpio-1 : i2c-gpio : arch/arm/mach-ixp4xx/dsmg600-setup.c : CONFIG_MACH_DSMG600 : n ...
当然后面也可以直接跟dtb文件：
$./scripts/dtc/dt_to_config arch/arm/boot/dts/s3c2440-tq2440-dt.dtb --include-suspect --config ./.config -dDc-E-Hx---- : /i2c-gpio-1 : i2c-gpio : arch/arm/mach-ep93xx/core.c : obj-y : x -dDc-E-H-n--F : /i2c-gpio-1 : i2c-gpio : arch/arm/mach-ixp4xx/avila-setup.c : CONFIG_MACH_AVILA : n -dDc-E-H-n--F : /i2c-gpio-1 : i2c-gpio : arch/arm/mach-ixp4xx/dsmg600-setup.c : CONFIG_MACH_DSMG600 : n -dDc-E-H-n--F : /i2c-gpio-1 : i2c-gpio : arch/arm/mach-ixp4xx/fsg-setup.c : CONFIG_MACH_FSG : n ...
- ./scripts/dtc/dtx_diff
这个工具用于比较两个设备树，也可以对设备树反编译。示例：
#传递一个设备树，表示反编译 ./scripts/dtc/dtx_diff arch/arm/boot/dts/s3c2440-tq2440-dt.dtb
#也可以直接传递一个dts文件，这个工具会将该dts文件展开
./scripts/dtc/dtx_diff arch/arm/boot/dts/s3c2440-tq2440-dt.dts #传递两个设备树表示比较 ./scripts/dtc/dtx_diff arch/arm/boot/dts/s3c2440-tq2440-dt.dtb /tftpboot/dtb --- /dev/fd/63 2017-09-23 22:01:48.407691984 +0800 +++ /dev/fd/62 2017-09-23 22:01:48.407691984 +0800 @@ -125,7 +125,7 @@ pinctrl-names = "default"; reg = <0x54000000 0x100>; samsung,i2c-max-bus-freq = <0x30d40>; - status = "disabled"; + status = "okay"; demo0@51 { compatible = "demo0";
也可以都是dts文件，或者一个dts一个dtb文件。
8、如何在设备树里控制属性值占用的字节数？
http://www.cnblogs.com/pengdonglin137/p/6044418.html
9、设备树中ranges属性分析
http://www.cnblogs.com/pengdonglin137/p/7401049.html
10、dts中memreserve和reserved-memory的区别
https://www.cnblogs.com/pengdonglin137/articles/10483018.html
11、devicetree-specification
https://files.cnblogs.com/files/pengdonglin137/devicetree-specification.pdf
其他关于设备树的调试文档
2、Youtube：Solving Devicetree Issues, part 3.0
3、Linux kernel的devicetree-compiler邮件列表里有很多好的patch，可以挑选自己想要的， 比如下面几个：
[RFC PATCH 0/3] dtc: dts source location annotation 这个系列的patch为dtc增加了一个annotate配置，这样在编译设备树时会生成annotate.dts.tmp后缀的隐藏文件，可以查看每个属性最终是被那个设备树文件设置的
[RFC PATCH 1/3] dtc: dts source location annotation
[RFC PATCH 2/3] dtc: make check test for dtc --annotate
[RFC PATCH 3/3] dtc: linux kernel build process to create annotated .dts
效果：
sdhci@f9824900 { /* arch/arm/boot/dts/qcom-apq8074-dragonboard.dts:14 */ compatible = "qcom,sdhci-msm-v4"; /* arch/arm/boot/dts/qcom-msm8974.dtsi:240 */ reg = <0xf9824900 0x11c 0xf9824000 0x800>; /* arch/arm/boot/dts/qcom-msm8974.dtsi:241 */ reg-names = "hc_mem", "core_mem"; /* arch/arm/boot/dts/qcom-msm8974.dtsi:242 */ interrupts = <0x0 0x7b 0x0 0x0 0x8a 0x0>; /* arch/arm/boot/dts/qcom-msm8974.dtsi:243 */ interrupt-names = "hc_irq", "pwr_irq"; /* arch/arm/boot/dts/qcom-msm8974.dtsi:244 */ clocks = <0xd 0xd8 0xd 0xd7>; /* arch/arm/boot/dts/qcom-msm8974.dtsi:245 */ clock-names = "core", "iface"; /* arch/arm/boot/dts/qcom-msm8974.dtsi:246 */ status = "ok"; /* arch/arm/boot/dts/qcom-apq8074-dragonboard.dts:17 */ bus-width = <0x8>; /* arch/arm/boot/dts/qcom-apq8074-dragonboard.dts:15 */ non-removable; /* arch/arm/boot/dts/qcom-apq8074-dragonboard.dts:16 */ }; /* arch/arm/boot/dts/qcom-apq8074-dragonboard.dts:18 */
