【Linux驱动开发】Linux设备树详解

DTB（.dtb）

设备树编译文件

.dtsi

设备树头文件（描述SOC级信息：CPU 架构、主频、外设寄存器地址范围等）

make dtbs

仅编译设备树

model 属性

值是字符串，一般描述设备模块信息，例如名字。

status 属性

值是字符串，设备的状态信息。

#address - cells #size - cells 属性

值是无符号 32 位整形。可以用在任何拥有子节点的设备中，用于描述子节点的地址信息。#address-cells 属性值决定了子节点 reg 属性中地址信息所占用的字长(32 位 )，#size-cells 属性值决定了子节点 reg 属性中长度信息所占的 字长 (32 位 )。

reg 属性

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

ranges 属性

ranges 是一个地址映射/ 转换表， ranges 属性每个项目由子地址、父地址和地址空间长度 这三部分组成。如果 ranges 属性值为空值，说明子地址空间和父地址空间完全相同，不需要进行地址转换。

name 属性

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

device_type 属性

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

根节点的子节点

aliases、 backlight 、 chosen 、 clocks...

通过 device_type 属性查找指定的节点

struct device_node * of_find_node_by_type (struct device_node *from, const char *type)from ：开始查找的节点，如果为 NULL 表示从根节点开始查找整个设备树。type ：要查找的节点对应的 type 字符串，也就是 device_type 属性值。返回值 ：找到的节点，如果为 NULL 表示查找失败。

根据 device_type 和 compatible 两个属性查找指定的节点

struct device_node * of_find_compatible_node (struct device_node *from,const char *type, const char *compatible)from ：开始查找的节点，如果为 NULL 表示从根节点开始查找整个设备树。type ：要查找的节点对应的 device_type 属性值，可以为 NULL ，表示忽略 device_type 属性。compatible ： 要查找的节点所对应的 compatible 属性列表。返回值 ：找到的节点，如果为 NULL 表示查找失败

通过 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 表示查找失败

通过路径来查找指定的节点

inline struct device_node * of_find_node_by_path (const char *path)path ：全路径的节点名，可以使用节点的别名，比如“ /backlight ”就是 backlight 这个节点的全路径。返回值 ：找到的节点，如果为 NULL 表示查找失败

用迭代的查找子节点

struct device_node * of_get_next_child (const struct device_node *node,struct device_node *prev)node ：父节点。prev ：前一个子节点，从此开始迭代的查找下一个子节点。NULL，表示从第一个子节点开始。返回值 ：找到的下一个子节点。

用于获取属性中元素的数量（获取到属性数组的大小）

int of_property_count_elems_of_size (const struct device_node *np, const char *propname,int elem_size)np ：设备节点；proname： 属性名；elem_size：元素长度；返回值 ：得到的属性元素数量。

用于从属性中获取指定标号的 u32 类型数据值

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 表示属性值列表太小。

读取属性中 u8 、 u16 、 u32 和 u64 类型的数组数据

int of_property_read_u8_array (const struct device_node *np, const char *propname, u8 *out_values, size_t sz)of_property_read_u16_arrayof_property_read_u32_arrayof_property_read_u64_arraynp ：设备节点。proname ： 要读取的属性名字。out_value ：读取到的数组值，分别为 u8 、 u16 、 u32 和 u64。sz ：要读取的数组元素数量。

用于读取这种只有一个整形值的属性

int of_property_read_u8(const struct device_node *np, const char *propname, u8 *out_value)of_property_read_u16of_property_read_u32of_property_read_u64np ：设备节点。proname ： 要读取的属性名字。out_value ：读取到的数组值。返回值 ：0 ：读取成功，负值：读取失败， -EINVAL ：属性不存在， -ENODATA：没有要读取的数据，-EOVERFLOW：属性值列表太小。

用于读取属性中字符串值

int of_property_read_string(struct device_node *np, const char *propname,const char **out_string)np ：设备节点。proname ： 要读取的属性名字。out_string ：读取到的字符串值。返回值 ：0：读取成功，负值：读取失败。

用于获取 #address-cells 属性值

int of_n_addr_cells(struct device_node *np)np ：设备节点。返回值 ：获取到的 #address-cells 属性值。

用于获取 #size-cells 属性值

int of_n_size_cells (struct device_node *np)np ：设备节点。返回值 ：获取到的 #size-cells 属性值。

用于获取地址相关属性，主要是“ 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 等返回值 ：读取到的地址数据首地址，为 NULL 的话表示读取失败。

将从设备树读取到的地址转换为物理地址

u64 of_translate_address (struct device_node *dev, const __be32 *in_addr)dev ：设备节点。in_addr ：要转换的地址。返回值 ：得到的物理地址，如果为 OF_BAD_ADDR 的话表示转换失败。

从设备树里面提取资源值，将 reg 属性值转换为 resource 结构体类型

int of_address_to_resource(struct device_node *dev, int index, struct resource *r)dev ：设备节点。index ：地址资源标号。r ：得到的 resource 类型的资源值。返回值 ：0，成功；负值，失败。

将 reg 属性中地址信息转换为虚拟地址

void __iomem * of_iomap (struct device_node *np, int index)np ：设备节点。index ： reg 属性中要完成内存映射的段，如果 reg 属性只有一段的话 index 就设置为 0。返回值 ：经过内存映射后的虚拟内存首地址，如果为 NULL 的话表示内存映射失败。