Linux驱动-＞设备树

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 required
        a-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;    //设备树节点名   mynode
    const char *full_name;//完整的设备树节点名  mynode@0x12345678
    struct  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
返回值：成功获取到解析的设备树节点信息结构体首地址，失败返回NULL

2.struct device_node *of_find_node_by_path(const char *path)
功能：根据设备树节点路径解析设备树节点
参数：
path:设备树节点路径  /mynode0x12345678
返回值：成功获取到解析的设备树节点信息结构体首地址，失败返回NULL

3.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)