Arduino UNO + HC-SR04 + Adafruit OLED 128×64 超声波测距仪

物料清单

接线表

核心库

• Adafruit_GFX
• Adafruit_SSD1306
• Wire.h、SPI.h (库依赖)

测距原理回顾

1. Trig 发 10 µs 高脉冲 → 模块发射 8×40 kHz 脉冲包
2. Echo 输出高电平，宽度 = 声波往返时间
3. 距离(cm) = (高电平宽度 µs / 2) / 29.1

完整代码（含公英制切换宏）

// CODE BY Javier Muñoz Sáez
#include <SPI.h>
#include <Wire.h>
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>

#define CommonSenseMetricSystem   // 取消注释切换单位
// #define ImperialNonsenseSystem

#define trigPin 13
#define echoPin 12
#define OLED_RESET 4
Adafruit_SSD1306 display(OLED_RESET);

void setup() {
  Serial.begin(9600);
  pinMode(trigPin, OUTPUT);
  pinMode(echoPin, INPUT);
  display.begin(SSD1306_SWITCHCAPVCC, 0x3C);
  display.clearDisplay();
}

void loop() {
  long duration, distance;
  digitalWrite(trigPin, LOW);  delayMicroseconds(2);
  digitalWrite(trigPin, HIGH); delayMicroseconds(10);
  digitalWrite(trigPin, LOW);
  duration = pulseIn(echoPin, HIGH);

  #ifdef CommonSenseMetricSystem
    distance = (duration / 2) / 29.1;
  #endif
  #ifdef ImperialNonsenseSystem
    distance = (duration / 2) / 73.914;
  #endif

  // OLED 显示
  display.setCursor(22, 20);
  display.setTextSize(3);
  display.setTextColor(WHITE);
  display.println(distance);
  display.setCursor(85, 20);
  display.setTextSize(3);
  #ifdef CommonSenseMetricSystem
    display.println("cm");
  #endif
  #ifdef ImperialNonsenseSystem
    display.println("in");
  #endif
  display.display();
  delay(500);
  display.clearDisplay();

  Serial.println(distance); // 调试用
}

原理图

扩展建议

• 加装蜂鸣器，距离 < 20 cm 报警
• 结合舵机云台实现 180° 扫描测绘
• 改用 VL53L0X ToF 传感器提升精度与抗干扰