Linux设备树详细学习笔记

参考文献

参考视频
开发板及程序 原子mini
设备树官方文档

设备树的基本概念

DT:Device Tree //设备树
FDT: Flattened Device Tree //开放设备树，起源于OpenFirmware (所以后续会见到很多OF开头函数)
dts: device tree source的缩写 //设备树源码
dtsi: device tree source include的缩写 //通用的设备树源码<5>dtb: device tree blob的缩写//编译设备树源码得到的文件
dtc: device tree compiler的缩写 //设备树编译器

设备树编译

dis和dtsi文件通过dtc编译器，生成dtb设备树二进制文件。

DTC编译器在内核源码：

alientek@ubuntu16:~/linux/linux-imx-4.1.15-2.1.0-g3dc0a4b-v2.7$ find -name dtc.c./drivers/scsi/dtc.c
./scripts/dtc/dtc.c
alientek@ubuntu16:~/linux/linux-imx-4.1.15-2.1.0-g3dc0a4b-v2.7$ cd ./scripts/dtc/dtc.c
bash: cd: ./scripts/dtc/dtc.c: Not a directory
alientek@ubuntu16:~/linux/linux-imx-4.1.15-2.1.0-g3dc0a4b-v2.7$ cd ./scripts/dtcalientek@ubuntu16:~/linux/linux-imx-4.1.15-2.1.0-g3dc0a4b-v2.7/scripts/dtc$ ls
checks.c                  dtc-parser.tab.h          Makefile
checks.o                  dtc-parser.tab.h_shipped  Makefile.dtc
data.c                    dtc-parser.tab.o          modules.order
data.o                    dtc-parser.y              srcpos.c
dtc                       fdtdump.c                 srcpos.h
dtc.c                     fdtget.c                  srcpos.o
dtc.h                     fdtput.c                  treesource.c
dtc-lexer.l               flattree.c                treesource.o
dtc-lexer.lex.c           flattree.o                update-dtc-source.sh
dtc-lexer.lex.c_shipped   fstree.c                  util.c
dtc-lexer.lex.o           fstree.o                  util.h
dtc.o                     libfdt                    util.o
dtc-parser.tab.c          livetree.c                version_gen.h
dtc-parser.tab.c_shipped  livetree.o

编译内核时候，会同步编译dtc。
指令格式 dtc [-I input-format] [-O output-format][-o output-filename] [-V output_version] input_filename
编译设备树：dtc -I dts -O dtb -o xxx.dtb xxx.dts
反编译设备树：dtc -I dtb -O dts -o xxx.dts xxx.dtb
简单写一个dts

/dts-v1/;
/ {

};

编译与反编译

在Linux根目录下，用make dtbs 可以编译所有设备树。
arch/arm/boot/dts/Makefile，通过比配置，控制编译那些设备树

dtb-$(CONFIG_SOC_IMX6UL) += \
	imx6ul-14x14-ddr3-arm2.dtb \
	imx6ul-14x14-ddr3-arm2-emmc.dtb	\
.........
	imx6ul-9x9-evk-csi.dtb \
	imx6ul-9x9-evk-ldo.dtb

语法

头文件

和 C 语言一样，设备树也支持头文件，设备树的头文件扩展名为.dtsi，也可以引用 C 语言中的.h 文件，甚至也可以引用.dts 文件，例如

#include <dt-bindings/input/input.h>
#include "xxxxx.dtsi"

一般.dtsi 描述板级信息(也就是开发板上有哪些 IIC 设备、SPI 设备等，由芯片厂提供)，.dts 描述 SOC 级信息(各个外设控制器信息、那个iic上挂哪个传感器等)，这样写的好处是，将芯片平台与下游odm分开，通过dts拓展原始基础dtsi。

节点

根节点是设备树必须要包含的节点。根节点的名字是/。
子节点格式为

[label:]node-name[@unit-address]{
	[properties definitions]
	[child nodes]
};
举例：
node1{//子节点，节点名称为node1
	node1_child{//子子节点，节点名称为node1_child
	}；
}；

同级节点下节点名称不能相同，不通级节点名称可以相同。
label 标签：引入 label 的目的就是为了方便访问节点，可以直接通过&label 来访问这个节点。
node-name名称：必须要有。
unit-address：设备地址，这里的设备地址没有实际用处，只是为了代码可读性的要求。

特殊节点

• aliases
  特殊节点aliases用来定义别名。定义别名的目的就是为了方便引用节点。当然，除了使用aliases来命名别用，也可以在对节点命名的适合添加标签来命名别名。

举例:
aliases(
	mmc0= &sdmmc0
	mmc1 = &sdmmc1:
	mmc2 = &sdhci:
	serial0="/simple@fe000000/serial@llc500”
}

• choosen
  chosen节点用来uboot给内核传递参数。重点是bootargs参数。chosen节点必须是根节点的子节点。举例:

chosen{
	bootargs = "root=/dev/nfs rw nfsroot=192.168.1.1 console=ttyS0,115200"
}

属性

• compatible：“兼容性”属性，该属性的值是一个字符串列表，compatible属性用于将设备和驱动绑定起来属性的值格式：“manufacturer,model”
  其中，manufacturer 表示厂商，model 一般是模块对应的驱动名字；如果该属性为字符串列表，则先使用第一个兼容值在 Linux
  内核里面查找，没找到的话再使用第二个兼容值查找 |
• model：描述设备模块信息，一般为名字，例如：model = “wm8960-audio”;
• status：字符串，设备的状态信息，包括：“okay”、“disabled”、“fail”、“fail-xxx”（各种错误信息）
• #addresscells 和#size-cells：无符号 32 位整型，用于描述子节点的地址信息#address-cells决定了子节点 reg
  属性中地址信息所占用的字长，#size-cells决定了长度信息所占用的字长。
• reg：寄存器信息，
  例如：父节点#address-cells值为1，#size-cells值为1，则子节点中reg的值就是一个首地址加一个地址长度为一个单元，子节点可以reg=<0x100000000 0x0100 0x200000000 0x0100>；父节点#address-cells值为1，#size-cells值为0，则子节点中reg的值就是一个首地址加一个地址长度为一个单元，子节点可以reg=<0x100000000 0x200000000>；
• ranges 属性：是一个地址映射/转换表，它可以为空，即“ranges；”，为空值，说明子地址空间和父地址空间完全相同，不需要进行地址转换。
  不为空时，格式：child-bus-address,parent-bus-address,length；
  child-bus-address：子总线地址空间的物理地址，由父节点的#address-cells 确定此物理地址所占用的字长。
  parent-bus-address： 父总线地址空间的物理地址，同样由父节点的#address-cells 确定此物理地址所占用的字长。
  length： 子地址空间的长度，由父节点的#size-cells 确定此地址长度所占用的字长。
• device_type：在某些设备树文件中，可以看到device_type属性，device_type属性的值是字符串，只用于cpu节点或者memory节点进行描述。
• 自定义：自由发挥

节点含义

如果包含gpio-controller，该节点就是gpio控制器；
如果包含interrupt-controller，该节点就是gpio控制器；

引用

interrunt-parent=<&gpio0>;

追加内容

向节点追加内容，相当于硬件上，在soc厂商的基础上，添加字节的硬件。比如，要在iic总线上挂载一个六轴设备，soc厂商可能给一个例程，也可能不给，就要自己修改和添加。
比如dtsi中：

i2c1: i2c@021a0000 {
	#address-cells = <1>;
	#size-cells = <0>;
	compatible = "fsl,imx6ul-i2c", "fsl,imx21-i2c";
	reg = <0x021a0000 0x4000>;
	interrupts = <GIC_SPI 36 IRQ_TYPE_LEVEL_HIGH>;
	clocks = <&clks IMX6UL_CLK_I2C1>;
	status = "disabled";
};

可以直接在dtsi中加，但是代码复用性就降低了。在dts中追加：

&i2c1 {
	clock-frequency = <100000>;
	pinctrl-names = "default";
	pinctrl-0 = <&pinctrl_i2c1>;
	status = "okay";

	mag3110@0e {
		compatible = "fsl,mag3110";
		reg = <0x0e>;
		position = <2>;
	};

	ap3216c@1e {
		compatible = "ap3216c";
		reg = <0x1e>;
	};
};

这里就追加了几个属性和两个子节点。
其中，status属性进行了改写，属性名形同时，追加的值会覆盖原有的值。

实例分析

中断

在中断控制器中，必须有一个属性#interrupt-cells，表示其他节点如果使用这个中断控制器需要几个cell来表示使用哪一个中断。
在中断控制器中，必须有一个属性interrupt-controller，表示他是中断控制器。
在设备树中使用中断，需要使用属性interrupt-parent=<&XXXX>表是中断信号链接的是哪个中断控制器。接着使用interrupts属性来表示中断引脚和触发方式。
注: interrupt里有几个cell，是由interrupt-parent对应的中断控制器里面的#interrupt-cells属性决定。

//原厂BSP工程师编写
gpio1: gpio@209c000{
	compatible = "fsl,imx6ul-gpio"，"fsl,imx35-gpio";
	reg = <0x0209c000 0x4000>;
	interrupts = <GIC_SPI 66 IROTYPE LEVEL HIGH>,<GIC SPI 67 IRO TYPE LEVEL HIGH>;
	gpio-controller;//该节点可以是gpio控制器
	#gpio-cells = <2>;
	interrupt-controller;//该节点也可以是中断控制器
	#interrupt-cells = <2>;//引用该节点的节点中，interrupt-controller属性中数据的个数
}

//开发人员编写
edt-ft5x06g38{
	compatible = "edt,edt-ft5x06”，"edt,edt-ft5406"，"edtedt-ft5306"；
	pinctrl-names = "default";
	pinctrl-0 = <&ts_int_pin,
				&ats_reset_pin>;
	reg = <0X38>;
	interrupt-parent = <&gpio1>;
	interrupts = <9 0>;
	reset-gpios = <&gpio5 9 GPIO ACTIVE_LOW>;//低电平触发
	irq-gpios = <&gpio1 9 GPIO ACTIVE LOW>;
	status = "disabled";
}

设备树信息读取（of函数）

设备树被内核解析以后，可以在/proc/device-tree/目录中查看。

设备树机制是源于IEEE 1275 Open Firmware standard规范，相关的代码都是继承下来的，因此内核中设备树相关的函数都是以of开头的。
位置：include/linux/of.h
Linux设备树常用的OF函数总结