基于STM32与超声波传感器的触发式警报器设计与实现

1. 项目概述：当超声波遇到开发板，一个实用的警报器诞生了

最近在整理工作室的物料，发现手头有好几块闲置的STM32开发板，还有一些超声波传感器模块。放着也是吃灰，不如动手做个有意思的小玩意儿。于是，一个基于超声波传感器的触发式警报器的想法就冒了出来。这个项目听起来简单，但麻雀虽小五脏俱全，它完美融合了传感器数据采集、阈值判断、状态机控制以及声光报警输出等多个嵌入式开发的核心环节。对于刚接触STM32或者Arduino这类STEM开发板的朋友来说，这是一个绝佳的练手项目，能让你在动手中理解中断、定时器、PWM这些基础但至关重要的概念。

这个超声波激活警报器的核心功能很直观：它持续监测前方障碍物的距离，一旦有物体进入预设的“警戒区域”，系统就会立即触发声光报警——LED灯开始闪烁，蜂鸣器发出鸣响。直到物体离开警戒区域，警报才会解除。你可以把它想象成一个简易的电子“卫兵”，或者一个防止抽屉被意外打开的提醒装置。实现它，你不仅需要连接硬件，更要编写逻辑清晰的代码来处理传感器的“回声”，并做出快速响应。下面，我就把自己从电路搭建到代码调试的完整过程，以及踩过的坑和总结的经验，详细地分享出来。

2. 核心硬件选型与电路设计思路

2.1 开发板与传感器的选择考量

这个项目的硬件核心就两块：主控板和超声波传感器。主控板我手头有STM32F103C8T6（蓝桥杯常用板）和Arduino Uno，为了演示的通用性，这里我选择用STM32来讲解，但其原理和代码逻辑完全适用于Arduino或其他ARM Cortex-M内核的开发板。选择STM32的原因在于其资源丰富，定时器精准，方便我们后期扩展功能（比如增加无线模块、OLED显示等）。

超声波传感器方面，最常见的是HC-SR04模块。它价格低廉、资料丰富，非常适合学习和原型开发。它的工作原理是经典的“发射-接收-计时”：触发引脚（Trig）发出一个至少10微秒的高电平脉冲，模块会自动发射8个40kHz的超声波脉冲，然后回声引脚（Echo）会输出一个高电平，其持续时间与超声波往返时间成正比。我们只需要测量这个高电平的宽度，就能计算出距离。公式很简单：距离 = (高电平时间 * 声速) / 2。在空气中，声速受温度影响，常温下（20°C）可按343米/秒估算，简化计算时常用 距离（厘米） = 高电平时间（微秒） / 58 。

除了HC-SR04，你也可以选择精度更高的US-100模块（自带温度补偿，串口和电平两种模式）或防水型的JSN-SR04T。但对于我们这个警报项目，HC-SR04的2cm-450cm量程和约3mm的精度已经完全够用。

2.2 外围报警器件的搭配

警报需要“声”和“光”。对于光报警，我选用了一个普通的5mm红色LED，通过一个220欧姆的限流电阻连接到开发板的GPIO引脚。为什么是220欧姆？这是一个经典值。假设LED正向压降约为2V，STM32的GPIO输出高电平为3.3V，那么限流电阻R = (3.3V - 2V) / 0.01A = 130欧姆。为了让LED寿命更长、亮度适中，选择稍大一点的220欧姆，电流约6mA，既安全又明亮。

对于声报警，最常见的是有源蜂鸣器。注意，蜂鸣器分“有源”和“无源”。有源蜂鸣器内部自带振荡电路，通电就响，音调固定；无源蜂鸣器需要外部输入PWM信号才能发声，可以控制音调和演奏音乐。为了让电路和代码最简单，我选择有源蜂鸣器。它只有正负两极，正极接GPIO，负极接地。当GPIO输出高电平时，蜂鸣器鸣响。

2.3 电路连接图与关键细节

整个系统的连接非常简单：

1. HC-SR04 ：

   • VCC -> 开发板5V或3.3V（HC-SR04兼容，但用5V测距更稳定）
   • GND -> 开发板GND
   • Trig -> 开发板任意GPIO（如PA0）
   • Echo -> 开发板任意GPIO（如PA1）

2. LED ：

   • 阳极（长脚） -> 串联220Ω电阻 -> 开发板GPIO（如PA2）
   • 阴极（短脚） -> 开发板GND

3. 有源蜂鸣器 ：

   • 正极（标+号） -> 开发板GPIO（如PA3）
   • 负极 -> 开发板GND

注意 ：HC-SR04的Echo脚输出的是5V电平的信号。如果你的开发板是3.3V系统（如STM32大部分IO口耐压5V但识别高电平阈值约2V，通常没问题），直接连接一般可以工作。但如果担心长期使用损坏IO口，一个稳妥的做法是使用两个电阻（例如1kΩ和2kΩ）组成分压电路，将5V降到约3.3V再接入Echo引脚。

3. 软件逻辑与代码实现解析

3.1 程序主框架与状态机设计

写代码最怕思路混乱。对于这个警报器，我们可以清晰地定义出几个状态：

• 状态0（空闲监测） ：不断测量距离，并与预设警戒距离比较。
• 状态1（触发报警） ：当距离小于警戒值时，进入此状态，开启LED闪烁和蜂鸣器。
• 状态2（报警维持） ：即使物体移开，报警也持续一段时间（如3秒），防止频繁启停。
• 状态3（解除报警） ：维持时间到，关闭声光报警，返回状态0。

这就是一个简单的有限状态机。用 switch-case 语句或者 if-else 链就很容易实现。主循环（main loop）的核心任务就是根据当前状态执行相应的操作，并管理状态之间的转换。使用状态机能让程序逻辑清晰，易于调试和扩展。

3.2 超声波测距的精准实现

测距的准确性是整个项目的基石。这里的关键是精确测量Echo引脚高电平的持续时间。有几种方法：

1. 阻塞式延时测量 ：这是最简单但最不推荐的方法。在触发Trig后，用 while 循环等待Echo变高，再等待其变低，期间用变量累加微秒延时。这种方法会完全占用CPU，导致系统无法处理其他任务，不实用。

2. 外部中断捕获 ：这是更优雅和高效的方法。将Echo引脚配置为上升沿和下降沿触发的外部中断。在上升沿中断发生时，记录一个定时器的时间戳（如TIM2的计数器值）；在下降沿中断发生时，再次读取定时器值，两者之差即为高电平时间。这种方法精准且不阻塞主程序。

3. 输入捕获 ：这是STM32等高级MCU的硬件级方案。利用定时器的输入捕获功能，硬件会自动在Echo信号边沿发生时记录计数器值，几乎不消耗CPU资源，精度最高。

这里我以STM32 HAL库为例，展示如何用输入捕获实现测距。我们选用一个通用定时器（如TIM2），将其一个通道（如CH1）配置为输入捕获模式，捕获Echo引脚信号。

首先，在CubeMX中配置：

• 将连接Echo的GPIO（PA1）配置为TIM2_CH1。
• 开启TIM2，时钟源选择内部时钟，分频系数设为（系统时钟频率/1MHz - 1），这样计数器每微秒递增一次，方便计算。例如72MHz系统时钟，分频系数设为71。
• 捕获/比较通道1选择输入捕获直连模式，边沿选择为上升沿和下降沿。
• 开启TIM2的全局中断。

生成的代码骨架中，我们需要在中断回调函数 HAL_TIM_IC_CaptureCallback 中编写逻辑：

uint32_t uwIC2Value1 = 0, uwIC2Value2 = 0;
uint32_t uwDiff = 0;
uint8_t ucCaptureNumber = 0;
float distance_cm = 0;

void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim) {
    if (htim->Instance == TIM2) {
        if (ucCaptureNumber == 0) { // 第一次捕获，上升沿
            uwIC2Value1 = HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1);
            ucCaptureNumber = 1;
            // 改变捕获边沿为下降沿
            __HAL_TIM_SET_CAPTUREPOLARITY(htim, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_FALLING);
        } else if (ucCaptureNumber == 1) { // 第二次捕获，下降沿
            uwIC2Value2 = HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1);
            __HAL_TIM_SET_COUNTER(htim, 0); // 计数器清零，准备下一次测量

            if (uwIC2Value2 > uwIC2Value1) {
                uwDiff = uwIC2Value2 - uwIC2Value1;
            } else {
                // 处理计数器溢出（如果计数器位数不够，本例中1MHz计数，450cm对应约26000微秒，16位计数器会溢出）
                uwDiff = (0xFFFF - uwIC2Value1) + uwIC2Value2;
            }

            distance_cm = (float)uwDiff / 58.0; // 计算距离
            ucCaptureNumber = 0;
            // 恢复捕获边沿为上升沿，等待下一次测量
            __HAL_TIM_SET_CAPTUREPOLARITY(htim, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_RISING);
        }
    }
}

在主循环中，我们只需要周期性地（比如每100毫秒）给Trig引脚一个10微秒以上的高电平脉冲，触发一次测量，然后读取全局变量 distance_cm 即可。

3.3 报警触发与多任务管理

获取到实时距离后，报警逻辑就很简单了。在主循环的状态机中判断：

#define ALARM_DISTANCE_CM 30.0 // 警戒距离30厘米
#define ALARM_HOLD_MS 3000     // 报警维持3秒

static enum {S_IDLE, S_ALARM_TRIGGER, S_ALARM_HOLD, S_ALARM_OFF} system_state = S_IDLE;
static uint32_t alarm_trigger_time = 0;

void main_loop(void) {
    float current_distance = get_distance(); // 获取最新距离值

    switch(system_state) {
        case S_IDLE:
            if (current_distance > 0 && current_distance < ALARM_DISTANCE_CM) {
                system_state = S_ALARM_TRIGGER;
            }
            break;

        case S_ALARM_TRIGGER:
            // 开启LED闪烁和蜂鸣器
            start_alarm();
            alarm_trigger_time = HAL_GetTick(); // 记录触发时刻
            system_state = S_ALARM_HOLD;
            break;

        case S_ALARM_HOLD:
            // 持续报警，即使物体离开
            if (HAL_GetTick() - alarm_trigger_time >= ALARM_HOLD_MS) {
                system_state = S_ALARM_OFF;
            }
            break;

        case S_ALARM_OFF:
            // 关闭报警
            stop_alarm();
            system_state = S_IDLE;
            break;
    }

    // 如果处于报警状态，处理LED闪烁（可以用定时器中断更优雅）
    if (system_state == S_ALARM_TRIGGER || system_state == S_ALARM_HOLD) {
        handle_led_blink(); // 例如每500ms翻转一次LED状态
    }
}

这里有一个关键点： 报警维持时间 。如果没有这个维持状态，当物体在警戒线附近轻微晃动时，会导致警报疯狂地响、停、响、停，体验极差。加入一个维持时间（如3秒），只有持续超出警戒范围超过3秒才会解除警报，这在实际应用中非常必要。

4. 系统优化与功能扩展实战

4.1 抗干扰与数据滤波处理

在实际环境中，超声波测距会受到温度、湿度、测量表面材质（特别是柔软或倾斜的表面）的影响，偶尔会出现跳变的异常值（比如突然一个极大或极小的值）。直接使用原始数据判断会导致误报警。因此，必须加入软件滤波。

最简单的是一阶滞后滤波（也称指数加权平均）：

float filtered_distance = 0;
float alpha = 0.3; // 滤波系数，0-1之间，越小越平滑但响应越慢

float apply_low_pass_filter(float raw_distance) {
    filtered_distance = alpha * raw_distance + (1 - alpha) * filtered_distance;
    return filtered_distance;
}

更稳健的方法是 中值滤波 ：连续采样N次（比如5次），排序后取中间值作为本次测量结果。这种方法能有效剔除偶然的脉冲干扰。我们可以结合这两种方法：先进行中值滤波去除野值，再进行一阶滞后滤波平滑曲线。

4.2 利用定时器实现精准闪烁与无阻塞延迟

在主循环里用 HAL_Delay 来控制LED闪烁是不好的做法，因为它会阻塞整个循环。更好的方法是利用一个硬件定时器（如TIM3）产生一个1ms的中断，在中断服务程序里维护一个软件计时器。

volatile uint32_t sys_tick_ms = 0;
void TIM3_IRQHandler(void) {
    if (__HAL_TIM_GET_FLAG(&htim3, TIM_FLAG_UPDATE) != RESET) {
        __HAL_TIM_CLEAR_FLAG(&htim3, TIM_FLAG_UPDATE);
        sys_tick_ms++;
    }
}

// 非阻塞延时判断函数
uint8_t check_timer(uint32_t *last_time, uint32_t interval) {
    uint32_t current = sys_tick_ms;
    if (current - *last_time >= interval) {
        *last_time = current;
        return 1;
    }
    return 0;
}

// 在主循环中非阻塞控制LED
static uint32_t last_blink_time = 0;
if (check_timer(&last_blink_time, 500)) { // 每500ms执行一次
    HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin); // 翻转LED
}

这样，LED的闪烁就完全由定时器中断驱动，主循环只负责在需要时改变闪烁的启停状态，程序效率大大提高。

4.3 功能扩展：从简单警报到智能监控

基础功能实现后，这个项目可以轻松扩展：

• 增加OLED显示 ：使用I2C接口的0.96寸OLED，实时显示当前距离、报警状态、警戒阈值等信息。
• 阈值可调 ：增加两个按键，用于在运行中增加或减少警戒距离，并将阈值保存到STM32的Flash中，实现掉电保存。
• 报警模式多样化 ：除了声光，可以连接一个继电器模块，当触发报警时，继电器吸合，可以控制一个更大的警铃或者切断某个设备的电源。
• 无线通知 ：集成一个ESP-01S WiFi模块，当报警触发时，通过MQTT协议向手机APP（如Blynk、点灯科技）发送推送通知，实现远程监控。
• 多传感器融合 ：增加一个红外热释电（PIR）传感器，只有同时检测到物体移动（PIR）和近距离存在（超声波）时才触发报警，大大降低误报率。

5. 调试心得与常见问题排坑指南

5.1 硬件连接检查清单

问题往往出在最初级的环节。上电前，请务必按以下顺序检查：

1. 电源 ：确保开发板、传感器、蜂鸣器供电电压正确且稳定。特别是HC-SR04，如果接3.3V，长距离测量时可能因电压不足导致工作不稳定。
2. 共地 ：所有模块的GND引脚必须连接到开发板的GND，形成共同的参考地，这是信号正常读取的基础。
3. 信号线 ：确认Trig和Echo是否接反。Trig是输出，接GPIO输出模式；Echo是输入，接GPIO输入模式或定时器输入捕获引脚。
4. 上拉电阻 ：有些开发板内部GPIO无上拉，而HC-SR04的Echo脚是开漏输出，需要在Echo脚和VCC之间接一个1kΩ-10kΩ的上拉电阻，否则可能无法读到高电平。STM32的输入捕获模式通常可以配置内部上拉，可以省去外部电阻。

5.2 软件调试与数据验证

如果硬件无误但测距不准或没数据，按以下步骤排查：

1. 验证Trig信号 ：用逻辑分析仪或示波器查看Trig引脚，是否发出了一个干净的10-20微秒的高脉冲。如果没有，检查GPIO初始化代码，确认设置为推挽输出模式。
2. 验证Echo信号 ：同样用仪器查看Echo引脚。在Trig触发后，应该能看到一个高电平脉冲。如果一直为低，检查接线和传感器是否损坏；如果一直为高，可能是传感器故障或电源问题。
3. 检查定时器配置 ：如果使用输入捕获，重点检查定时器的预分频器（PSC）和自动重载值（ARR）设置是否正确。确保计数频率在1MHz左右（每微秒计数一次）。同时，检查输入捕获通道的极性设置是否正确。
4. 打印原始时间值 ：在代码里，不要急于转换成距离，先把捕获到的高电平时间计数值 uwDiff 通过串口打印出来。用手在传感器前移动，观察数值是否平滑变化。如果数值跳动巨大或为0，可能是中断处理逻辑有问题，比如变量被意外修改、中断嵌套等。
5. 处理超时 ：超声波可能因为超出量程或没有收到回波而导致Echo信号一直为高。代码中必须加入超时判断。例如，在触发测量后，启动一个定时器，如果超过30ms（对应约5米）仍未收到下降沿中断，则强制结束本次测量，并返回一个错误值（如-1）。

5.3 典型问题速查表

5.4 从原型到产品的思考

做完这个demo，如果你真的想把它变成一个可靠的产品，还需要考虑更多：

• 功耗 ：如果使用电池供电，需要让MCU和传感器在大部分时间进入休眠模式，仅定时唤醒测量，这将大幅延长续航。
• 环境适应性 ：温度变化会显著影响声速。如果要高精度，可以加入温度传感器（如DS18B20），实时修正声速公式中的参数。
• 结构设计 ：传感器和报警单元的物理布局。蜂鸣器发出的声音振动可能会干扰超声波传感器，导致测量失准，需要将它们隔开或通过软件在发声时暂停测距。
• 可靠性测试 ：在不同温度、湿度、光照条件下长时间运行，检验其稳定性。

这个超声波激活警报器项目，就像一把钥匙，帮你打开了嵌入式系统开发中传感器应用、实时控制、状态机设计和系统调试的大门。它涉及的知识点非常典型，而且所有代码和思路都可以迁移到其他传感器项目，比如红外、激光、声音检测等等。最重要的是动手去做，在调试和解决问题的过程中，你的收获远比只看文档要大得多。我自己的那块板子，现在正挂在工作室的门后，每次有人过于靠近我的工作台，它都会忠实地发出提醒，虽然简单，却非常实用。