0.设备树由来

通过前面platform实验，使用platform总线，device与driver需要匹配才可以，device主要是存储一些硬件信息的，传递给driver使用。这样就会导致大量的硬件信息在linux内核源码里面，arch/arm/mach-xxx 和 arch/arm/plat-xxx 文件夹下，这些文件夹里面的文件就是对应平台下 的板级信息，当 Linux 之父 linus 看到 ARM 社区向 Linux 内核添加了大量“无用”、冗余 的板级信息文件，不禁的发出了一句“This whole ARM thing is a f*cking pain in the ass”。从此以 后 ARM 社区就引入了 PowerPC 等架构已经采用的设备树(Flattened Device Tree)，将这些描述 板级硬件信息的内容都从 Linux 内中分离开来，用一个专属的文件格式来描述，这个专属的文 件就叫做设备树，文件扩展名为.dts。

1.设备树概念

设备树(Device Tree)，将这个词分开就是“设备”和“树”，描述设备树的文件叫做 DTS(Device Tree Source)，这个 DTS 文件采用树形结构描述板级设备，也就是开发板上的设备信息，比如 CPU 数量、 内存基地址、IIC 接口上接了哪些设备、SPI 接口上接了哪些设备等等。

说白了设备树就是存储硬件信息的描述文件，由系统·解析设备树文件，生成相应的device，然后与相应的驱动进行匹配，driver也可以通过设备树设备信息获取设备硬件信息，这些信息都是在设备树里面的。

1.1.DTS、DTB 和 DTC 和 dtsi 概念

DTS 是设备树源码文件，设备树源文件扩展名为.dts

DTB 是将 DTS 编译以后得到的二进制文件

DTC是将么将.dts 编译为.dtb的工具，DTC 工具源码在 Linux 内核的 scripts/dtc 目录下

dtsi,由于一个SoC可能对应多个设备（一个SoC可以对应多个产品和电路板），这些.dts文件势必须包含许多共同的部分，Linux内核为了简化，把SoC公用的部分或者多个设备共同的部分一般提炼为.dtsi，类似于C语言的头文件。其他的设备对应的.dts就包括这个.dtsi。

2.设备树语法

2.1.例子

/ {aliases {can0 = &flexcan1;};cpus {#address-cells = <1>;#size-cells = <0>;cpu0: cpu@0 {compatible = "arm,cortex-a7";device_type = "cpu";reg = <0>;};};intc: interrupt-controller@00a01000 {compatible = "arm,cortex-a7-gic";#interrupt-cells = <3>;interrupt-controller;reg = <0x00a01000 0x1000>,<0x00a02000 0x100>;};
}

 2.2.设备节点

设备树是采用树形结构来描述板子上的设备信息的文件，每个设备都是一个节点，叫做设 备节点，每个节点都通过一些属性信息来描述节点信息，属性就是键—值对。每个节点都有不同属性，不同的属性又有不同的内容，属性都是键值对，值可以为空或任 意的字节流。

2.2.1.节点命名

label: node-name@unit-address

“label" 前面的是节点标签(label)

“node-name” 是节点名字，为 ASCII 字符串，节点名字应该能够清晰的描述出节点的 功能

“unit-address”一般表示设备的地址或寄 存器首地址，如果某个节点没有地址或者寄存器的话“unit-address”可以不要。

如：

cpu0:cpu@0

cpu0是标签，cpu这个设备，寄存器地址是0，

2.2.2节点数据类型

①、字符串 compatible = "arm,cortex-a7"; 上述代码设置 compatible 属性的值为字符串“arm,cortex-a7”。

②、32 位无符号整数 reg =<0> ; 上述代码设置 reg 属性的值为 0，reg 的值也可以设置为一组值，比如：  reg = <0x00a01000 0x1000>, <0x00a02000 0x100>;,reg是描述地址字段

③、字符串列表 属性值也可以为字符串列表，字符串和字符串之间采用“,”隔开，如下所示： compatible = "fsl,imx6ull-gpmi-nand", "fsl, imx6ul-gpmi-nand"; 上述代码设置属性 compatible 的值为“fsl,imx6ull-gpmi-nand”和“fsl, imx6ul-gpmi-nand”。

2.2.3.根节点

“/”是根节点，每个设备树文件只有一个根节点。如果dtsi与dts这两个文件都有一个“/”根节点，这种情况是允许的，因为 这两个“/”根节点的内容会合并成一个根节点。

2.2.4.属性介绍

节点是由一堆的属性组成，节点都是具体的设备，不同的设备需要的属性不同，用户可以 自定义属性。除了用户自定义属性，有很多属性是标准属性，Linux 下的很多外设驱动都会使用 这些标准属性。

2.2.4.1.compatible属性

compatible 属性也叫做“兼容性”属性，这是非常重要的一个属性！compatible 属性的值是 一个字符串列表，compatible 属性用于将设备和驱动绑定起来。字符串列表用于选择设备所要 使用的驱动程序，compatible 属性的值格式如下所示：

compatible = "manufacturer,model"

其中 manufacturer 表示厂商，model 一般是模块对应的驱动名字。 一般驱动程序文件都会有一个 OF 匹配表，此 OF 匹配表保存着一些 compatible 值，如果设 备节点的 compatible 属性值和 OF 匹配表中的任何一个值相等，那么就表示设备可以使用这个 驱动。也可以不按照这个格式填，只要与驱动的名字一样，完成匹配就可以了，但是这样阅读性不好，建议还是按照这个模式填写。 

如：

compatible = "fsl,mpc8349-uart", "ns16550"

设备的 compatible 属性应为：. fsl,mpc8349-uart指定确切的设备，并ns16550声明它与 National Semiconductor 16550 UART 的寄存器级兼容。

2.2.4.2.name属性

name 属性值为字符串，name 属性用于记录节点名字，name 属性已经被弃用，不推荐使用 name 属性，一些老的设备树文件可能会使用此属性。

2.2.4.3.status 属性

status 属性是和设备状态有关的，status 属性值也是字符串，字符串是设备的 状态信息

如：

status = "okay";

2.2.4.5.unit-address属性

如cpu@0：遵循<name>[@<unit-address>]格式

unit-address就是单元地址，设备的私有地址，在节点reg属性中描述

2.2.4.6.address-cells属性与size-cells属性

这两个属性的值都是无符号 32 位整形，#address-cells 和#size-cells 这两个属性可以用在任 何拥有子节点的设备中，用于描述子节点的地址信息。#address-cells 属性值决定了子节点 reg 属 性中地址信息所占用的字长(32 位)，#size-cells 属性值决定了子节点 reg 属性中长度信息所占的字长(32 位)。#address-cells 和#size-cells 表明了子节点应该如何编写 reg 属性值，一般 reg 属性 都是和地址有关的内容，和地址相关的信息有两种：起始地址和地址长度，reg 属性的格式一为：

reg = <address1 length1 address2 length2 address3 length3……>

每个“address length”组合表示一个地址范围，其中 address 是起始地址，length 是地址长 度，#address-cells 表明 address 这个数据所占用的字长，#size-cells 表明 length 这个数据所占用 的字长

如：

#address-cells =<1> ，#size-cells =<0>

说明 spi4 的子节点 reg 属 性中起始地址所占用的字长为 1，地址长度所占用的字长为 0

2.2.4.7reg属性

reg 属性的值一般是(address，length)对。reg 属性一般用于描 述设备地址空间资源信息，一般都是某个外设的寄存器地址范围信息。

如：

reg = <<0x02280000 0x4000>;

起始地址为 0x02280000，地址长度为 0x40000 

2.2.4.8.range属性

ranges属性值可以为空或者按照(child-bus-address,parent-bus-address,length)格式编写的数字 矩阵。

ranges 是一个地址映射/转换表，ranges 属性每个项目由子地址、父地址和地址空间长度 这三部分组成：

child-bus-address：子总线地址空间的物理地址，由父节点的#address-cells 确定此物理地址 所占用的字长。

parent-bus-address：父总线地址空间的物理地址，同样由父节点的#address-cells 确定此物 理地址所占用的字长。

length：子地址空间的长度，由父节点的#size-cells 确定此地址长度所占用的字长。

如果 ranges 属性值为空值，说明子地址空间和父地址空间完全相同，不需要进行地址转换

如：

ranges = <<0x0 0xe0000000 0x00100000>;

此属性值指定 了一个 1024KB(0x00100000)的地址范围，子地址空间的物理起始地址为 0x0，父地址空间的物 理起始地址为 0xe0000000 

2.2.4.9device_type 属性

device_type 属性值为字符串，IEEE 1275 会用到此属性，用于描述设备的 FCode，但是设 备树没有 FCode，所以此属性也被抛弃了。此属性只能用于 cpu 节点或者 memory 节点 。

2.2.4.10.aliases 属性

    aliases {can0 = &flexcan1;};

单词 aliases 的意思是“别名”，因此 aliases 节点的主要功能就是定义别名，定义别名的目的就是为了方便访问节点。不过我们一般会在节点命名的时候会加上 label，然后通过&label来访问节点，这样也很方便，而且设备树里面大量的使用&label 的形式来访问节点

2.2.4..11chosen属性

chosen 并不是一个真实的设备， chosen 节点主要是为了 uboot 向 Linux 内核传递数据，重点是 bootargs 参数。

chosen 节点的 bootargs 属性不是我们在设备树里面设置的，那么只有一种可能，那就是 uboot 自己在 chosen 节点里面添加了 bootargs 属性！并且设置 bootargs 属性的值为 bootargs环境变量的值。因为在启动 Linux 内核之前，只有 uboot 知道 bootargs 环境变量的值，并且 uboot也知道.dtb 设备树文件在 DRAM 中的位置，感兴趣的，可以看一下uboot源码，common/fdt_support.c 文件中有个 fdt_chosen 函数。

2.2.5.向节点追加或修改内容

引入另外一个内容，那就是如何向节点追加数据,特别是针对在dtsi里面的节点，这种时候就需要追加了，不要直接在节点下修改，除非是给其他soc都使用的。

&i2c1 {/* 要追加或修改的内容 */
};

 

参考：

Linux设备树特殊节点（ aliases、chosen ）介绍_stdout-path-CSDN博客

【Linux驱动开发】设备树详解（二）设备树语法详解_linux设备树语法-CSDN博客