设备树语法基础知识

设备树的引入与作用

以LED 驱动作为例子说明。一旦你需要更换LED 所用到的 GPIO 引脚，需要修改驱动程序源代码，重新编译，重新加载驱动。
这是相当麻烦的。

再来，同一款芯片的板子，它们所用的外设资源都不一样的，比如A板子用到GPIOA，B板用到GPIOB。而GPIO的驱动程序既支持GPIOA同时也支持GPIOB，你需要指定使用哪个引脚。该如何指定呢？答案是，在C代码中指定。

随着ARM芯片的流行，内核中针对这些ARM板保存有大量的、没有技术含量的文件。
Linus 大发雷霆："this whole ARM thing is a f*cking pain in the ass"。
于是，Linux 内核开始引入设备树。

其设备树并非是重新发明出来的，在Linux 内核中其他平台，如 PowerPC ，早就使用设备树来描述硬件了。

Linus 发火之后，内核开始全面使用设备树来改造了。

同时还有一种错误的观点，那就是新驱动都是使用设备树来写了。
答案是：不可能。

回想，要操作硬件就需要去操作复杂的寄存器，如果设备树可以操作寄存器，那么它就是“驱动”，它就一样很复杂。

设备树语法

怎么描述这棵树？

我们需要编写设备树文件（dts：device tree source），它需要编译为dtb(device tree blob)文件，内核使用的是dtb文件。
下面是一个设备树示例：

它对应的dts 文件如下：

Devicetree 格式

DTS 文件的格式

DTS 文件布局（layout）

/dts-v1/; // 表示版本
[memory reservations] // 格式为: /memreserve/ <address> <length>;
/ {
	 [property definitions]
	 [child nodes]
};

node格式

设备树中的基本单元，被称为node，其格式为：

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

其中label 标号，可以省略。label的作用是为了方便地引用node ，比如：

/dts-v1/;
/{
	uart0:uart@fen001000{
		compatible="ns16550";
		reg=<0xfe001000 0x100>;
	};
}

可以使用下面2种方法来修改uart@fe001000 这个node:

// 在根节点之外使用 label 引用 node：
&uart0{
	status="disabled";
};
如果没有lable，则需要完整的引用其路径
&{/uart@fe001000}{
	status="disabled"
}

常用的节点（node）

1. 根节点
   dts文件中必须有一个根节点

/dts-V1/;
/{
	model="SMDK24440";
	compatible="samsung,smdk2440";
	
	#address-cells=<1>;
	#size-cells=<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. cpu 节点
   一般不需要我们设置，在 dtsi 文件中都定义好了：

cpus{
	#address-cells=<1>；
	#size-cells=<0>;

	cpu0:cpu@0{
		......
	};
};

3. memory节点
   芯片厂家不可能事先确定你的板子使用多大的内存，所以 memory 节点需要板厂设置，比如：

memory{
	reg=<0x80000000 0x20000000>;
};

4. chosen 节点
   我们可以通过设备树文件给内核传入一些参数，这要在 chosen 节点中设置 bootargs 属性：

chosen {
	bootargs = "noinitrd root=/dev/mtdblock4 rw init=/linuxrc console=ttySAC0,115200";
};

properties（属性）的格式

简单地来说，properties 就是 “name = value” ，value 有多种取值方式。
Property 格式1：

[label:]property-name = value;

Property 格式 2(没有值):

[label:]property-name;

Property取值只有3种：

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、#size-cells
   cell 指的是一个32位的数值。

• address-cells：address要用多少个32位数来表示；
• size-cells：size 要用多少个32位数来表示

比如一段内存，怎么描述它的起始地址和大小？
以下是，address-cells为1，所以reg中用1个数来表示地址，即用 0x80000000 来表示地址；size-cells为1，所以reg中用1个数来表示大小，即用 0x20000000 表示大小：

/{
	#address-cells=<1>;
	#size-cells=<1>;
	memory{
		reg=<0x80000000 0x20000000>;
	};
};

2. compatible
   compatible 表示兼容，对于某个LED，内核中可能有A、B、C三个驱动都支持它，那可以这样写：

led{
	compatible="A","B","C";
};

内核启动时，就会为了这个LED按这样的优先顺序为它找到驱动程序：A、B、C。

根节点下也有 compatible 属性，用来选择哪一个 “machine desc，一个内核可以支持machine A ，也可以支持 machine B ，内核启动后会根据节点的 compatible属性找到对应的 machine desc结构体，执行其中的初始化函数。

compatible的值，建议取这样的形式 manufacturer, model，即“厂家名，模块名”。

注意： machine desc的意思就是“机器描述”，学到内核启动流程时才涉及。

3. model
   model属性与compatible 属性有些类似，但是有差别。
   compatible属性是一个字符串列表，表示你硬件可以兼容A、B、C等驱动；
   model用来准确地定义这个硬件是什么。

比如根节点中可以这样写：

/{
	compatible="samsung,smdk2440", "samsung,mini2440";
	model="jz2440_v3";
};

它表示这个单板可以兼容内核中的smdk2440，也可以兼容mini2440。
从compatible 属性中可以知道它兼容哪些板子，但是它到底是什么板，就需要用model属性来明确。

4. status
   dtsi文件中定义了很多设备，但是在你的板子上某些设备是没有的。这时候，你就可以给这个设备节点添加一个status 属性，设置为disabled:

&uart1{
	status="disabled";
};

用的最多的基本是 okay和disabled

5. reg
   reg 本意是 register ，用来表示寄存器地址。
   但是在设备树中，它可以用来描述一段空间，反正对于 ARM 系统，寄存器和内存是统一编址的，即访问寄存器时用某块地址，访问内存时用某块地址，在访问方法上是没有区别的。
   reg 属性的值是一系列 address，size ，用多少个32位的数来表示 address 和 size ，由其父节点的 #address-cells 、#size-cells 决定。

/dts-v1/;
/ {
	#address-cells = <1>;
	#size-cells = <1>;
	memory {
		reg = <0x80000000 0x20000000>;
	};
};

6. name（过时了，不建议使用）
   它的值是字符串，用来表示节点的名字。在根 platform_driver 匹配时，优先级最低。
   compatible 属性在匹配过程中，优先级最高。

7. device_type（过时了，不建议使用）
   它的值是字符串，用来表示节点的类型。在跟 platform_driver 匹配时，优先级为中。
   compatible 属性在匹配过程中，优先级最高。