设备树节点实战指南:从编写到驱动适配

Linux 设备驱动开发 —— 设备树在platform设备驱动中的使用 关与设备树的概念,我们在Exynos4412 内核移植(六)—— 设备树解析 里面已经学习过,下面看一下设备树在设备驱动开发中起到的作用          Device Tree是一种描述硬件的数据结构,设备树源(Device Tree Source)文件(以.dts结尾)就是用来描述目标板硬件信息的。Device Tree由一系列被命名的结点(node)和属性(property)组成,而结点本 阅读详情

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 节点定位与层级设计

去年给工业控制器添加环境监测模块时,我踩过一个坑:把光照传感器节点直接放在根节点下,结果系统启动时驱动加载失败。后来才明白,设备节点必须遵循硬件连接关系。

正确的做法是:

  1. 查看原理图确认传感器挂在I2C1总线
  2. 在芯片厂商提供的dtsi文件中找到I2C1控制器的节点路径
  3. 将传感器节点作为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", &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 设备树调试三板斧

  1. 语法检查:用dtc编译时加-W选项检查警告

    dtc -Wno-unit_address_vs_reg -I dts -O dtb -o test.dtb test.dts
    
  2. 运行时验证:查看/sys/firmware/devicetree/base

    ls /sys/firmware/devicetree/base/soc/i2c@40000000
    
  3. 内核打印:添加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>;
    };
};
ARM平台下设备树编写规范:完整指南 深入讲解ARM平台下设备树的编写规则与最佳实践,帮助开发者准确描述硬件资源,提升系统启动效率与驱动兼容性。掌握arm平台设备树结构是嵌入式开发的关键一步。 阅读详情

相关推荐

嵌入式Linux设备树实战:i.MX6ULL开发板LED驱动适配详解

在嵌入式Linux开发中,设备树(Device Tree)是描述硬件资源配置的核心机制,它通过结构化的文本文件将CPU、内存、外设等硬件信息传递给内核,实现驱动与硬件的动态匹配。其工作原理在于,Bootloader在启动内核时会加载设备树二进制文件(.dtb),内核解析后根据节点中的compatible属性绑定对应驱动,从而完成硬件初始化。这一技术价值在于实现了同一内核镜像对不同硬件平台的广泛支持,极大提升了嵌入式系统的可移植性和维护效率。其典型应用场景包括基于ARM、PowerPC等架构的嵌入式平台开发,

weixin_33700350的博客 1428

【Linux】嵌入式 Linux 驱动开发:从设备树配置到跨平台适配

在嵌入式 Linux 驱动开发领域,设备树(Device Tree)的引入彻底改变了传统驱动与硬件信息耦合的局面,为跨平台驱动复用提供了核心支撑。本文将从设备树的核心作用与结构出发,结合自定义 I2C 温度传感器的实战案例,详解设备树配置、驱动代码实现、关键 API 解析及跨平台适配技巧,帮助中级嵌入式开发者构建灵活可复用的驱动程序。

lbbxmx111的博客 1915

设备树中UART节点配置的完整指南

深入解析设备树中UART节点的配置方法,涵盖常见属性与实例说明,帮助开发者准确理解设备树在串口外设中的应用,提升嵌入式开发效率。

weixin_31163455的博客 962

实战:怎么把设备树和 /dev 节点真正连起来

拿到一块新的 ARM SoC 评估板,烧录厂商提供的 BSP 镜像,外设一切正常。但当你把内核升级到主线版本,或者换了一块定制载板,SPI 控制器不响应、I2C 设备探测不到、GPIO 中断进不来——这些问题不是偶发,而是必然。原因很简单:主线内核的驱动框架是通用的,它不认识你的定制硬件。BSP 移植的核心,就是在通用内核驱动和特定硬件之间建立映射。这个映射的桥梁是设备树(Device Tree),执行的载体是平台驱动(Platform Driver)。

qq_42431428的博客 5293

RK3588 Sensor驱动移植:设备树配置与驱动注册实战解析

本文详细解析RK3588平台下Sensor驱动的移植实战,重点介绍设备树配置与驱动注册机制。通过QMI8658传感器案例,深入讲解设备树节点定义、硬件接口配置、驱动注册流程及关键函数实现,帮助开发者快速掌握RK3588传感器驱动开发技巧,提升嵌入式系统开发效率。

melon的博客 1078

Linux驱动移植实战:从内核API适配到设备树配置的完整指南

设备驱动是连接硬件与操作系统的核心组件,它通过标准化的接口将硬件功能抽象为操作系统可识别的服务。其工作原理基于内核提供的框架和API,驱动开发者需要遵循特定的编程模型来实现硬件的初始化、资源管理和中断处理。在嵌入式Linux领域,驱动移植具有重要的技术价值,它使得同一硬件能在不同内核版本或平台上运行,极大地提高了代码复用率和开发效率。这一过程涉及内核API适配、设备树配置、电源管理等关键技术,广泛应用于消费电子、工业控制和物联网设备等场景。本文以I2C触摸屏驱动为例,深入探讨了从旧内核版本向新版本移植时遇到

weixin_33898876的博客 424

嵌入式Linux设备树实战:从DTS编写到驱动开发的完整指南

本文提供了嵌入式Linux设备树开发的完整实战指南,涵盖从DTS编写到驱动开发的全流程。详细解析设备树语法、GPIO/I2C/中断等外设配置,并分享内核驱动中获取设备信息的实用技巧与调试方法,帮助开发者高效掌握嵌入式Linux硬件描述与驱动协同开发。

rose2的博客 702

Sensor 驱动设备树配置实战:地址映射、寄存器绑定与平台数据设计

在 Android 平台与 Linux 内核中,设备树(Device Tree, DT)是连接硬件资源与驱动系统的桥梁。对于 Camera Sensor 驱动而言,DT 配置不仅需准确描述 sensor 的物理连接关系(如 I2C 地址、电源控制、时钟与复位),还必须通过 reg、compatible 等字段精确匹配对应驱动模块。本篇将结合当前主流平台(高通、MTK、瑞芯微)实战案例,系统讲解 sensor 驱动的设备树结构、寄存器定义方式、驱动初始化路径与硬件抽象层对接策略,为工程实践提供可复用的配置模板

努力分享一些人工智能、计算机视觉、影像等相关的知识干货! 1493

LINUX I2C适配器驱动编写

i2c_imx_start、i2c_imx_read、i2c_imx_write 和 i2c_imx_stop 这些函数就是 I2C 寄存器的具 体操作函数。当设备和驱动匹配成功以后 i2c_imx_probe 函数就会执行,i2c_imx_probe 函数 就会完成 I2C 适配器初始化工作。第 1008~1013 行,imx_i2c_struct 结构体要有个叫做 adapter 的成员变量,adapter 就是 i2c_adapter,这里初始化i2c_adapter。

weixin_44651073的博客 969

OriginPro实战:5步搞定碳材料拉曼光谱D峰G峰分析(附完整数据处理流程)

本文详细介绍了使用OriginPro进行碳材料拉曼光谱D峰G峰分析的完整流程,涵盖数据预处理、多图层可视化、高精度分峰拟合等关键步骤。特别针对材料科学研究中的基线漂移、多峰重叠等问题提供专业解决方案,帮助研究者快速完成从原始数据到科研级图表的全流程分析,提升碳材料表征效率与准确性。

vodka的博客 951

风光储互补微电网在偏远地区的应用实践:从建模到仿真全解析

本文深入解析了风光储互补微电网在偏远地区的应用实践,从系统设计到仿真建模全流程。通过Simulink等工具进行动态仿真,验证了系统在多种工况下的可靠性,并结合实际案例展示了其显著的经济和环保效益。文章为从业者提供了从技术路径到实施优化的全面指导。

weixin_29047545的博客 271

Linux驱动开发基础(设备树)

此章介绍了设备树的引入、语法和相关函数,所学来自百问网

weixin_62822414的博客 2684

5.1 Tessent Atpg系列 第八章 Test Pattern Generation - Verify Test Pattern

为什么要做基于timing的仿真,意义在于可以比较ATPG工具和simulator工具的差异性。因为时序的差异导致不同的结果。首先你需要通过write_patern 这句cmd来写出pattern,默认是parallel 模式,除非你用-serial 指定写出serial, 因为serial 文件非常大,所以你可以使用-sample 开关写出部分pattern即可,工具会根据每一种pattern 类型都会至少保存一只。 另外,你也可以使用-start -end 开关来减少文件大小,但是这样的截取,是不可靠的

ciscomonkey的博客 7767

5分钟搞懂NVIDIA开源GPU驱动:从编译到设备树优化全指南

你是否还在为NVIDIA GPU驱动的兼容性问题头疼?面对Linux内核升级后驱动失效的情况束手无策?本文将带你一站式解决开源GPU内核模块的编译安装与设备树配置难题,让你的显卡在开源系统中焕发新生。读完本文,你将掌握: - 开源驱动的核心架构与目录结构解析 - 3步快速编译安装适配内核的驱动模块 - 设备树配置优化的关键参数与实战案例 - 常见兼容性问题的诊断与解决方案 ## 开源驱动架构解...

gitblog_01197的博客 1481

手把手教你用Python模拟侧信道攻击:从电磁辐射到数据窃取(附防御代码)

本文详细介绍了如何使用Python模拟侧信道攻击,从电磁辐射信号采集到数据窃取的全过程,并提供了实用的防御代码。通过实战案例,帮助安全研究员和开发者理解侧信道攻击原理,掌握信号处理与图像重建技术,同时学习有效的噪声干扰和电磁屏蔽防御措施。

weixin_28716443的博客 164

人形机器人_双足行走动力学:基于OpenSim平台的股骨模型与建模

摘要 本文系统解析了股骨模型的生物力学特性、建模方法及应用场景,并探讨了基于OpenSim平台的股骨与42块肌肉Hill-type建模的技术流程。股骨作为人体核心承重骨骼,其几何结构、力学性能及多尺度建模方法在医学仿真、假体设计和仿生机器人领域具有重要价值。OpenSim通过逆向动力学、肌肉力优化及多物理场耦合,为临床步态分析、手术规划及仿生系统开发提供量化工具。同时对比了Hill-type模型与其他肌肉模型的优劣,并展望AI驱动建模、智能材料集成等前沿方向。未来研究将聚焦个性化仿真、实时计算优化及生物-机

一枚农夫,闲来有事聊聊天,交个朋友,让沉闷的生活畅想下 1582

如何在设备树中添加自定义节点:从入门到实践

确定节点位置:首先要明确自定义节点添加的位置。如果是添加一个新的独立设备节点,可以直接添加在设备树的根节点下,或者根据设备的功能和连接关系添加到合适的父节点下。例如,如果是一个连接到 SPI 总线上的传感器设备,就可以添加到 SPI 控制器节点的子节点中。编写节点内容:确定位置后,开始编写自定义节点的内容。主要包括节点名称、兼容性属性以及其他描述设备特性的属性。节点名称:节点名称要具有描述性,能够清晰地表明设备的功能。例如,对于一个自定义的温度传感器设备节点,可以命名为。

m0_57836225的博客 1085

【单片机】STM32F103C8T6 最小系统板原理图

STM32F103C8T6是一款基于ARM Cortex-M3内核的32位微控制器,由STMicroelectronics(ST)公司生产。它是STMicroelectronics的STM32系列微控制器中的一员,被广泛应用于嵌入式系统和电子设备中。LQFP48封装(Low-profile Quad Flat Package,48引脚)SRAM(静态随机访问存储器):20 KB。支持JTAG调试和编程接口(可选)多个通用输入/输出口(GPIO)USB接口(用于USB设备模式)内置调试和编程接口(SWD)

q742971636的博客 6万+

3步掌握Zephyr设备树:节点标签与引用实战指南

你是否在配置Zephyr RTOS硬件时遇到过设备节点引用错误?是否困惑于如何在不同设备树文件间共享硬件配置?本文将通过3个实战步骤,帮你彻底掌握设备树(Device Tree,设备树)的节点标签定义与跨文件引用技巧,让硬件配置更简洁、更可靠。 读完本文你将学会: - 用节点标签简化复杂设备树结构 - 3种跨文件引用节点的实用技巧 - 解决90%设备树编译错误的调试方法 ## 一、节点标签:给...

gitblog_00449的博客 798

PCL 均匀采样【2026最新版】

根据输入点云数据创建一个微小的三维立方体集合,然后计算每个三维立方体的重心;由于该重心点不一定是原始点云中的点,直接用该点来表示立方体内所有的点会丢失原始点云的细小特征;所以使用k最近邻搜索寻找距离重心点最近的原始点来代替重心点。

点云侠的博客 41万+

【嘉立创EDA】PCB金属包边设计快捷方法

本文使用嘉立创EDA,描述如何在PCB设计时,快速增加边框包边设计,特别是金属包边(伪)——这里标记(伪)是因为该这里的包边特指不含边缘壁。请参考本文时特别注意!本文将此过程记录,以供有需要的读者参考。

l64481000的博客 1755

6.linux驱动之认识设备树

场景操作方式命令/说明手动编译/反编译使用dtc命令内核开发中编译使用内核Makefile编译内核时顺带编译附加dtbs目标安装设备树到根文件系统使用目标调试反编译.dtb文件以节点()构成树状结构。以属性()描述硬件细节。通过compatible属性建立驱动与硬件的联系。使用#include实现代码复用。

知识共享、互助共进 2439

IDEA的使用指南

IDEA基于java的使用手册,可以最快速的上手,在使用中不断的丰富自己的使用技巧.

2k2000loongos设备树传参

本文详解设备树在Linux驱动开发中的核心作用,结合米联客MLK-LS02A-2K2000-i开发板,演示如何通过PMON配置设备树传参。重点说明修改ACPI为设备树传参方式、启用CONFIG_DTB选项及编译生成带设备树的PMON二进制文件(ls2k2000-dtb.bin),实现内核与硬件的灵活适配,助力开发者高效完成设备树开发。

米联客(milianke) 4127

文档:亲测可用解决vnc灰屏,黑屏,鼠标大黑叉情况

主要解决vnc-viewer灰屏,黑屏,鼠标大黑叉等现象,详细见文档。

Camera2Demo

在Camera2 的基础上进行封装,使得Camera2一堆初始化逻辑与Activity分离,降低耦合度,完成预览拍照并保存的操作

【 Linux】嵌入式 Linux 必学:设备树语法 + 字符设备驱动开发实战

在传统嵌入式 Linux 中,硬件信息(如寄存器地址、中断号、外设连接关系)直接硬编码在驱动程序中,导致驱动与硬件强耦合——更换硬件平台时,需修改驱动源码重新编译,灵活性极差。

lbbxmx111的博客 1426

VC中sqlite的使用

在VC中对sqlite的使用,实现数据库大批数据的快速插入,读取数据库中的数据在ListCtrl中显示

四、设备树下的 platform 平台设备驱动

​ Platform 驱动模型是 Linux 内核为了更好地管理设备和驱动而引入的一种机制。它将设备和驱动进行分离,通过平台总线(platform bus)来匹配设备和驱动。在这个模型中,设备和驱动都向平台总线注册自己,总线负责根据设备和驱动的匹配规则,将它们绑定在一起。功能:向平台总线注册一个平台设备。原型参数pdev是一个指向结构体的指针,该结构体包含了设备的名称、ID、资源等信息。返回值:成功返回 0,失败返回负的错误码。功能:从平台总线注销一个平台设备。原型参数pdev。

Jiuri的博客 1755

设备树下的驱动开发

​​​可以将​​(dts文件)与​​(.ko模块)分离,实现 ​​,大幅提升嵌入式系统开发效率与可维护性。

m0_75029474的博客 444
上一篇: 自然语言驱动的图像分割革命:Lang-Segment-Anything实战解析
下一篇: Python与openGauss深度整合:从基础CRUD到AI向量检索的完整开发指南
寂静夜空35
博客等级 码龄3年 60粉丝 1797原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符  | 博主筛选后可见
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值