1. ARM Device Tree起源
Linus Torvalds在2011年3月17日的ARM Linux邮件列表宣称“this whole ARM thing is a
f*cking pain in the ass”,引发ARM
Linux社区的地震,随后ARM社区进行了一系列的重大修正。在过去的ARM
Linux中,arch/arm/plat-xxx和arch/arm/mach-xxx中充斥着大量的垃圾代码,相当多数的代码只是在描述板级细节,而这些板级细节对于内核来讲,不过是垃圾,如板上的platform设备、resource、i2c_board_info、spi_board_info以及各种硬件的platform_data。读者有兴趣可以统计下常见的s3c2410、s3c6410等板级目录,代码量在数万行。
社区必须改变这种局面,于是PowerPC等其他体系架构下已经使用的Flattened Device
Tree(FDT)进入ARM社区的视野。Device Tree是一种描述硬件的数据结构,它起源于 OpenFirmware
(OF)。在Linux
2.6中,ARM架构的板极硬件细节过多地被硬编码在arch/arm/plat-xxx和arch/arm/mach-xxx,采用Device
Tree后,许多硬件的细节可以直接透过它传递给Linux,而不再需要在kernel中进行大量的冗余编码。
Device
Tree由一系列被命名的结点(node)和属性(property)组成,而结点本身可包含子结点。所谓属性,其实就是成对出现的name和value。在Device
Tree中,可描述的信息包括(原先这些信息大多被hard code到kernel中):
CPU的数量和类别
内存基地址和大小
总线和桥
外设连接
中断控制器和中断使用情况
GPIO控制器和GPIO使用情况
Clock控制器和Clock使用情况
它基本上就是画一棵电路板上CPU、总线、设备组成的树,Bootloader会将这棵树传递给内核,然后内核可以识别这棵树,并根据它展开出Linux内核中的platform_device、i2c_client、spi_device等设备,而这些设备用到的内存、IRQ等资源,也被传递给了内核,内核会将这些资源绑定给展开的相应的设备。
2. Device Tree组成和结构
整个Device
Tree牵涉面比较广,即增加了新的用于描述设备硬件信息的文本格式,又增加了编译这一文本的工具,同时Bootloader也需要支持将编译后的Device
Tree传递给Linux内核。
DTS (device tree source)
.dts文件是一种ASCII 文本格式的Device Tree描述,此文本格式非常人性化,适合人类的阅读习惯。基本上,在ARM
Linux在,一个.dts文件对应一个ARM的machine,一般放置在Linux内核的arch/arm/boot/dts/目录。由于一个SoC可能对应多个machine(一个SoC可以对应多个产品和电路板),势必这些.dts文件需包含许多共同的部分,Linux内核为了简化,把SoC公用的部分或者多个machine共同的部分一般提炼为.dtsi,类似于C语言的头文件。其他的machine对应的.dts就include这个.dtsi。譬如,对于VEXPRESS而言,vexpress-v2m.dtsi就被vexpress-v2p-ca9.dts所引用,
vexpress-v2p-ca9.dts有如下一行:
/include/ “vexpress-v2m.dtsi”
当然,和C语言的头文件类似,.dtsi也可以include其他的.dtsi,譬如几乎所有的ARM
SoC的.dtsi都引用了skeleton.dtsi。
.dts(或者其include的.dtsi)基本元素即为前文所述的结点和属性:
[plain] view plaincopy
/ {
node1 {
a-string-property = “A string”;
a-string-list-property = “first string”, “second string”;
a-byte-data-property = [0x01 0x23 0x34 0x56];
child-node1 {
first-child-property;
second-child-property = ;
a-string-property = “Hello, world”;
};
child-node2 {
};
};
node2 {
an-empty-property;
a-cell-property = ;
child-node1 {
};
};
};
上述.dts文件并没有什么真实的用途,但它基本表征了一个Device Tree源文件的结构:
1个root结点”/”;
root结点下面含一系列子结点,本例中为”node1″ 和 “node2″;
结点”node1″下又含有一系列子结点,本例中为”child-node1″ 和 “child-node2″;
各结点都有一系列属性。这些属性可能为空,如”
an-empty-property”;可能为字符串,如”a-string-property”;可能为字符串数组,如”a-string-list-property”;可能为Cells(由u32整数组成),如”second-child-property”,可能为二进制数,如”a-byte-data-property”。
下面以一个最简单的machine为例来看如何写一个.dts文件。假设此machine的配置如下:
1个双核ARM Cortex-A9 32位处理器;
ARM的local bus上的内存映射区域分布了2个串口(分别位于0x101F1000 和
0x101F2000)、GPIO控制器(位于0x101F3000)、SPI控制器(位于0×10170000)、中断控制器(位于0×10140000)和一个external
bus桥;
External bus桥上又连接了SMC SMC91111
Ethernet(位于0×10100000)、I2C控制器(位于0×10160000)、64MB NOR
Flash(位于0×30000000);
External bus桥上连接的I2C控制器所对应的I2C总线上又连接了Maxim
DS1338实时钟(I2C地址为0×58)。
其对应的.dts文件为:
[plain] view plaincopy
/ {
compatible = “acme,coyotes-revenge”;
#address-cells = ;
#size-cells = ;
interrupt-parent =;
cpus {
#address-cells = ;
#size-cells = ;
cpu@0 {
compatible = “arm,cortex-a9″;
reg = ;
};
cpu@1 {
compatible = “arm,cortex-a9″;
reg = ;
};
};
serial@101f0000 {
compatible = “arm,pl011″;
reg = ;
interrupts = < 1 0 >;
};
serial@101f2000 {
compatible = “arm,pl011″;
reg = ;
interrupts = < 2 0 >;
};
gpio@101f3000 {
compatible = “arm,pl061″;
reg = ;
interrupts = < 3 0 >;
};
intc: interrupt-controller@10140000 {
compatible = “arm,pl190″;
reg = ;
interrupt-controller;
#interrupt-cells = ;
};
spi@10115000 {
compatible = “arm,pl022″;
reg = ;
interrupts = < 4 0 >;
};
external-bus {
#address-cells =
#size-cells = ;
ranges =; // Chipselect 3, NOR Flash
ethernet@0,0 {
compatible = “smc,smc91c111″;
reg = ;
interrupts = < 5 2 >;
};
i2c@1,0 {
compatible = “acme,a1234-i2c-bus”;
#address-cells = ;
#size-cells = ;
reg = ;
interrupts = < 6 2 >;
rtc@58 {
compatible = “maxim,ds1338″;
reg = ;
interrupts = < 7 3 >;
};
};
flash@2,0 {
compatible = “samsung,k8f1315ebm”, “cfi-flash”;
reg &#