1. 设备树基础:为什么嵌入式Linux离不开它
记得我第一次接触嵌入式Linux驱动开发时,最头疼的就是每次更换硬件平台都要重新修改内核代码。那时候驱动代码里充满了各种平台相关的配置信息,换个芯片就要重新编译内核,简直让人崩溃。直到设备树(Device Tree)的出现,才彻底改变了这种局面。
设备树本质上是一个描述硬件信息的数据结构,它用文本文件(.dts)的形式描述硬件配置,编译后生成二进制文件(.dtb)传递给内核。这样就把硬件描述和内核代码分离了,同一个内核镜像可以支持多种硬件平台。
举个例子,假设你正在开发一个基于i.MX6ULL的工控板,需要描述一个GPIO控制的LED设备。在没有设备树的时代,你不得不在内核的board file里这样写:
static struct gpio_led imx6ull_leds[] = {
{
.name = "system-led",
.gpio = IMX_GPIO_NR(1, 3),
.default_trigger = "heartbeat",
},
};
现在用设备树,同样的硬件可以这样描述:
leds {
compatible = "gpio-leds";
system-led {
label = "system-led";
gpios = <&gpio1 3 GPIO_ACTIVE_HIGH>;
linux,default-trigger = "heartbeat";
};
};
这种分离带来的好处是显而易见的:硬件变更不需要重新编译内核,只需要更新设备树文件。我在实际项目中就遇到过这样的情况——客户临时要求更换LCD屏幕,我们只用了半小时修改设备树就完成了适配,如果要改内核代码至少需要一天时间。
2. 设备树语法详解:从节点到属性的完整解析
设备树的基本组成单元是节点(node)和属性(property)。节点就像文件系统中的目录,用于组织和管理硬件信息;属性则是具体的键值对,描述硬件的详细参数。
2.1 节点命名规范与路径
每个节点都有唯一的路径标识,类似于文件路径。根节点用"/"表示,子节点通过路径分隔。比如一个I2C设备可能位于/i2c@021a0000/rtc@68,这样的路径明确表示了硬件在系统中的位置。
节点命名遵循<name>[@<unit-address>]的格式,其中unit-address通常是设备的基地址。比如serial@101f0000表示一个串口设备,基地址是0x101f0000。
2.2 属性值的多种数据类型
设备树支持丰富的数据类型,这是它能够准确描述硬件的基础:
-
字符串:用于描述兼容性、标签等文本信息
compatible = "fsl,imx6ull-i2c", "fsl,imx21-i2c"; -
32位无符号整数数组:用于描述地址、中断号等数值信息
reg = <0x021a0000 0x4000>; interrupts = <0 68 IRQ_TYPE_LEVEL_HIGH>; -
二进制数据:常用于描述MAC地址、校准数据等
local-mac-address = [00 04 9f 00 27 50]; -
混合格式:结合多种数据类型的复杂描述
clock-names = "ipg", "per"; clocks = <&clks IMX6UL_CLK_I2C1>, <&clks IMX6UL_CLK_I2C1>;
在实际开发中,我经常用混合格式来描述复杂的时钟配置。比如在一个音频项目中,需要配置多个时钟域,设备树的这种灵活性大大简化了工作。
2.3 节点引用与别名机制
设备树提供了灵活的引用机制,允许一个节点引用另一个节点的内容。这是通过phandle(指针句柄)和标签引用实现的。
// 定义节点并添加标签
gpio1: gpio@0209c000 {
compatible = "fsl,imx6ul-gpio", "fsl,imx35-gpio";
reg = <0x0209c000 0x4000>;
};
// 在其他节点中引用
leds {
compatible = "gpio-leds";
status-led {
gpios = <&gpio1 3 GPIO_ACTIVE_HIGH>;
};
};
别名机制(aliases)进一步简化了节点引用:
/ {
aliases {
ethernet0 = &fec1;
serial0 = &uart1;
};
};
这样在系统中可以通过serial0这个别名来访问uart1设备,避免了使用冗长的完整路径。
3. 设备树与驱动匹配:compatible属性的奥秘
设备树与驱动程序的匹配是通过compatible属性实现的,这是设备树最核心的机制之一。内核在启动时会遍历设备树中的所有节点,为每个节点寻找匹配的驱动程序。
3.1 compatible属性的工作原理
compatible属性是一个字符串列表,按照从具体到通用的顺序排列驱动匹配的优先级:
compatible = "fsl,imx6ull-i2c", "fsl,imx21-i2c", "generic-i2c";
内核会按顺序尝试匹配:先找"fsl,imx6ull-i2c"的驱动,如果没有再找"fsl,imx21-i2c",最后尝试"generic-i2c"。
在驱动程序中,需要定义相应的of_device_id结构体来声明支持的设备:
static const struct of_device_id imx_i2c_dt_ids[] = {
{ .compatible = "fsl,imx6ull-i2c" },
{ .compatible = "fsl,imx21-i2c" },
{ /* sentinel */ }
};
MODULE_DEVICE_TABLE(of, imx_i2c_dt_ids);
3.2 实际开发中的匹配技巧
在我的项目经验中,有几点匹配策略值得注意:
第一,尽量使用厂商前缀。这样避免与其他厂商的驱动冲突,比如"ti,omap-i2c"和"nxp,imx-i2c"虽然都是I2C控制器,但硬件特性可能不同。
第二,保留向后兼容。即使开发新的硬件平台,也尽量兼容已有的驱动标识符。我曾经遇到一个项目,因为改了compatible字符串导致原有的驱动无法使用,不得不重新移植。
第三,合理使用通用标识符。对于符合标准协议的设备,可以添加通用标识符作为fallback:
compatible = "my-company,my-special-eth", "snps,dwmac";
这样即使没有专用驱动,也能使用通用的MAC驱动。
4. 地址映射实战:reg属性与内存映射详解
地址映射是设备树中最需要精确描述的部分,任何错误都可能导致驱动无法正常工作甚至系统崩溃。reg属性用于描述设备在内存中的地址范围,其格式由父节点的#address-cells和#size-cells决定。
4.1 内存映射设备描述
对于内存映射设备(Memory Mapped Devices),通常使用1个cell表示地址,1个cell表示大小:
soc {
#address-cells = <1>;
#size-cells = <1>;
serial@101f0000 {
compatible = "arm,pl011";
reg = <0x101f0000 0x1000>;
};
};
这里#address-cells = <1>表示地址用1个32位数表示,#size-cells = <1>表示大小也用1个32位数表示。因此reg属性包含两个数值:基地址0x101f0000和长度0x1000。
4.2 复杂地址映射场景
在实际项目中,经常会遇到更复杂的场景。比如有些设备有多个地址区域:
gpio@101f3000 {
compatible = "arm,pl061";
reg = <0x101f3000 0x1000 // 数据寄存器区域
0x101f4000 0x0010>; // 控制寄存器区域
};
对于带有片选信号的设备,地址描述会更加复杂:
external-bus {
#address-cells = <2>; // 片选号 + 偏移地址
#size-cells = <1>;
ethernet@0,0 {
compatible = "smc,smc91c111";
reg = <0 0 0x1000>; // 片选0,偏移0,长度0x1000
};
};
4.3 ranges地址转换
当总线地址空间与CPU地址空间不同时,需要使用ranges属性进行地址转换:
external-bus {
#address-cells = <2>;
#size-cells = <1>;
ranges = <0 0 0x10100000 0x10000 // 片选0映射到0x10100000
1 0 0x10160000 0x10000>; // 片选1映射到0x10160000
};
这个ranges属性表示:片选0的偏移0地址被映射到CPU地址空间的0x10100000~0x10110000,映射长度为0x10000。
我在一次移植工作中就遇到过ranges配置错误的问题——以太网设备无法正常收发数据。经过仔细排查,发现是ranges中的地址映射长度配置错误,导致驱动访问了错误的内存区域。
5. 中断处理实战:interrupt属性配置详解
中断处理是嵌入式系统中最关键也最容易出问题的部分。设备树提供了标准化的方式来描述中断路由,大大简化了驱动开发。
5.1 中断控制器与中断号映射
中断系统的描述包括中断控制器和中断消费者两部分。首先需要描述中断控制器:
intc: interrupt-controller@10140000 {
compatible = "arm,pl190";
reg = <0x10140000 0x1000>;
interrupt-controller;
#interrupt-cells = <2>;
};
interrupt-controller属性声明这是一个中断控制器,#interrupt-cells定义中断描述符的格式。
然后在使用中断的设备节点中引用中断控制器:
serial@101f0000 {
compatible = "arm,pl011";
reg = <0x101f0000 0x1000>;
interrupts = <1 0>; // 中断号1,触发方式0
interrupt-parent = <&intc>;
};
5.2 复杂中断系统描述
现代SoC通常有多个中断控制器,形成层级结构。比如GPIO控制器本身也可能是中断控制器:
gpio1: gpio@0209c000 {
compatible = "fsl,imx6ul-gpio", "fsl,imx35-gpio";
reg = <0x0209c000 0x4000>;
gpio-controller;
#gpio-cells = <2>;
interrupt-controller;
#interrupt-cells = <2>;
interrupts = <GIC_SPI 66 IRQ_TYPE_LEVEL_HIGH>,
<GIC_SPI 67 IRQ_TYPE_LEVEL_HIGH>;
};
key@0 {
compatible = "gpio-keys";
button {
label = "User Button";
gpios = <&gpio1 18 GPIO_ACTIVE_LOW>;
interrupts = <18 IRQ_TYPE_EDGE_FALLING>;
interrupt-parent = <&gpio1>;
};
};
这种层级中断系统中,GPIO按键中断先由GPIO控制器处理,然后转发到GIC(通用中断控制器)。
5.3 实际调试技巧
中断配置错误是驱动开发中最常见的问题之一。我总结了几条调试经验:
首先,确认中断控制器配置。使用cat /proc/interrupts查看中断统计信息,确认中断是否被正确触发。
其次,检查中断触发方式。边缘触发和电平触发的行为完全不同,配置错误会导致中断无法正常响应。
最后,注意中断共享问题。多个设备共享同一中断线时,需要在驱动中正确处理中断共享。
// 正确配置中断共享
ethernet@0 {
compatible = "smc,smc91c111";
interrupts = <IRQ_TYPE_LEVEL_HIGH>;
interrupt-parent = <&intc>;
};
6. GPIO与时钟配置:设备树中的资源管理
GPIO和时钟是嵌入式系统中最常用的两种资源,设备树提供了统一的描述方式。
6.1 GPIO配置详解
GPIO描述包括GPIO控制器和GPIO使用者两部分:
// GPIO控制器描述
gpio1: gpio@0209c000 {
compatible = "fsl,imx6ul-gpio", "fsl,imx35-gpio";
reg = <0x0209c000 0x4000>;
gpio-controller;
#gpio-cells = <2>; // 引脚号 + 标志
};
// GPIO使用
leds {
compatible = "gpio-leds";
system-led {
gpios = <&gpio1 3 GPIO_ACTIVE_HIGH>;
default-state = "on";
};
};
#gpio-cells = <2>表示每个GPIO描述包含两个参数:引脚号和标志位。标志位可以指定GPIO的极性(主动高/低)、开源输出等特性。
6.2 时钟配置管理
时钟配置同样采用控制器+消费者的模式:
// 时钟控制器
clks: clock-controller@020c4000 {
compatible = "fsl,imx6ul-ccm";
reg = <0x020c4000 0x4000>;
#clock-cells = <1>;
};
// 时钟使用者
serial@02020000 {
compatible = "fsl,imx6ul-uart", "fsl,imx6q-uart";
reg = <0x02020000 0x4000>;
clocks = <&clks IMX6UL_CLK_UART1_IPG>,
<&clks IMX6UL_CLK_UART1_SERIAL>;
clock-names = "ipg", "per";
};
时钟配置的复杂性在于时钟之间的依赖关系。设备树虽然描述了时钟连接,但实际的时钟开关和频率设置还是在驱动中完成。
7. 实战案例:完整设备树节点编写示例
现在让我们通过一个完整的实战案例,将前面讲到的各种知识点串联起来。假设我们要为一块自定义开发板编写设备树,包含以下硬件:IMX6ULL处理器、以太网PHY、LCD显示屏、触摸屏、几个GPIO设备。
7.1 处理器节点与总线定义
首先定义SoC的基本结构和总线:
/dts-v1/;
#include "imx6ull.dtsi"
/ {
model = "My Custom IMX6ULL Board";
compatible = "mycompany,imx6ull-custom", "fsl,imx6ull";
memory@80000000 {
device_type = "memory";
reg = <0x80000000 0x20000000>; // 512MB RAM
};
chosen {
stdout-path = &uart1;
};
};
这里引用了芯片厂商提供的imx6ull.dtsi文件,其中已经定义了CPU、内存控制器等基本节点。
7.2 以太网设备配置
以太网需要配置MAC控制器和PHY:
&fec1 {
pinctrl-names = "default";
pinctrl-0 = <&pinctrl_enet1>;
phy-mode = "rmii";
status = "okay";
fixed-link {
speed = <100>;
full-duplex;
};
};
&iomuxc {
pinctrl_enet1: enet1grp {
fsl,pins = <
MX6UL_PAD_GPIO1_IO07__ENET1_MDC 0x1b0b0
MX6UL_PAD_GPIO1_IO06__ENET1_MDIO 0x1b0b0
// 更多引脚配置...
>;
};
};
7.3 显示与触摸设备
LCD和触摸屏配置相对复杂,需要配置多个接口:
&lcdif {
pinctrl-names = "default";
pinctrl-0 = <&pinctrl_lcdif_dat
&pinctrl_lcdif_ctrl>;
display = <&display0>;
status = "okay";
display0: display {
bits-per-pixel = <16>;
bus-width = <24>;
display-timings {
native-mode = <&timing0>;
timing0: timing0 {
clock-frequency = <33000000>;
hactive = <800>;
vactive = <480>;
// 更多时序参数...
};
};
};
};
&i2c2 {
clock-frequency = <100000>;
pinctrl-names = "default";
pinctrl-0 = <&pinctrl_i2c2>;
status = "okay";
touchscreen@38 {
compatible = "edt,edt-ft5406";
reg = <0x38>;
interrupt-parent = <&gpio1>;
interrupts = <5 IRQ_TYPE_EDGE_FALLING>;
};
};
7.4 GPIO设备配置
最后配置GPIO设备,包括LED和按键:
&gpio1 {
pinctrl-names = "default";
pinctrl-0 = <&pinctrl_gpio1>;
status = "okay";
};
leds {
compatible = "gpio-leds";
pinctrl-names = "default";
pinctrl-0 = <&pinctrl_leds>;
system-led {
label = "system-status";
gpios = <&gpio1 3 GPIO_ACTIVE_HIGH>;
linux,default-trigger = "heartbeat";
};
};
gpio-keys {
compatible = "gpio-keys";
pinctrl-names = "default";
pinctrl-0 = <&pinctrl_keys>;
user-button {
label = "User Button";
gpios = <&gpio1 18 GPIO_ACTIVE_LOW>;
linux,code = <KEY_ENTER>;
};
};
这个完整的示例展示了实际项目中设备树的组织方式。重要的是保持结构清晰,合理使用引用和覆盖机制。我在项目中通常会为不同的功能模块创建单独的dtsi文件,然后在板级dts文件中包含和定制这些模块。
设备树调试是个需要耐心的工作,建议从简单开始逐步添加复杂功能。使用dtc工具编译设备树时记得添加-@参数保留符号信息,这样在调试时能获得更详细的错误信息。每次修改后都要用fdtdump检查生成的dtb文件,确保配置符合预期。
1181



被折叠的 条评论
为什么被折叠?



