1. 设备树节点基础概念与实战价值
第一次接触设备树时,我完全被那些嵌套的大括号和奇怪的符号搞懵了。直到在项目中被迫修改一个GPIO控制器的节点后,才真正理解设备树就像硬件的"身份证"——它用文本文件的形式,完整记录了电路板上每个元件的"家庭住址"和"性格特征"。
设备树的核心结构其实很简单,就是由节点(Node)和属性(Property)组成的树形结构。每个硬件设备对应一个节点,比如下面这个I2C温度传感器的典型节点定义:
temp_sensor: sensor@48 {
compatible = "ti,tmp112";
reg = <0x48>;
interrupt-parent = <&gpio1>;
interrupts = <12 IRQ_TYPE_EDGE_FALLING>;
#thermal-sensor-cells = <1>;
};
这个节点里藏着几个关键信息:
temp_sensor是节点标签,相当于给设备起的外号sensor@48是节点名称,48是设备在I2C总线上的地址compatible属性是驱动匹配的身份证号reg属性指定了硬件寄存器地址interrupts描述了中断引脚配置
在嵌入式项目中,我经常遇到这样的情况:硬件工程师换了传感器型号,但软件不知道要改驱动。有了设备树后,只需要修改compatible属性值,比如从"ti,tmp112"改成"maxim,max30205",内核就会自动匹配新驱动,完全不需要重新编译内核。
2. 设备树节点编写全流程解析
2.1 节点定位与层级设计
去年给工业控制器添加环境监测模块时,我踩过一个坑:把光照传感器节点直接放在根节点下,结果系统启动时驱动加载失败。后来才明白,设备节点必须遵循硬件连接关系。
正确的做法是:
- 查看原理图确认传感器挂在I2C1总线
- 在芯片厂商提供的dtsi文件中找到I2C1控制器的节点路径
- 将传感器节点作为I2C1的子节点添加
&i2c1 { // 通过&引用已定义的i2c1节点
status = "okay";
clock-frequency = <100000>;
// 正确的位置:作为i2c1的子节点
ambient_light: light@39 {
compatible = "ams,tsl2563";
reg = <0x39>;
interrupt-parent = <&gpio2>;
interrupts = <9 IRQ_TYPE_LEVEL_LOW>;
};
};
2.2 属性配置实战技巧
不同的硬件设备需要配置不同的属性,这里分享几个常用属性的配置经验:
reg属性:对于I2C设备只需要写地址(如<0x48>),而内存映射设备需要地址范围:
reg = <0x0209c000 0x4000>; // 起始地址0x0209c000,长度0x4000
中断配置:最易出错的属性之一,必须包含三个参数:
interrupts = <IRQ_NUM TYPE FLAGS>;
// 例如:
interrupts = <14 IRQ_TYPE_LEVEL_HIGH>; // 中断号14,高电平触发
时钟配置:现代SoC通常需要指定时钟:
clocks = <&clk IMX8MM_CLK_SAI3_ROOT>;
clock-names = "mclk";
3. 设备树编译与内核联动
3.1 编译工具链实战
在Ubuntu环境下,我习惯用以下命令链:
# 安装编译工具
sudo apt install device-tree-compiler
# 编译单个dts文件
dtc -I dts -O dtb -o my_board.dtb my_board.dts
# 反编译查看(调试神器)
dtc -I dtb -O dts -o debug.dts my_board.dtb
在内核源码树中编译更简单:
make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- dtbs
3.2 驱动适配关键代码
设备树真正的价值要在驱动代码中体现。以最简单的平台设备驱动为例:
static const struct of_device_id my_drv_ids[] = {
{ .compatible = "mycorp,mydevice" }, // 必须与设备树compatible一致
{ }
};
static struct platform_driver my_driver = {
.probe = my_probe,
.driver = {
.name = "my_driver",
.of_match_table = my_drv_ids,
},
};
// 在probe函数中解析设备树属性
static int my_probe(struct platform_device *pdev)
{
struct device_node *np = pdev->dev.of_node;
u32 reg_val;
// 读取reg属性
if (of_property_read_u32(np, "reg", ®_val))
dev_err(&pdev->dev, "missing reg property\n");
// 处理中断
irq = platform_get_irq(pdev, 0);
// 获取时钟
clk = devm_clk_get(&pdev->dev, "mclk");
}
4. 典型外设节点编写示例
4.1 GPIO设备节点实战
在智能家居项目中,需要控制多个LED和按键:
gpio_leds: leds {
compatible = "gpio-leds";
status_led: led-0 {
gpios = <&gpio2 15 GPIO_ACTIVE_HIGH>;
linux,default-trigger = "heartbeat";
};
};
gpio_keys: keys {
compatible = "gpio-keys";
power-key {
gpios = <&gpio1 18 GPIO_ACTIVE_LOW>;
linux,code = <KEY_POWER>;
debounce-interval = <50>;
};
};
4.2 I2C传感器节点配置
环境监测常用的BME280传感器节点:
&i2c2 {
environmental: bme280@76 {
compatible = "bosch,bme280";
reg = <0x76>;
vddd-supply = <&vdd_3v3>;
interrupt-parent = <&gpio1>;
interrupts = <5 IRQ_TYPE_EDGE_RISING>;
};
};
4.3 内存映射设备示例
Zynq FPGA的AXI外设配置:
fpga_region0: fpga-region0 {
compatible = "fpga-region";
fpga-mgr = <&fpga_mgr>;
my_ip@43c00000 {
compatible = "mycorp,my-ip";
reg = <0x43c00000 0x10000>;
interrupts = <0 29 4>;
clocks = <&clkc 15>;
};
};
5. 调试技巧与常见问题解决
5.1 设备树调试三板斧
-
语法检查:用dtc编译时加-W选项检查警告
dtc -Wno-unit_address_vs_reg -I dts -O dtb -o test.dtb test.dts -
运行时验证:查看/sys/firmware/devicetree/base
ls /sys/firmware/devicetree/base/soc/i2c@40000000 -
内核打印:添加bootargs参数
bootargs="earlycon ignore_loglevel devicetree_debug=1"
5.2 高频踩坑点
- 地址对齐错误:reg属性地址必须是4字节对齐
- 中断号冲突:检查/proc/interrupts确认中断未被占用
- 时钟缺失:忘记配置时钟会导致设备无法工作
- 兼容性字符串:必须与驱动中的of_device_id完全一致
记得有一次调试SPI设备,死活不工作,最后发现是pinctrl配置被其他设备覆盖了。后来养成了习惯,重要的节点都会加上状态检查:
&spi2 {
status = "okay";
pinctrl-names = "default";
pinctrl-0 = <&pinctrl_spi2>;
flash@0 {
compatible = "winbond,w25q128";
reg = <0>;
spi-max-frequency = <50000000>;
};
};
1428



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



