襄阳市建设委员网站网络营销工具
1.定义
设备树（device tree是描述硬件信息的一种树形结构，设备书文件在linux内核启动后被内核解析。描述一个硬件设备信息的节点我们叫做设备节点，一个设备节点内部包含当前硬件的多个不同属性，相同节点不同
2.设备树的文件格式
内核顶层目录下/arch/arm/boot/dts：设备树文件存放路径
单独编译设备树文件：make dtbs
***.dts//设备树源码文件
***.dtsi //设备树的补充文件或者头文件
|
|
DTC(编译设备树的编译工具)
|
|
***.dtb //编译后设备树的镜像文件
3.设备树的语法
3.1 设备树的语法实现
参考官网设备树语法解析文件：Device Tree Usage - eLinux.org
设备树是节点和属性的简单树结构。属性是键值对，节点可以同时包含属性和子节点。
/dts-v1/; //设备树的版本号/ { // '/'表示设备树的根节点，所有的节点信息都在根节点内部定义node1 { //node1是设备树根节点的子节点a-string-property = "A string"; //node1节点内部的属性，键值对a-string-list-property = "first string", "second string";// hex is implied in byte arrays. no '0x' prefix is requireda-byte-data-property = [01 23 34 56];child-node1 {//node1节点的子节点first-child-property; //空属性键值对，用来起到标识作用second-child-property = <1>;a-string-property = "Hello, world";};child-node2 {};};node2 { //根节点的子节点an-empty-property;a-cell-property = <1 2 3 4>; /* each number (cell) is a uint32 */child-node1 {};};
};- 设备树是从根节点开始描述的：/{};
- node1和node2是属于根节点的子节点
- 设备树文件内部注释和c语言一样 //
- 设备树每一条语句结束都以‘；’结尾
- 节点内的属性都是键值对
3.2 设备树中节点的命名
节点命名规则：[@
name指的是节点名字，是一个简单的 ASCII 字符串，长度最多为 31 个字符。通常，节点是根据它所代表的设备类型来命名的。如果节点使用地址描述设备，则包含unit-address ex:GPIO@50006000
3.3 键值对格式
属性是简单的键值对，其中值可以为空或包含任意字节流。虽然数据类型未编码到数据结构中，但可以在设备树源文件中表示一些基本数据表示形式。
文本字符串（以 null 结尾）用双引号表示： string-property = "a string";
“cell”是 32 位无符号整数，由尖括号分隔： cell-property = <0xbeef 123 0xabcd1234>;
二进制数据用方括号分隔： binary-property = [0x01 0x23 0x45 0x67];
不同表示形式的数据可以使用逗号连接在一起： mixed-property = "a string", [0x01 0x23 0x45 0x67], <0x12345678>;
逗号也用于创建字符串列表： string-list = "red fish", "blue fish";
注：在linux内核中有一些具有特定含义的键，比如：
compatible = "厂商,设备名字;
#address-cells = ; //address_cells用于描述当前子节点硬件设备地址 的无符号32整型数的个数
#size-cells = ;//size_cell 用于描述硬件地址的长度的32无符号整型数的个数
reg:用于描述当前节点的地址
3.4 添加自定义设备树节点
编写
vi 内核顶层目录/arch/arm/boot/dts/stm32mp157a-fsmp1a.dts
//在根节点内部添加自定义设备树节点
mynode@0x12345678
{
compatible = "hqyj,mynode";
astring="hello 22091";
uint =<0xaabbccdd 0x11223344>;
binarry=[00 0c 29 7b f9 be];
mixed ="hello",[11 22],<0x12345678>;
};
4.在驱动程序中获取设备树信息
4.1 设备树节点信息结构体
#include<linux/of.h>
struct device_node {const char *name; //设备树节点名 mynodeconst char *full_name;//完整的设备树节点名 mynode@0x12345678struct property *properties;//属性链表头节点struct device_node *parent;//父节点地址struct device_node *child;//子节点地址struct device_node *sibling;//兄弟节点地址
};
4.2 设备树节点属性结构体
struct property {char *name;//键名int length;//值的长度void *value;//值struct property *next;//下一个属性结构体首地址}；4.3 获取设备树节点信息的相关API
1.struct device_node *of_find_node_by_name(struct device_node *from,const char *name);
功能：根据设备树节点的名字解析设备树节点
参数：
from：当前节点父节点首地址（不知道就填NULL，默认从设备树根节点开始解析）
name:设备树节点名字 mynode
返回值：成功获取到解析的设备树节点信息结构体首地址，失败返回NULL2.struct device_node *of_find_node_by_path(const char *path)
功能：根据设备树节点路径解析设备树节点
参数：
path:设备树节点路径 /mynode0x12345678
返回值：成功获取到解析的设备树节点信息结构体首地址，失败返回NULL3.struct device_node *of_find_compatible_node(struct device_node *from,const char *type, const char *compat);
功能:根据设备树节点中compatibe键来解析设备树节点
参数：
from:填NULL，默认从根节点开始解析
type:NULL
compat:填写要解析的设备树节点中compatible的值
返回值：成功获取到解析的设备树节点信息结构体首地址，失败返回NULL*********关于设备驱动中大小端转换相关API***************
__u32 __be32_to_cpup(const __be32 *p)
功能:u32类型数据大端转小端
参数：转换的数据首地址
返回值:返回转换后的数值
__be32 __cpu_to_be32p(const __u32 *p)