02课_设备树的规范(dts和dtb)

02课_设备树的规范(dts和dtb)

1、DTS格式

1.1、语法

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

Property格式1:
[label:] property-name = value;

Property格式2(没有值):
[label:] property-name;

Property取值只有3种:
arrays of cells(1个或多个32位数据, 64位数据使用2个32位数据表示),
string(字符串),
bytestring(1个或多个字节)

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

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

c. A null-terminated string (有结束符的字符串):
compatible = “simple-bus”;

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

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

1.2、DTS文件布局(layout)

/dts-v1/;
[memory reservations]    // 格式为: /memreserve/ <address> <length>;如/memreserve/ 0x33f00000 0x100000;
/ {
    [property definitions]
    [child nodes]
};

1.3、特殊的、默认的属性

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款板子

2、/memory

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

3、/chosen

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

1.4、引用其他节点

1、phandle

// 节点中的phandle属性, 它的取值必须是唯一的(不要跟其他的phandle值一样)
pic@10000000 {
phandle = <1>;
interrupt-controller;
};

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

2、label

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

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

1.5、例子

写一个jz2440.dts文件；一个jz2440.dtsi(被看作公共文件)文件
在dts文件中包含dtsi文件：
#include “jz2440.dtsi” /* 包含目录吓得dtsi文件即可 */

1.5.1、覆盖

也可在dts文件中覆盖dtsi文件中的值：
dtsi文件中：
LED: led { /* 加上[label:] */
compatible = “jz2440_led”;
pin = <S3C2410_GPF(5)>;
};

dts文件中：
/ {
led {
pin = <S3C2410_GPF(6)>;
};
};
把jz2440.dts和jz2440.dtsi文件上传到目录/work/system/linux-4.19-rc3/arch/arm/boot/dts中；
要使用arm-linux-gnueabi-gcc 4.9.4, 执行如下命令:
export PATH=PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:
/work/system/gcc-linaro-4.9.4-2017.01-x86_64_arm-linux-gnueabi/bin

make dtbs

再来反汇编：
./scripts/dtc/dtc -I dtb -O dts -o tmp.dts arch/arm/boot/dts/jz2440.dtb

查看反汇编文件：
vim tmp.dts
pin值被修改为0x50006

1.5.2、引用

dtsi文件中：
LED: led { /* 加上[label:] */
compatible = “jz2440_led”;
pin = <S3C2410_GPF(5)>;
};

dts文件中：
&LED { /* 不能指定根目录“/”，直接使用lable名即可 */
pin = <S3C2410_GPF(7)>;
};

make dtbs
./scripts/dtc/dtc -I dtb -O dts -o tmp.dts arch/arm/boot/dts/jz2440.dtb
vim tmp.dts

官方文档:
https://www.devicetree.org/specifications/

在内核目录下的文档中也有说明usage-model.txt (linux-4.19-rc3\linux-4.19-rc3\Documentation\devicetree)
Linux uses DT data for three major purposes:

1) platform identification,	/* 根节点里面的信息，如compatible */
2) runtime configuration, and	/ * chosen，
						 * 或者[memory reservations] 格式为: /memreserve/ <address> <length>;
						 * /memreserve/ 0x33000000 0x10000;	/* 留下1M内存自己使用 */
						 */
3) device population.	/* led等 */

2、DTB格式

官方文档:
https://www.devicetree.org/specifications/

内核文档:
Documentation/devicetree/booting-without-of.txt

在dts和dtsi文件中可以使用c语言中的各种宏，需要被展开；
使用dtc工具把dts文件编译为dtb文件

2.1、编译dts生成dtb

修改jz2440.dts文件，添加：
。。。
/dts-v1/;
/memreserve/ 0x33f00000 0x100000;
。。。

把jz2440.dts和jz2440.dtsi文件上传到目录/work/system/linux-4.19-rc3/arch/arm/boot/dts中；

要使用arm-linux-gnueabi-gcc 4.9.4, 执行如下命令:
export PATH=PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:
/work/system/gcc-linaro-4.9.4-2017.01-x86_64_arm-linux-gnueabi/bin

make dtbs /* 编译 */

再把dtb文件传回来，使用ue来查看这个二进制文件；

2.2、数据存储模式

dtb文件以大端方式存储数据，对于”abc”字符串都是大端；

2.3、dtb中在怎样表示dts

dts与dtb文件关系连接图：




官方文档中的定义：

dtb中表示dts文件使用的值：