当前位置：首页 > news >正文

核桃派1B开发板与HC-SR04超声波测距实战

news 2026/7/17 7:10:17

1. 核桃派1B开发板与超声波测距初探

第一次拿到核桃派1B开发板时，我就被它小巧的尺寸和丰富的接口所吸引。这块基于全志H3处理器的开发板，虽然只有信用卡大小，却集成了WiFi、蓝牙、GPIO、USB等丰富接口，特别适合物联网和嵌入式开发场景。而超声波测距作为最基础的传感器应用之一，自然成为我上手测试的首选项目。

HC-SR04超声波模块可以说是电子爱好者的"老朋友"了。这个单价不到10元的模块，通过发射40kHz的超声波并接收回波，能够实现2cm-400cm的非接触式距离测量。在智能小车避障、液位检测、停车辅助等场景中都有广泛应用。将它与核桃派1B结合，既能验证开发板的基本GPIO功能，又能构建一个完整的测距系统。

2. 硬件连接与工作原理详解

2.1 HC-SR04模块引脚定义

这个四针模块的接线非常简单：

VCC：5V电源输入（核桃派的5V引脚）
Trig：触发信号输入（接GPIO输出）
Echo：回波信号输出（接GPIO输入）
GND：地线

特别注意：虽然Echo脚输出的是5V电平，但核桃派的GPIO只能耐受3.3V，需要分压电路。最简单的方案是用两个电阻（如1kΩ和2kΩ）组成分压器，将5V降到约3.3V。

2.2 测距原理剖析

超声波测距的核心是时间差测量：

主控通过Trig脚发送至少10μs的高脉冲
模块自动发射8个40kHz超声波脉冲
当接收到回波时，Echo脚输出高电平
主控测量高电平持续时间t（单位μs）
距离 = (t × 声速)/2 （常温下声速约343m/s，即每μs对应0.0343cm）

这个过程中有几个关键点需要注意：

测量间隔建议大于60ms，避免上一次回波干扰
温度会影响声速，精确测量需加入温度补偿
最小测量距离约2cm，过近物体可能无法检测

3. 核桃派1B开发环境配置

3.1 系统准备

核桃派1B支持多种操作系统，我选择官方的Walnut Pi OS（基于Debian）。烧录镜像后，首次启动需要：

sudo apt update sudo apt install -y python3-gpiozero

如果使用C语言开发，还需要安装wiringPi库：

git clone https://github.com/WalnutPi/wiringPi cd wiringPi ./build

3.2 GPIO编号对照

核桃派1B使用40针GPIO接口，但引脚定义与树莓派不同。超声波模块建议使用这些GPIO：

物理引脚7（GPIO4）作为Trig
物理引脚11（GPIO17）作为Echo

可以通过命令查看引脚映射：

gpio readall

4. Python实现超声波测距

4.1 基础测距代码

使用Python的RPi.GPIO库实现：

import RPi.GPIO as GPIO import time TRIG = 4 ECHO = 17 GPIO.setmode(GPIO.BCM) GPIO.setup(TRIG, GPIO.OUT) GPIO.setup(ECHO, GPIO.IN) def get_distance(): GPIO.output(TRIG, True) time.sleep(0.00001) GPIO.output(TRIG, False) while GPIO.input(ECHO) == 0: pulse_start = time.time() while GPIO.input(ECHO) == 1: pulse_end = time.time() pulse_duration = pulse_end - pulse_start distance = pulse_duration * 17150 # 34300/2 return round(distance, 2) try: while True: dist = get_distance() print(f"Distance: {dist} cm") time.sleep(0.1) except KeyboardInterrupt: GPIO.cleanup()

4.2 代码优化技巧

滤波处理：连续采样5次取中值，避免突变值

def median_filter(readings): sorted_readings = sorted(readings) return sorted_readings[len(readings)//2]

温度补偿：使用DS18B20温度传感器获取环境温度
```
def get_speed_of_sound(temp): return 331.4 + 0.6 * temp
```

异常处理：添加超时机制防止死循环

timeout = time.time() + 0.1 # 100ms超时 while GPIO.input(ECHO) == 0 and time.time() < timeout: pulse_start = time.time()

5. C语言高效实现

对于需要更高性能的场景，可以使用C语言版本：

#include <wiringPi.h> #include <stdio.h> #include <sys/time.h> #define TRIG 4 #define ECHO 17 long getDistance() { digitalWrite(TRIG, HIGH); delayMicroseconds(10); digitalWrite(TRIG, LOW); while(digitalRead(ECHO) == LOW); struct timeval start, end; gettimeofday(&start, NULL); while(digitalRead(ECHO) == HIGH); gettimeofday(&end, NULL); long duration = (end.tv_sec - start.tv_sec) * 1000000 + (end.tv_usec - start.tv_usec); return duration * 0.0343 / 2; } int main() { wiringPiSetup(); pinMode(TRIG, OUTPUT); pinMode(ECHO, INPUT); while(1) { printf("Distance: %ld cm\n", getDistance()); delay(100); } return 0; }

编译命令：

gcc -o ultrasonic ultrasonic.c -lwiringPi

6. 实际应用与进阶玩法

6.1 智能避障小车

将超声波模块安装在舵机上，实现180°扫描：

from gpiozero import AngularServo servo = AngularServo(18, min_angle=-90, max_angle=90) def scan_area(): distances = [] for angle in range(-90, 91, 10): servo.angle = angle time.sleep(0.3) distances.append((angle, get_distance())) return distances

6.2 结合MQTT实现远程监控

使用paho-mqtt库将数据上传到服务器：

import paho.mqtt.client as mqtt client = mqtt.Client() client.connect("broker.hivemq.com", 1883) while True: distance = get_distance() client.publish("walnutpi/ultrasonic", f"{distance}") time.sleep(1)

6.3 可视化界面开发

用PyQt5创建实时距离显示界面：

from PyQt5.QtWidgets import QApplication, QLabel, QVBoxLayout, QWidget app = QApplication([]) window = QWidget() layout = QVBoxLayout() label = QLabel("Distance: -- cm") def update_display(): label.setText(f"Distance: {get_distance()} cm") QTimer.singleShot(100, update_display) layout.addWidget(label) window.setLayout(layout) window.show() update_display() app.exec_()

7. 常见问题排查指南

持续返回最大值：
- 检查Echo脚是否接触良好
- 确认分压电路工作正常
- 尝试降低Trig脉冲宽度至10-20μs
测量值波动大：
- 添加硬件滤波（在Echo脚对地加0.1μF电容）
- 软件端采用滑动平均滤波
- 确保被测物体表面平整（绒布等吸音材料会影响测量）
GPIO操作报错：
- 检查用户是否在gpio组：groups $USER
- 临时解决方案：sudo chmod 666 /dev/gpiomem
- 永久解决方案：将用户加入gpio组
测量距离受限：
- 检查电源电压是否稳定（建议5V 1A以上）
- 避免强光直射模块接收器
- 高温环境下需增加温度补偿