Linux驱动开发：HSR04超声波模块设备树配置详解 (从零开始配置设备树，驱动HC-SR04)

1. HSR04超声波模块简介

HSR04超声波模块是一种常用的测距传感器，通过发送超声波并接收反射波来计算距离。它包含四个引脚：Vcc、Trig、Echo、Gnd。在Linux驱动中，我们需要通过GPIO来控制Trig引脚发送触发信号，并检测Echo引脚的电平变化来测量时间。这一切都离不开Linux设备树的配置。

2. 设备树基础概念

Linux设备树是一种描述硬件信息的数据结构，它替代了传统的板级文件，使得内核可以更灵活地适配不同硬件。在设备树中，我们通过节点（node）和属性（property）来描述设备。例如，一个GPIO控制器就是一个节点，而它控制的引脚则通过属性来指定。对于HSR04超声波模块，我们需要在设备树中添加一个自定义节点，并指定使用的GPIO引脚。

3. 编写HSR04设备树节点

下面是一个典型的设备树节点示例，用于描述HSR04超声波模块。假设Trig连接到GPIO1_12，Echo连接到GPIO1_13：

    / {    hsr04@0 {        compatible = "mycompany,hsr04";        trig-gpios = <&gpio1 12 GPIO_ACTIVE_HIGH>;        echo-gpios = <&gpio1 13 GPIO_ACTIVE_HIGH>;        status = "okay";    };};  

这里的关键点是compatible属性，它用于驱动和设备树的匹配。驱动中会通过同名字符串来找到这个节点，这就是驱动配置的核心。另外，trig-gpios和echo-gpios是我们自定义的属性，驱动会通过API读取这些GPIO编号。

4. 驱动匹配与实现

驱动中需要定义of_match_table来匹配设备树节点：

    static const struct of_device_id hsr04_of_match[] = {    { .compatible = "mycompany,hsr04" },    { /* sentinel */ }};MODULE_DEVICE_TABLE(of, hsr04_of_match);  

在probe函数中，通过devm_gpiod_get获取GPIO描述符，然后就可以操作Trig和Echo引脚了。这部分的代码属于超声波驱动的具体实现。

5. 编译与加载

编写完设备树源文件（.dts）后，需要编译成二进制（.dtb）并替换或挂载到系统。通常使用make dtbs命令编译。然后将生成的dtb文件复制到/boot目录，重启系统或通过flashing更新。加载驱动模块可以使用insmod或modprobe。如果一切顺利，你会在/sys/class下看到你的设备，或者通过printk查看输出。

6. 测试与调试

你可以编写一个简单的应用程序，通过设备文件或sysfs接口来触发测距。注意检查Echo引脚的电压是否在3.3V以内，必要时需要电平转换。常见问题包括GPIO编号错误、设备树未生效等，可以通过dmesg和/proc/device-tree来调试。

7. 总结

通过本文，你应该掌握了HSR04超声波模块在Linux下的设备树配置方法，了解了Linux设备树的基本用法，以及如何编写匹配的驱动配置和超声波驱动。希望这篇教程能帮助你在实际项目中快速上手！

—— 教程结束，祝你开发顺利 ——