[DTS]设备树语法

一、设备树语法

(1)设备树节点语法

[label:] node-name[@unit-address] {
    [properties definitions];
    [child nodes];
};

解释:
  label: 可选项,节点别名
  node-name: 节点名
  unit-address: 设备地址
  properties definitions:属性定义
  child nodes:子节点

(2) 属性定义语法

[label:] property-name = value;
[label:] property-name;

属性分为有属性值和无属性值

属性值有三种取值

  • arrays of cells(1个或多个32位数据, 64位数据使用2个32位数据表示),用尖括号表示(< >)
  • string(字符串), 用双引号表示(" ")
  • bytestring(1个或多个字节),用方括号表示([ ])

举例:

//Arrays of cells : cell就是一个32位的数据
interrupts = <17 0xc>;

//64bit数据使用2个cell来表示:
clock-frequency = <0x00000001 0x00000000>;

//A null-terminated string (有结束符的字符串):
compatible = "simple-bus";

//A bytestring(字节序列) :
local-mac-address = [00 00 12 34 56 78];  // 每个byte使用2个16进制数来表示
local-mac-address = [000012345678];       // 每个byte使用2个16进制数来表示

//可以是各种值的组合, 用逗号隔开:
compatible = "ns16550", "ns8250";
example = <0xf00f0000 19>, "a strange property format";

二、特殊属性

(1)根节点

#address-cells   // 在它的子节点的reg属性中, 使用多少个u32整数来描述地址(address)
#size-cells      // 在它的子节点的reg属性中, 使用多少个u32整数来描述大小(size)
compatible       // 定义一系列的字符串, 用来指定内核中哪个machine_desc可以支持本设备
                 // 即这个板子兼容哪些平台 
                 // uImage : smdk2410 smdk2440 mini2440     ==> machine_desc         
                 
model            // 比如有2款板子配置基本一致, 它们的compatible是一样的
                 // 那么就通过model来分辨这2款板子

cell: 一个u32整数

(2) /memory

所有设备树文件的必需节点,它定义了系统物理内存的 layout

device_type = "memory";
reg             // 用来指定内存的地址、大小

(3) /chosen

传递runtime parameter

bootargs        // 内核command line参数, 跟u-boot中设置的bootargs作用一样

(4) /cpus

/cpus节点下有1个或多个cpu子节点, cpu子节点中用reg属性用来标明自己是哪一个cpu
所以 /cpus 中有以下2个属性:

#address-cells   // 在它的子节点的reg属性中, 使用多少个u32整数来描述地址(address)
#size-cells      // 在它的子节点的reg属性中, 使用多少个u32整数来描述大小(size)
                 // 必须设置为0

(5) /cpus/cpu*

device_type = "cpu";
reg             // 表明自己是哪一个cpu

(6) aliases

用来定义别名

	aliases {
		ethernet0 = &gmac;
		i2c0 = &i2c0;
		i2c1 = &i2c1;
		i2c2 = &i2c2;
		mshc0 = &emmc;
		mshc1 = &sdmmc;
		mshc2 = &sdio0;
		mshc3 = &sdio1;
		serial0 = &uart0;
		serial1 = &uart1;
		spi0 = &spi0;
		spi1 = &spi1;
	};

三、 引用其他节点

(1) phandle属性引用

节点中的phandle属性, 它的取值必须是唯一的(不要跟其他的phandle值一样)

pic@10000000 {
    phandle = <1>;
    interrupt-controller;
};

another-device-node {
    interrupt-parent = <1>;   // 使用phandle值为1来引用上述节点
};

(2)使用别名(本质还是phandle)

PIC: pic@10000000 {
    interrupt-controller;
};

another-device-node {
    interrupt-parent = <&PIC>;   // 使用label来引用上述节点, 
                                 // 使用lable时实际上也是使用phandle来引用, 
                                 // 在编译dts文件为dtb文件时, 编译器dtc会在dtb中插入phandle属性
};

四、包含dtsi文件

#include "rk3288-firefly.dtsi"

  在每个.dsti和.dts中都会存在一个“/”根节点,那么如果在一个设备树文件中include一个.dtsi文件,那么岂不是存在多个“/”根节点了么。其实不然,编译器DTC在对.dts进行编译生成dtb时,会对node进行合并操作,最终生成的dtb只有一个root node。

五、使用宏定义

#include <dt-bindings/gpio/gpio.h>
#include <dt-bindings/interrupt-controller/irq.h>
#include <dt-bindings/interrupt-controller/arm-gic.h>
#include <dt-bindings/pinctrl/rockchip.h>
#include <dt-bindings/clock/rk3288-cru.h>
#include <dt-bindings/power/rk3288-power.h>
#include <dt-bindings/thermal/thermal.h>
#include <dt-bindings/power/rk3288-power.h>
#include <dt-bindings/soc/rockchip,boot-mode.h>

arm-pmu {
		compatible = "arm,cortex-a12-pmu";
		interrupts = <GIC_SPI 151 IRQ_TYPE_LEVEL_HIGH>,
			     <GIC_SPI 152 IRQ_TYPE_LEVEL_HIGH>,
			     <GIC_SPI 153 IRQ_TYPE_LEVEL_HIGH>,
			     <GIC_SPI 154 IRQ_TYPE_LEVEL_HIGH>;
		interrupt-affinity = <&cpu0>, <&cpu1>, <&cpu2>, <&cpu3>;
  };

上面的GIC_SPI和IRQ_TYPE_LEVEL_HIGH都是宏定义,定义在头文件中。

六、属性重写

//rk3288.dtsi
hdmi: hdmi@ff980000 {
    compatible = "rockchip,rk3288-dw-hdmi";
    reg = <0x0 0xff980000 0x0 0x20000>;
    reg-io-width = <4>;
    #sound-dai-cells = <0>;
    rockchip,grf = <&grf>;
    interrupts = <GIC_SPI 103 IRQ_TYPE_LEVEL_HIGH>;
    clocks = <&cru  PCLK_HDMI_CTRL>, <&cru SCLK_HDMI_HDCP>, <&cru SCLK_HDMI_CEC>;
    clock-names = "iahb", "isfr", "cec";
    power-domains = <&power RK3288_PD_VIO>;
    status = "disabled";
};

//rk3288-firefly.dtsi
&hdmi {
	ddc-i2c-bus = <&i2c5>;
	status = "okay";
};

上面的rk3288-firefly.dtsi包含rk3288.dtsi, 然后使用&hdmi引用rk3288.dtsi中的hdmi节点。并在原有的基础上添加ddc-i2c-bus属性,然后将status属性进行重写覆盖
这就体现了dtsi文件的价值,dtsi定义公共的部分,板级差异再进行添加或重写

七、实例解析

/ {
    compatible = "acme,coyotes-revenge";
    #address-cells = <1>; //子结点需要一个 cell 描述地址
    #size-cells = <1>; //子结点需要一个 cell 描述长度
    interrupt-parent = <&intc>;
    
    cpus {
        #address-cells = <1>;
        #size-cells = <0>;
        cpu@0 {
            compatible = "arm,cortex-a9";
            reg = <0>;
        };
        cpu@1 {
            compatible = "arm,cortex-a9";
            reg = <1>;
        };
    };
    
    serial@101f1000 { //串口
        compatible = "arm,pl011";
        reg = <0x101f1000 0x1000 >;
        interrupts = < 1 0 >;
    };
    
    serial@101f2000 { //串口
        compatible = "arm,pl011";
        reg = <0x101f2000 0x1000 >;
        interrupts = < 2 0 >;
    };
    
    intc: interrupt-controller@10140000 { //中断控制器
        compatible = "arm,pl190";
        reg = <0x10140000 0x1000 >;
        interrupt-controller;
        #interrupt-cells = <2>;
    };
    
    spi@10115000 { //spi 控制器
        compatible = "arm,pl022";
        reg = <0x10115000 0x1000 >; 起始地址为 0x10115000,长度为 0x1000
        interrupts = < 4 0 >;
    };
    
    external-bus { //external bus 桥
        #address-cells = <2> //子结点需要两个 cell 描述地址,片选
        #size-cells = <1>; //子结点需要一个 cell 描述长度
        ranges = <0 0 0x10100000 0x10000 // Chipselect 1, Ethernet 片选 0 0,地址 0x10100000 ,长度 0x10000
            1 0 0x10160000 0x10000 // Chipselect 2, i2c controller
            2 0 0x30000000 0x1000000>; // Chipselect 3, NOR Flash
            
        ethernet@0,0 {
            compatible = "smc,smc91c111";
            reg = <0 0 0x1000>;
            interrupts = < 5 2 >;
        };
        
        i2c@1,0 {
            compatible = "acme,a1234-i2c-bus";
            #address-cells = <1>; //rtc 需要一个 cell 描述地址
            #size-cells = <0>; //rtc 不需要 0 描述长度
            reg = <1 0 0x1000>;
            rtc@58 {
                compatible = "maxim,ds1338";
                reg = <58>;
                interrupts = < 7 3 >;
            };
        };
        
        flash@2,0 {
            compatible = "samsung,k8f1315ebm", "cfi-flash";
            reg = <2 0 0x4000000>;
        };
    };
};

解析:
(1) 根节点
  compatible: 内核通过root节点"/"的compatible属性来判断它启动的是哪个machine。
  #address-cells : 子结点(reg属性)需要多少个cell描述地址。
  #size-cells : 子结点(reg属性)需要多少个cell描述长度。
  interrupt-parent : 标示该节点属于哪个中断控制器,如果没有该属性,则依附于父节点。

(2) cpus节点
  #address-cells : 同上
  #size-cells : 同上

(3) cpu节点
  @unit-address: 可选项,设备地址,节点名相同时可以通过这个来区分不同节点。unit-address地址也经常在其对应的reg属性中给出。
  reg : region,描述设备地址
格式: reg = <address1 length1 [address2 length2] [address3 length3]>

(4) serial节点
  compatible: 外设节点上的compatible属性用于驱动和设备的绑定(匹配)
  reg: 外设基地址和偏移量 ,比如:reg = <0x101f1000 0x1000 >
  interrupts: 中断号和标识(上升沿,下降沿等), 里面多少个值要根据中断控制器的#interrupt-cells属性来决定。而#interrupt-cells属性值要由中断控制器的类型决定。

中断控制器类型:
GIC: Generic Interrupt Controller(通用中断控制器)
中断类型,中断号,标识(上升沿,下降沿等)
VIC : Vectored Interrupt Controller(向量中断控制器)
中断号
NVIC:Nested Vectored Interrupt Controller(内嵌向量中断控制器)
中断号,中断优先级

参考: Documentation\devicetree\bindings\interrupt-controller

(5) interrupt-controller节点
  compatible: 中断控制器类型,查看上面路径下的文件来获知。
  reg:同上
  interrupt-controller:空属性,用来声明这个节点接收中断信号。
  #interrupt-cells:标识该控制器需要几个cell来描述中断,其实就是决定了interrupts属性需要几个cell

(6) external-bus节点
  ranges: 地址转换表,每一行都包含子地址、父地址、在子地址空间内的区域大小。
ranges属性值为空的话,表示1:1映射。

ranges属性值的格式 <local地址, parent地址, size>
  local地址的个数取决于当前含有ranges属性的节点的#address-cells属性的值。
  parent地址的个数取决于父节点的#address-cells的值。
  size取决于当前含有ranges属性的节点的#size-cells属性的值。

(7) rtc节点
  reg: i2c设备地址

欢迎大家关注我的微信公众号!!
已标记关键词 清除标记
©️2020 CSDN 皮肤主题: 编程工作室 设计师:CSDN官方博客 返回首页