如何制作设备树

设备树是一种描述硬件资源及其连接关系的数据结构，广泛应用于嵌入式系统，尤其是基于Linux内核的平台。它使得操作系统能够在不修改内核源码的情况下，适配不同的硬件配置。本文将深入解析设备树的核心概念、语法结构、编写方法、编译流程以及调试技巧，通过从理论到实践的完整路径，系统性地指导您掌握从零开始制作一份功能完备且正确的设备树文件。

       在嵌入式系统的世界里，硬件平台千差万别，从微控制器到复杂的片上系统，其外设、内存映射和中断连接方式各不相同。如果为每一种硬件配置都维护一个独立的内核版本，那将是一场维护噩梦。正是为了解决这个问题，设备树技术应运而生。它就像一份提供给操作系统的“硬件地图”，详细描述了处理器、内存、总线以及挂载在总线上的各种设备。有了这份地图，同一个内核镜像就能在不同的硬件平台上正确启动并驱动所有设备。本文将带您从零开始，一步步深入设备树的内部世界，掌握制作它的核心知识与实践技能。

       设备树的本质与作用

       简单来说，设备树是一种描述硬件拓扑和配置信息的数据结构。它采用一种类似树形的节点分层结构，其中根节点代表整个系统，子节点则代表总线、桥接器或具体的物理设备。每个节点包含若干属性，这些属性以键值对的形式存在，用于描述设备的地址、中断号、时钟频率、特定驱动参数等信息。在Linux内核启动的早期阶段，引导加载程序会将设备树二进制文件加载到内存中并将其地址传递给内核。内核随后解析这份数据，根据其中的信息动态地创建设备节点，并加载相应的驱动程序。这种方式彻底将硬件描述从内核代码中剥离，实现了内核与板级支持的解耦，极大地提升了系统的可移植性和可维护性。

       设备树源文件与设备树二进制文件

       我们通常编写的以“.dts”或“.dtsi”为扩展名的文件，称为设备树源文件。这是一种人类可读的文本文件，使用一种特定的语法来描述硬件。而最终被加载到内存中、由内核解析的是一种经过编译的二进制格式，称为设备树二进制文件，其扩展名为“.dtb”。从源文件到二进制文件的转换过程，称为设备树编译，这是制作过程中的关键一步。此外，“.dtsi”文件类似于C语言中的头文件，用于存放可被多个“.dts”文件引用的公共部分或芯片级别的通用定义，通过包含指令来复用代码。

       设备树的基本语法结构

       设备树源文件的语法清晰而直观。一个最简单的设备树文件也必须包含版本声明和根节点。版本声明使用“/dts-v1/；”来标识。根节点用“/ ；”来表示，所有其他的设备节点都作为它的子节点或后代节点存在。设备节点由节点名称和单元地址组成，格式通常为“节点名称单元地址”，如果设备没有地址，则可以省略“单元地址”部分。节点内部用花括号定义其子节点和属性。属性是描述节点的核心，其格式为“属性名称 = 值；”。值可以是字符串、字符串数组、32位无符号整数、字节序列或是由其他节点引用组成的句柄。

       核心属性详解：兼容性、地址与中断

       在众多属性中，有几个是几乎所有设备节点都必须定义的核心属性。“兼容性”属性是最关键的一个，它定义了设备与哪个驱动程序匹配。其值是一个字符串列表，内核会从第一个字符串开始尝试匹配驱动程序。例如，一个以太网控制器的兼容性属性可能设置为“兼容性 = “fsl，imx6q-fec”， “fsl，imx27-fec”；”，表示优先尝试匹配“imx6q-fec”驱动，若不匹配则尝试“imx27-fec”驱动。“寄存器”属性用于描述设备在父总线地址空间内的内存映射资源，通常包括起始地址和长度。“中断”属性则描述了设备所使用的中断号，其格式与具体的中断控制器有关。这些属性共同为驱动程序提供了操作硬件所必需的信息。

       地址编码与父节点寻址

       设备树中的地址并非绝对的物理地址，而是相对于其父总线地址空间的本地地址。为了表示一个完整的地址路径，设备树使用了“地址单元数”和“大小单元数”这两个属性。它们通常定义在根节点或总线节点上，用于指定其子节点中“寄存器”属性每个字段所占用的字长。例如，设置“地址单元数 = <1>；”和“大小单元数 = <1>；”意味着子节点的“寄存器”属性中，地址和长度字段各占用一个32位的数值。通过这种层级化的地址编码方式，设备树能够清晰地描述复杂的总线结构和内存映射关系。

       从参考模板开始入手

       对于初学者而言，从头编写一个完整的设备树文件是困难的。最实用的方法是找到与您所用芯片和开发板尽可能相似的官方或社区提供的设备树源文件作为模板。芯片供应商通常会为评估板提供完整的设备树文件，这是一个绝佳的起点。您可以将这些文件作为参考，首先理解其整体结构，然后针对自己硬件上的差异进行修改。例如，如果您的板载内存容量不同，只需修改描述内存的节点；如果使用了不同的网卡芯片，则需要替换或修改相应的以太网节点。从修改开始，是学习设备树最快捷的路径。

       编写具体设备节点的步骤

       当您需要为一个新设备添加节点时，可以遵循以下步骤。首先，确定该设备连接在哪个总线上，从而决定其父节点。例如，一个集成电路总线设备应挂载在集成电路总线节点之下。其次，查阅该设备的芯片数据手册，获取其硬件特性，如寄存器基地址、中断线、时钟要求等。然后，根据其驱动程序的文档，确定必须填写的属性，其中“兼容性”属性必须严格按照驱动文档的说明填写。最后，在父节点下创建新的子节点，填写必要的属性。一个常见的错误是忽略了“状态”属性，若设备不可用，应明确设置“状态 = “禁用”；”，否则内核会默认尝试初始化它。

       使用包含文件组织代码

       随着设备树描述的系统越来越复杂，将所有内容写在一个文件里会变得难以管理。这时，可以使用包含指令来组织代码。通常，芯片级的通用定义，如中央处理器的配置、内存控制器、时钟控制器等，会被放在一个“.dtsi”文件中。而针对具体电路板的定制信息，如内存大小、启动设备、启用哪些外设、引脚复用配置等，则放在主“.dts”文件中，并通过“/包含/”指令来包含芯片级的文件。这种模块化的方法使得为同一芯片的不同开发板维护设备树变得非常高效，只需编写不同的顶层文件即可。

       设备树的编译与生成

       编写好设备树源文件后，需要使用设备树编译器将其转换为二进制文件。设备树编译器是内核源码树的一部分，编译内核前通常会自动编译它。使用它的基本命令格式是“设备树编译器 -O 设备树二进制文件 -o 输出文件名称 输入文件名称”。其中，“-O 设备树二进制文件”指定输出格式，“-o”指定输出文件名。编译过程会处理所有的包含指令、宏展开，并进行语法和语义检查。对于复杂的系统，可能需要编译多个设备树二进制文件，这时可以编写Makefile来管理编译流程，与内核的编译系统集成在一起。

       将设备树二进制文件传递给内核

       生成设备树二进制文件后，需要由引导加载程序在启动内核时将其加载到内存中。具体传递方法取决于引导加载程序和硬件架构。在通用引导程序环境下，通常使用“bootm”或“bootz”命令，这些命令会自动识别随内核镜像一起提供的设备树二进制文件。在一些嵌入式引导程序中，可能需要通过特定的寄存器来传递设备树二进制文件在内存中的物理地址。确保设备树二进制文件被放置在正确的内存位置，并且内核参数配置正确，是系统能否成功启动的关键。

       系统内的设备树查看与调试

       系统成功启动后，您可以在用户空间查看内核最终解析得到的设备树信息。在“/proc/设备树/”目录下，以目录结构的形式展示了完整的设备树。每个目录对应一个节点，文件对应属性。使用“cat”命令可以查看属性值。此外，使用“设备树查看器”工具可以将这些信息还原成可读的设备树源文件格式，这对于验证内核实际获得的信息非常有用。如果系统未能正确识别设备，首先应该检查这些路径下的信息是否与您的预期一致。

       常见问题与排查方法

       制作设备树过程中难免会遇到问题。如果内核在启动早期就崩溃，很可能是设备树二进制文件本身损坏或格式错误。如果内核能启动但某个设备无法工作，则应首先检查内核启动日志，搜索该设备的“兼容性”字符串，看驱动是否成功匹配并探测。使用“dmesg | grep -i 设备名”是常用的方法。常见的错误包括：地址或中断号填写错误、“兼容性”字符串拼写错误、必要的时钟或引脚控制属性缺失、父节点定义不正确等。逐项对比驱动文档要求和您的设备树节点是解决问题的根本。

       引脚控制与复用配置

       现代片上系统的引脚通常具有多种复用功能。设备树通过“引脚控制子系统”的绑定方式来描述引脚的复用和电气属性。这通常涉及两个部分：在引脚控制节点中定义各种引脚功能的状态组；在设备节点中通过“引脚控制名称”属性引用所需的状态。例如，为一个通用异步收发器设备，除了基本的寄存器地址和中断，还需要通过“引脚控制名称 = “默认”；”来将其使用的引脚复用为发送和接收功能。正确配置引脚控制是外设能够正常工作的前提，需要仔细查阅芯片的引脚复用手册。

       时钟与电源管理描述

       设备的正常运行离不开时钟和电源。设备树中，时钟源被建模为独立的节点，设备通过“时钟”属性引用一个或多个时钟，并通过“时钟名称”属性为每个时钟命名。电源域和稳压器的描述也类似，设备通过“电源”属性来声明其供电需求。内核的时钟框架和电源管理框架会读取这些信息，在驱动探测时为设备提供所需的时钟和电源。遗漏这些属性可能导致设备无法初始化或工作不稳定。

       进阶主题：设备树覆盖与动态配置

       对于一些支持热插拔或现场可编程门阵列动态重构的系统，静态的设备树可能不够灵活。设备树覆盖技术允许在系统运行时动态加载一个设备树片段，并将其合并到主设备树中。这常用于在基础系统上动态添加扩展板上的设备。设备树覆盖文件以“.dtbo”为扩展名，其语法与普通设备树源文件类似，但只描述需要添加或修改的部分。内核必须配置支持设备树覆盖功能，并通过特定的配置接口来加载和管理它们。

       与引导加载程序的协同

       设备树不仅是内核的硬件描述文件，一些先进的引导加载程序也能读取并利用其中的信息。例如，通用引导程序可以读取设备树中的内存节点信息来初始化内存控制器，或者读取“chosen”节点中的“启动参数”来设置内核命令行。在设备树中正确设置“chosen”节点和“内存”节点，对于引导加载程序完成其工作至关重要。理解引导加载程序与内核在设备树使用上的分工，有助于构建一个更顺畅的启动链条。

       持续学习与资源推荐

       设备树是一个不断发展的技术，其绑定标准（即各种设备类型的属性约定）由内核社区维护和更新。深入学习和制作设备树，最权威的资料永远是Linux内核源码目录下的“文档/设备树/”文件夹，其中包含了详细的规范、绑定文档和示例。此外，积极参与相关芯片和开发板的社区讨论，阅读成熟的设备树源码，是提升实战能力的最佳途径。从模仿到理解，从修改到创造，您将逐渐掌握为任何硬件平台“绘制地图”的能力，让Linux内核在其中自由驰骋。

       通过以上从概念到细节、从编写到调试的全面阐述，相信您已经对如何制作设备树有了系统而深入的认识。记住，实践是掌握这项技能的唯一钥匙。找一块开发板，从阅读其现有的设备树文件开始，尝试做一些小的修改，观察系统的变化，您将很快步入设备树开发的殿堂。