Sama5d36ek_Device Tree.docVIP

Sama5d36ek_Device Tree Colin Zou 2014/3/17 此文档用于帮助客户更好的理解 Device Tree 和在 SAMA5D3x 中如何通过修改 Device Tree而更改板级外设。  目录 一．ARM Device Tree 起源 - 2 - 二．ARM Device Tree 组成和结构 - 2 - 2.1 DTS (device tree source) - 2 - 2.2 Device Tree Blob (.dtb) - 4 - 2.3 Binding - 4 - 三．引入 Device tree 后代码上的改变 - 5 - 3.1 Device Tree 的初始化 - 6 - 四．加载 DTS 设备结点的过程 - 7 - 4.1使用 DTS 注册平台总线的过程 - 7 - 4.2使用 DTS 注册总线设备的过程以及驱动的加载 - 8 -  一．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 这种数据结构，犹如它的名字，是一颗树（常见数据结构类型），包含有许多结点，结点中含有属性，属性中含有名字（name）和值（value）。树的信息主要包括：cpu 的数量和类别，内存基地址，总线与桥，外设连接，中断控制器和中断使用情况，GPIO 以及 CLOCK 器等等，Device Tree 的源代码格式是 .dts（device tree source)。在启动过程中，内核会展开 Device Tree（此处是源代码编译后的 .dtb 文件)，并创建和注册相关设备，驱动因此也以新方式和 .dts 中定义的设备结点进行匹配，然后工作。 二．ARM Device Tree 组成和结构 整个 Device Tree牵涉面比较广，即增加了新的用于描述设备硬件信息的文本格式，又增加了编译这一文本的工具，同时 Bootloader 也需要支持将编译后的 Device Tree 传递给 Linux 内核。 2.1 DTS (device tree source) .dts 文件是一种 ASCII 文本格式的 Device Tree 描述，此文本格式非常人性化，适合人类的阅读习惯。基本上，在 ARM Linux 中，一个 .dts 文件对应一个 ARM 的 machine，一般放置在内核的 arch/arm/boot/dts/ 目录。由于一个 SoC 可能对应多个 machine （一个 SoC 可以对应多个产品和电路板），势必这些 .dts 文件需包含许多共同的部分， Linux 内核为了简化，把 SoC 公用的部分或者多个 machine 共同的部分一般提炼为 .dtsi，类似于 C 语言的头文件。譬如，对于 SAMA5D36 而言。在 /linux-at91/arch/arm/boot/dts 目录下，有 sama5d36ek.dts ，而其中就包括了 sama5d3mb.dtsi，sama5d3dm.dtsi 。下面我们就看一下 Sama5d3ek.dts 文件。 /include/ sama5d3mb.dtsi /include/ sama5d3dm.dtsi / { mode