ESP32 实战教程：用 MAX30102 观察脉搏波形与心率趋势

本文按“先跑通、再测量、最后工程化”的顺序整理。不同开发板、模块批次和库版本可能存在差异，请以手中硬件的丝印、数据手册与实际串口日志为准。

一、为什么值得做

MAX30102 可以观察光电容积脉搏波，也就是常说的 PPG。手指血容量随心跳变化，会让反射光强出现周期波动。它很适合学习采样、滤波和峰值检测，但学习板、接线和简单算法不能替代医疗设备。本教程只用于观察信号和理解算法，不用于诊断、用药或任何医疗决定。

这次不追求把所有功能一次堆满。先完成一个最小闭环：硬件能初始化、原始数据有变化、异常时能明确报错；随后再加入标定、滤波和状态机；最后才连接网页、MQTT 或本地存储。这个顺序看起来慢一点，实际会少掉很多“到底是线错了、库错了，还是页面错了”的集体猜谜。

二、硬件清单与接线重点

准备 ESP32、MAX30102 模块和遮光结构。模块通过 I2C 连接，先扫描地址并确认供电要求。手指轻放在传感器上，压力过轻会漏光，压得过重又会阻碍血流。环境光、手指移动、皮肤温度和 LED 电流都会改变波形，测试时应保持姿势稳定。

第一次接线建议使用短线，在断电状态下逐根核对，并记录开发板型号、GPIO 编号、模块供电电压和接口地址。不要只写“接到 SDA”，因为换一块板后默认 SDA 可能不同。电机、舵机、风扇和继电器等负载应使用合适的独立电源，GPIO 只负责信号，不能兼职当小型发电站。

三、工作原理

采样值包含很大的直流分量和较小的脉搏交流分量。算法先判断是否有手指，再通过移动平均或高通思路去掉缓慢基线，然后寻找满足幅度、间隔和上升沿条件的峰值。相邻有效峰值的时间差是心搏间隔，60000 / 间隔毫秒 得到瞬时 BPM。不能只凭一次峰值就输出结果，应对多次间隔做范围检查和中值处理。

把系统分成五层会更容易排错：电气连接、驱动通信、原始数据、业务换算、显示与联网。每层都留一个可观察点，例如电源电压、初始化返回值、原始帧、换算结果和页面状态。上层失败时先确认下层证据，不要页面上没有数字就立刻换三套库。

四、第一次实验与标定

不同人的手指、模块光路和环境差异很大，不要把固定阈值写成宇宙常数。先打印原始红外数据，观察无手指、稳定按压和轻微移动三种状态；再确定手指检测阈值和波形振幅范围。LED 电流不是越大越好，过强可能饱和，过弱则信噪比不足。

标定数据应与设备配置一起保存，并记录时间、参考物、环境和固件版本。更换模块、改变机械结构或升级算法后应重新验证。只记一个最终系数而不记原始数据，下一次发现偏差时很难判断是传感器老化、结构变化，还是当初计算时手滑。

五、最小可运行代码

下面的代码用于验证关键链路。安装对应库后，根据自己的开发板修改引脚、地址和参数：

#include <Wire.h>
#include <MAX30105.h>
#include <heartRate.h>

MAX30105 sensor;
uint32_t lastBeat = 0;

void setup() {
  Serial.begin(115200);
  Wire.begin(21, 22);
  if (!sensor.begin(Wire, I2C_SPEED_FAST)) while (true) delay(1000);
  sensor.setup();
}

void loop() {
  long ir = sensor.getIR();
  if (ir < 50000) {
    Serial.println("finger not detected");
    delay(20);
    return;
  }
  if (checkForBeat(ir)) {
    uint32_t now = millis();
    float bpm = 60000.0f / (now - lastBeat);
    lastBeat = now;
    if (bpm > 35 && bpm < 220) Serial.printf("bpm=%.1f\n", bpm);
  }
}

示例故意保留串口输出，因为学习阶段最重要的是能看到系统正在做什么。代码跑通后再逐步拆分模块，不能因为最终产品没有串口窗口，就在开发阶段也把所有线索关掉。

六、数据处理与状态设计

串口绘图器可以同时输出原始 IR、滤波值和峰值标记，肉眼观察算法是否在真正的波峰触发。页面显示最近 10 次有效间隔的中位数、信号质量和手指状态。信号质量不足时应显示“请保持静止”，不要为了界面好看继续吐出一个貌似可信的心率。

建议为设备统一设计四种状态：INIT 表示初始化，RUNNING 表示数据有效，DEGRADED 表示部分功能仍可用，ERROR 表示需要人工处理。每次状态变化记录原因和时间。错误恢复要有间隔，不能每个循环都重新初始化外设，否则日志会被刷满，设备也只是在高频重复同一个错误。

七、常见问题与排错顺序

手指移动会制造比脉搏更大的波峰，固定阈值很容易把动作当心跳。millis() 溢出应使用无符号差值处理，首个峰值不能计算 BPM。I2C 线过长、采样率设置不匹配或 FIFO 没及时读取都会造成丢样。血氧计算比心率更依赖标定，不应凭一个简化公式宣称具有医疗精度。

排错时按以下顺序进行：先测供电和地线，再确认引脚与接口参数；然后只运行最小示例，打印原始数据；最后才恢复网页和自动控制。每次只改一个变量，并保留失败时的原始输出。最怕的是接线、库版本和业务代码同时修改，最终虽然偶然成功，却不知道是哪一步真正起了作用。

八、从演示变成长期运行设备

把采样任务与网页任务分开，用队列传递降采样后的波形，避免浏览器连接影响 FIFO 读取。记录算法版本、采样率、LED 电流和有效率。涉及人体数据时还要考虑隐私、传输加密和保存期限；技术上能存，并不意味着应该无限期保存。

程序结构上，可以把驱动、数据模型、业务状态机、网络和存储拆开。采样任务只负责产生带时间戳的有效数据，网页负责读取快照，日志任务负责批量落盘。任何网络故障都不应阻止本地采样，任何页面刷新也不应改变控制周期。配置保存在 NVS 时加入默认值、范围检查和版本迁移。

九、建议完成的测试清单

冷启动、复位和断电重启后，设备能否进入明确状态；
外设拔掉、接错或返回异常值时，程序是否会卡死；
连续运行两小时，内存、温度、供电和日志是否稳定；
阈值附近反复变化时，输出是否存在抖动或频繁动作；
更换同型号模块后，原标定是否仍然适用；
Wi-Fi 断开、网页关闭或存储满时，本地核心功能是否继续工作；
对涉及人体、机械运动和大电流的项目，保护措施是否独立于软件存在。

建议建立实验表，至少记录原始值、处理值、单位、采样周期、错误次数、供电方式和测试结论。遇到偶发问题时，再增加启动次数和运行时长。工程经验常常不是来自“成功一次”，而是来自知道失败出现在哪个边界。

十、还能怎么扩展

可以做运动前后的趋势对比、呼吸节律实验或本地 OLED 波形显示。进一步研究时可加入带通滤波、运动伪影识别和信号质量评分，但所有结果仍应明确标注为学习和趋势观察。

扩展功能时仍然遵循一次增加一层的原则。先证明新模块独立工作，再接入现有状态机；先保存原始值，再绘制漂亮曲线。这样教程不仅能展示结果，也能给读者留下一条可以照着走的排错路线。

十一、总结

本项目的重点不是某一行库函数，而是把硬件、数据、状态和异常组合成一个可解释的小系统。能读取只是起点，能标定、能发现错误、能恢复、能留下日志，才算真正完成。实际制作后，建议继续补充接线照片、串口截图和一次真实失败记录，这些往往比“运行成功”四个字更有参考价值。

参考资料

打赏

如果这篇学习记录对你有帮助，欢迎扫码支持后续整理。

打赏支持：王庆岩

posted on 2026-10-06 00:30 潇洒石头阅读(31) 评论(0) 收藏举报

刷新页面返回顶部