掌握设备树是 Linux驱动开发人员必备的技能！
1、了解设备树文件
在3.x版本以前的Linux内核源码中，存在大量的“arc/arm/mach-xxx”和“arc/arm/plat-xxx”文件夹，里面很多个“.c”和“.h”文件，它们用来描述设备信息。而现在的ARM架构是采用“设备树”来描述设备信息。“设备树”英文名字叫“Device Tree”。描述设备树的文件叫做“DTS”，是Device Tree Source的缩写。它主要用来描述板子上有哪些设备构成，如：I2C控制器、GPIO控制器、SPI控制器、UART控制器等。
设备树源文件扩展名为“.dts”，设备树头文件扩展名为“.dtsi”,它们经过DTC工具编译后生成的二进制文件，就是“.dtb”文件。
“.dts”设备树文件可以通过“#include”来引用“.h”、“.dtsi”和“.dts”文件。在编写设备树头文件时，我们最好选择“.dtsi”作为后缀。
一般“.dtsi”文件用于描述芯片的“内部外设信息”，比如CPU架构、主频、外设寄存器地址范围，如：UART、IIC、SPI、TIMER等等。
2、了解节点
设备树是描述板子上的“设备信息”的文件，均采用“树形结构”。每个设备树文件只有一个“根节点”，而“不同设备树文件的根节点”会合在一起形成一个根节点。每个设备都是一个节点，称之为“设备节点”，每个节点都采用“属性信息”来描述其“节点信息”。
认识“标准属性”、“节点”和“节点标签”，见下图：
标准属性
1)、compatiable属性，也叫兼容性属性。
如：compatible = "cirrus,cs42l51";
这个compatible只有一个属性值，就是“cirrus,cs42l51”，其中“cirrus”表示厂商，“cs42l51”表示驱动模块。
再如：compatible = "cirrus,cs42l51","cirrus,My_cs42l51";
这个compatible就有两个属性值，就是“cirrus,cs42l51”和"cirrus,My_cs42l51"，其中“cirrus”表示厂商，“cs42l51”表示驱动模块，“My_cs42l51”表示驱动模块。
驱动文件的“OF匹配表”
const struct of_device_id cs42l51_of_match[] = { { .compatible = "cirrus,cs42l51", },{ }};
设备首先会使用第一个兼容值在Limux内核里面查找。看看能不能找到与之匹配的驱动文件，如果没有找到，就使用第二个兼容值查，以此类推，直到查找完 commpatible属性中的所有值。
compatible属性用于将设备和驱动绑定起来。驱动程序文件有一个“OF匹配表”，这个“OF匹配表”保存着一些compatible的值，如果设备节点的compatible属性值和“OF匹配表”中的任何一个值相等，那么这个设备就可以使用这个驱动。
2)、model属性
用于描述开发板的名字或设备模块的信息。
比如：model = "STMicroelectronics STM32MP157C-DK2 Discovery Board";
3)、status属性
| status属性值 | 描述 |
| “okay” | 表明设备是可操作的 |
| “disabled” | 表明设备当前是不可操作的，但是在未来可以变为可操作的，比如：热插拔设备插入以后。至于disabled的具体含义还要看设备的绑定文档。 |
| “fail” | 表明设备不可操作，设备检测到了一系列的错误，而且设备也不大可能变得可操作。 |
| “fail-sss” | 含义和“fai1”相同，后面的“sss部分”是检测到的错误内容。 |
4)、reg属性
reg属性的值一般是(address，length)对。
reg 属性一般用于描述“设备地址空间资源信息”或者“设备地址信息”，比如某个外设的“寄存器地址范围信息”，或者I2C器件的设备地址等。
5)、ranges属性
ranges = <child-bus-address,parent-bus-address,length>;
child-bus-address表示“子总线地址空间的物理地址”；
parent-bus-address表示“父总线地址空间的物理地址”；
length表示“子总线地址空间的长度”；
若ranges属性值为空，则说明子地址空间和父地址空间完全相同；
6)、“#address-cells”和“#size-cells”属性
#address-cells的属性值为无符号32位整型，用于描述子节点的“reg和ranges”中的address所占的位数，1表示32位，2表示64位；
#size-cells的属性值为无符号32位整型，用于描述子节点的“reg和ranges”中的length所占的位数，0表示没有位数，1表示32位，2表示64位；
举例说明“reg、 #address-cells和#size-cells”属性：
cpus { #address-cells = <1>;//表示子节点cpu的reg和ranges的address占32个位
#size-cells = <0>; //表示子节点cpu的reg和ranges的length占0个位 cpu0: cpu@0 { compatible = "arm,cortex-a7"; device_type = "cpu"; reg = <0>; //表示addres=0, 没有length，和前面定义一致
clocks = <&scmi0_clk CK_SCMI0_MPU>; clock-names = "cpu"; operating-points-v2 = <&cpu0_opp_table>; nvmem-cells = <&part_number_otp>; nvmem-cell-names = "part_number"; #cooling-cells = <2>; }; };
scmi_sram: sram@2ffff000 { compatible = "mmio-sram"; reg = <0x2ffff000 0x1000>; //表示address=0x2ffff000，length=0x1000
#address-cells = <1>;//表示scmi_shm的reg和ranges的address占32个位
#size-cells = <1>; //表示scmi_shm的reg和ranges的length占32个位
ranges = <0 0x2ffff000 0x1000>; //分别为32位，和前面定义一致
scmi0_shm: scmi_shm@0 { reg = <0 0x80>; //reg的address和length分别为32位，和前面定义一致
};
};
soc {
compatible = "simple-bus"; #address-cells = <1>; //表示sram的reg和ranges的addres长度为32个位 #size-cells = <1>; //表示sram的reg和ranges的length长度为32个位
interrupt-parent = <&intc>; ranges = <0 0x10000000 0x100000>;
sram: sram@10000000 { compatible = "mmio-sram"; reg = <0x0 0x60000>;//reg的address和length均为32位，和前面定义一致
#address-cells = <1>; #size-cells = <1>; ranges = <0 0x10000000 0x60000>; //均为32位，和前面定义一致
};};
以STM32MP157为例，创建设备树文件myfrst.dts ，要求在设备树里面的内容如下:
1)、芯片是由两个Cortex-A7 架构的32位CPU和Cortex-M4组成。
2)、STM32MP157内部sram，起始地址为 0x10000000，大小为384KB(0x60000)。
先搭建 “根节点框架”，如下：
/{ compatible = "st,stm32mp157d-atk", "st,stm32mp157"; };
接着添加cpus节点，如下：
/{ compatible = "st,stm32mp157d-atk", "st,stm32mp157"; cpus{
#address-cells = <1>;//表示子节点cpu的reg和ranges的address占32个位
#size-cells = <0>; //表示子节点cpu的reg和ranges的length占0个位
};
};
接着添加cpu0节点，如下：
/{ compatible = "st,stm32mp157d-atk", "st,stm32mp157"; cpus{
#address-cells = <1>;//表示子节点cpu的reg和ranges的address占32个位
#size-cells = <0>; //表示子节点cpu的reg和ranges的length占0个位
cpu0: cpu@0 { compatible = "arm,cortex-a7"; device_type = "cpu"; reg = <0>; //表示addres=0, 没有length，和前面定义一致
};
};
};
接着添加cpu1节点，如下：
/{ compatible = "st,stm32mp157d-atk", "st,stm32mp157"; cpus{
#address-cells = <1>;//表示子节点cpu的reg和ranges的address占32个位
#size-cells = <0>; //表示子节点cpu的reg和ranges的length占0个位
cpu0: cpu@0 { compatible = "arm,cortex-a7"; device_type = "cpu"; reg = <0>; //表示addres=0, 没有length，和前面定义一致
};
cpu1: cpu@1 { compatible = "arm,cortex-m4"; device_type = "cpu"; reg = <1>; //表示addres=1, 没有length，和前面定义一致
};
};
};
接着添加soc节点，如下：
/{ compatible = "st,stm32mp157d-atk", "st,stm32mp157"; cpus{
#address-cells = <1>;//表示子节点cpu的reg和ranges的address占32个位
#size-cells = <0>; //表示子节点cpu的reg和ranges的length占0个位
cpu0: cpu@0 { compatible = "arm,cortex-a7"; device_type = "cpu"; reg = <0>; //表示addres=0, 没有length，和前面定义一致
};
cpu1: cpu@1 { compatible = "arm,cortex-m4"; device_type = "cpu"; reg = <1>; //表示addres=1, 没有length，和前面定义一致
};
};
soc {
compatible = "simple-bus"; #address-cells = <1>; //表示sram的reg和ranges的addres长度为32个位 #size-cells = <1>; //表示sram的reg和ranges的length长度为32个位
ranges; //说明子地址空间和父地址空间完全相同；
};
};
接着添加sram节点，如下：
/{ compatible = "st,stm32mp157d-atk", "st,stm32mp157"; cpus{
#address-cells = <1>;//表示子节点cpu的reg和ranges的address占32个位
#size-cells = <0>; //表示子节点cpu的reg和ranges的length占0个位
cpu0: cpu@0 { compatible = "arm,cortex-a7"; device_type = "cpu"; reg = <0>; //表示addres=0, 没有length，和前面定义一致
};
cpu1: cpu@1 { compatible = "arm,cortex-m4"; device_type = "cpu"; reg = <1>; //表示addres=1, 没有length，和前面定义一致
};
};
soc {
compatible = "simple-bus"; #address-cells = <1>; //表示sram的reg和ranges的addres长度为32个位 #size-cells = <1>; //表示sram的reg和ranges的length长度为32个位
ranges; //说明子地址空间和父地址空间完全相同；
sram: sram@10000000 { compatible = "mmio-sram"; reg = <0x0 0x60000>;//address和length均为32位，和前面定义一致
ranges = <0 0x10000000 0x60000>; //均为32位，和前面定义一致
};
};
};
3、了解特殊节点
1)、aliases子节点
aliases {
serial0 = &uart4; //给&uart4起个别名叫“serial0”
};
2)、chosen子节点
chosen不是一个真实的设备，chosen节点主要是为了uboot向 Linux内核传递数据。
chosen {
stdout-path = "serial0:115200n8";
//设置“stdout-path”属性，表示标准输出使用“serial0”
};
4、学习“OF函数”
“OF函数原型”都定义在“include/linux/of.h”文件中。
1)、了解相关结构体
Linux内核使用device_node结构体来描述一个节点。
struct device_node {
const char *name; /*节点名字*/
phandle phandle;
const char *full_name; /*节点全名*/
struct fwnode_handle fwnode;
struct property *properties; /*属性*/
struct property *deadprops; /* removed properties */
struct device_node *parent; /*父节点*/
struct device_node *child; /*子节点*/
struct device_node *sibling;
#if defined(CONFIG_OF_KOBJ)
struct kobject kobj;
#endif
unsigned long _flags;
void *data;
#if defined(CONFIG_SPARC)
unsigned int unique_id;
struct of_irq_controller *irq_trans;
#endif
};
Linux内核中使用结构体property表示属性
struct property {
char *name; /*属性名字*/
int length; /*属性长度*/
void *value; /*属性值*/
struct property *next; /*下一个属性*/
#if defined(CONFIG_OF_DYNAMIC) || defined(CONFIG_SPARC)
unsigned long _flags;
#endif
#if defined(CONFIG_OF_PROMTREE)
unsigned int unique_id;
#endif
#if defined(CONFIG_OF_KOBJ)
struct bin_attribute attr;
#endif
}
resource结构体定义在文件 include/linux/ioport.h中。
struct resource {
resource_size_t start; /*开始地址，占32位*/
resource_size_t end; /*结束地址，占32位*/
const char *name; /*资源的名字*/
unsigned long flags; /*资源标志或资源类型*/
unsigned long desc;
struct resource *parent, *sibling, *child;
};
2)、通过节点的名字查找指定的节点：
struct device_node *of_find_node_by_name(struct device_node *from, const char *name)
from:开始查找的节点，如果为NULL，表示从根节点开始查找整个设备树。
name:要查找的节点名字。
返回值:返回找到的节点，如果为NULL，表示查找失败。
3)、通过device_type属性查找指定的节点
struct device_node *of_find_node_by_type(struct device_node *from, const char *type)
from:开始查找的节点，如果为NULL,表示从根节点开始查找整个设备树；
type:要查找的节点对应的type字符串，也就是 device_type属性值。
返回值:返回找到的节点，如果为NULL，表示查找失败。
4)、根据device_type属性和compatible属性查找指定的节点
struct device_node *of_find_compatible_node(struct device_node *from, const char *type, const char *compatible)
from:开始查找的节点，如果为NULL,表示从根节点开始查找整个设备树；
type:要查找的节点对应的type字符串，也就是device_type属性值。若为NULL,则可忽略掉device_type属性值；
compatible：要查找的节点所对应的compatible 属性列表；
返回值:返回找到的节点，如果为NULL，表示查找失败。
5)、通过of_device_id匹配表来查找指定的节点
struct device_node *of_find_matching_node_and_match(struct device_node *from, const struct of_device_id *matches, const struct of_device_id **match)
from:开始查找的节点，如果为NULL,表示从根节点开始查找整个设备树。matches: of_device_id匹配表，也就是在此匹配表里面查找节点。
match:找到的匹配的of_device_id
返回值:返回找到的节点，如果为NULL，表示查找失败。
6)、通过路径来查找指定的节点
inline struct device_node *of_find_node_by_path(const char *path)
path:带有全路径的节点名，可以使用节点的别名，比如“/backlight”就是 backlight 这个节点的全路径。
返回值:返回找到的节点，如果为NULL，表示查找失败。
7)、获取指定节点的父节点
struct device_node *of_get_parent(const struct device_node *node)
node:要查找的父节点的节点名称。返回值: 返回找到的父节点。
8)、采用迭代方式查找子节点，即查找“prev”的下一个节点。
struct device_node *of_get_next_child(const struct device_node *node, struct device_node *prev)
node:父节点。
prev:前一个子节点，也就是从哪一个子节点开始迭代的查找下一个子节点。若设置为NULL，则表示从第一个子节点开始。
返回值: 返回找到的下一个子节点。
9)、查找指定的属性
property *of_find_property(const struct device_node *np, const char *name, int *lenp)
np:设备节点。
name:属性名字。
lenp:属性值的字节数
返回值:返回找到的属性。
10)、获取属性中元素的数量
int of_property_count_elems_of_size(const struct device_node *np, const char *propname, int elem_size)
np:设备节点。
proname:需要统计元素数量的属性名字。
elem_size:元素长度。
返回值: 返回得到的属性元素数量。
11)、从属性中获取指定标号的数据值
int of_property_read_u32_index(const struct device_node *np, const char *propname, u32 index, u32 *out_value)
np:设备节点。
proname:要读取的属性名字。index:要读取的值标号;
out_value:读取到的值返回值:0读取成功，负值，读取失败，-EINVAL表示属性不存在，-ENODATA 表示没有要读取的数据，-EOVERFLOW 表示属性值列表太小。
12)、读取属性中u8类型的数组数据
int of_property_read_u8_array(const struct device_node *np, const char *propname, u8 *out_values, size_t sz)
np:设备节点。proname:要读取的属性名字。out_value:读取到的数组值，数据类型为u8。
sz:要读取的数组元素数量。返回值:0，读取成功，负值，读取失败，-EINVAL 表示属性不存在，-ENODATA 表示没有要读取的数据，-EOVERFLOW 表示属性值列表太小。
13)、读取属性中u16类型的数组数据
int of_property_read_u16_array(const struct device_node *np, const char *propname, u16 *out_values, size_t sz)
np:设备节点。proname:要读取的属性名字。out_value:读取到的数组值，数据类型为u16。sz:要读取的数组元素数量。返回值:0，读取成功，负值，读取失败，-EINVAL 表示属性不存在，-ENODATA 表示没有要读取的数据，-EOVERFLOW 表示属性值列表太小。
14)、读取属性中u32类型的数组数据
int of_property_read_u32_array(const struct device_node *np, const char *propname, u32 *out_values, size_t sz)
np:设备节点。proname:要读取的属性名字。out_value:读取到的数组值，数据类型为u32。sz:要读取的数组元素数量。返回值:0，读取成功，负值，读取失败，-EINVAL 表示属性不存在，-ENODATA 表示没有要读取的数据，-EOVERFLOW 表示属性值列表太小。
15)、读取属性中u64类型的数组数据
int of_property_read_u64_array(const struct device_node *np, const char *propname, u64 *out_values, size_t sz)
np:设备节点。proname:要读取的属性名字。out_value:读取到的数组值，数据类型为u64。sz:要读取的数组元素数量。返回值:0，读取成功，负值，读取失败，-EINVAL 表示属性不存在，-ENODATA 表示没有要读取的数据，-EOVERFLOW 表示属性值列表太小。
16)、读取属性中只有一个u8类型的数据
int of_property_read_u8(const struct device_node *np, const char *propname, u8 *out_value)
np:设备节点。proname:要读取的属性名字。out_value:读取到的u8类型的数据值。返回值:0，读取成功，负值，读取失败，-EINVAL 表示属性不存在，-ENODATA 表示没有要读取的数据，-EOVERFLOW 表示属性值列表太小。
17)、读取属性中只有一个u16类型的数据
int of_property_read_u16(const struct device_node *np, const char *propname, u16 *out_value)
np:设备节点。proname:要读取的属性名字。out_value:读取到的u16类型的数据值。返回值:0，读取成功，负值，读取失败，-EINVAL 表示属性不存在，-ENODATA 表示没有要读取的数据，-EOVERFLOW 表示属性值列表太小。
18)、读取属性中只有一个u32类型的数据
int of_property_read_u16(const struct device_node *np, const char *propname, u32 *out_value)
np:设备节点。proname:要读取的属性名字。out_value:读取到的u32类型的数据值。返回值:0，读取成功，负值，读取失败，-EINVAL 表示属性不存在，-ENODATA 表示没有要读取的数据，-EOVERFLOW 表示属性值列表太小。
19)、读取属性中只有一个u64类型的数据
int of_property_read_u16(const struct device_node *np, const char *propname, u64 *out_value)
np:设备节点。proname:要读取的属性名字。out_value:读取到的u64类型的数据值。返回值:0，读取成功，负值，读取失败，-EINVAL 表示属性不存在，-ENODATA 表示没有要读取的数据，-EOVERFLOW 表示属性值列表太小。
20)、读取属性中的字符串值
int of_property_read_string(struct device_node *np, const char *propname, const char **out_string)
np:设备节点。proname:要读取的属性名字。out_string:读取到的字符串值。返回值:0，读取成功，负值，读取失败。
21)、获取“#address-cells”属性值
int of_n_addr_cells(struct device_node *np)
np:设备节点。返回值:返回“#address-cells”的属性值。
22)、获取“#size-cells”属性值
int of_n_size_cells(struct device_node *np)
np:设备节点。返回值:返回“#size-cells”的属性值。
23)、査看“节点的compatible属性”是否有包含“compat指定的字符串”，也就是检查设备节点的兼容性
int of_device_is_compatible(const struct device_node *device, const char *compat)
device:设备节点；
compat:要查看的字符串。返回值:0,表示“节点的compatible属性”中不包含“compat指定的字符串”;正数,表示“节点的compatible属性”中包含“compat指定的字符串”。
24)、读取“reg”或者“assigned-addresses”属性值
const __be32 *of_get_address(struct device_node *dev, int index, u64 *size, unsigned int *flags)
dev:设备节点。
index:要读取的地址标号。
size:地址长度。flags:参数，比如“IORESOURCE_IO”、“IORESOURCE_MEM”等返回值:返回读取到的地址数据首地址，若返回值为NUIL，则表示读取失败。
25)、将从设备树读取到的地址addr转换为物理地址
u64 of_translate_address(struct device_node *dev, const __be32 *addr)
dev:设备节点。
addr:要转换的地址。
返回值:返回得到的物理地址，如果为 OF_BAD_ADDR，则表示转换失败。
26)、将reg属性值转换为resource结构体类型
int of_address_to_resource(struct device_node *dev, int index, struct resource *r)
dev:设备节点。
index:地址资源标号
r:得到的resource 类型的资源值。
返回值:0，成功:负值，失败。
27)、将“reg属性中地址信息”转换为“虚拟地址”，如果reg属性有多段的话，可以通过index参数指定要完成内存映射的是哪一段
void __iomem *of_iomap(struct device_node *np, int index)
np:设备节点。
index:reg属性中要完成内存映射的段，如果reg属性只有一段的话，则index=0。
返回值:经过内存映射后的虚拟内存首地址，如果为NULL的话，则表示内存映射失败。
注意：也可以使用ioremap()函数来完成物理地址到虚拟地址的内存映射。在采用设备树以后，大部分的驱动都使用of_iomap()函数来获取内存地址所对应的虚拟地址。
