【完全免费】ESP32-S3 + MAX30102 心率血氧监测实践:5 根线接出一台指尖监测仪

原创2026-11-14 13:44:392,636 阅读

【完全免费】ESP32-S3 + MAX30102 心率血氧监测实践:5 根线接出一台指尖监测仪

如果你手头有一块 ESP32-S3 开发板,想花几十块钱搭一台能实时读心率和血氧(SpO2)的小设备,这个项目基本就是照着抄作业来的:资源文件 15.max30102.zip 里是一个完整的 ESP-IDF 工程,解压、接线、烧录,手指按在 MAX30102 传感器上,串口里就开始滚数据。下面按"接线 → 原理 → 上手 → 踩坑"的顺序讲一遍,全部参数都来自工程源码。

方案概览:谁负责哪一步

一句话分工:MAX30102 负责"照手指、收光",ESP32-S3 负责"读数据、算结果、打出来"。

  • MAX30102:一颗集成的脉搏血氧传感芯片,板载一颗红光 LED、一颗红外 LED 和光电探测器,光信号进、数字量出;
  • ESP32-S3:通过 I2C(两根信号线就能通信的接口)按固定地址读取传感器 FIFO 里的原始光强,算出血氧和心率;
  • 显示端:本工程直接走串口打印,任何串口终端工具就是它的"屏幕",后续想换屏幕或推手机,改的只是显示部分。

工作原理:两盏灯,算出两个数

不用背公式,先想一个生活化的类比:把手指当成一块会"透光"的肉,MAX30102 在里面装了两盏颜色不同的灯——红光和红外光,轮流(交替)往手指里打光,再回收穿透手指后的光。

关键在于:含氧血红蛋白和脱氧血红蛋白对这两种光的"胃口"不一样。血里氧气充足时,红外光穿过去多、红光被吃掉的相对多;氧气不足则正好反过来。于是:

  1. 血氧饱和度:用"红外光读数 / 红光读数"得到一个比值 R,R 大说明血里"吃的"红外光多、含氧低。工程里用一条拟合曲线把 R 换算成百分比;
  2. 心率:动脉里的血量随心跳一张一缩,光强曲线也跟着周期性起伏,数这个起伏的快慢就是心率;
  3. 数据通路:上面两步发生在芯片内部,ESP32-S3 只干两件事——通过 I2C 把原始读数搬出来(7 位设备地址 0x57),以及等 INT 引脚拉低("有新数据了"的信号)去取数。

能用来做什么

  • 居家留档(素材里没提的玩法):ESP32-S3 自带 Wi-Fi,把每分钟的平均心率/血氧往家里服务器或手机端一推,给老人做"每日静息心率趋势"记录,比单次读数更有参考价值;
  • 教学演示:I2C 寄存器读写 + GPIO 中断 + FIFO 取数,一个项目把嵌入式基础三件套全练到了,适合课堂带学生拆代码;
  • 桌边小工具:写个简单阈值判断,血氧低于设定值时让开发板上的 LED 或蜂鸣器报警,给长时间伏案的自己当个提醒。

需要提醒一句:这类设备适合看趋势、做实验,读数精度受佩戴和环境影响,不能替代医用指夹血氧仪。

接线:ESP32-S3 血氧传感器引脚对照

工程源码里 I2C 配置是写死的,接线照下表来即可(SCL/SDA 共 2 根线 + INT 1 根 + 电源 2 根):

MAX30102 引脚 ESP32-S3 说明
SCL GPIO15 I2C 时钟线,50 kHz(源码中 clk_speed 设定)
SDA GPIO5 I2C 数据线,代码里已开启上拉
INT GPIO3 数据就绪中断,下降沿触发
VCC 3.3V 与开发板电源电压保持一致
GND GND 共地,必接

最小可运行步骤

  1. git clone https://gitcode.com/open-source-toolkit/8dad4,下载仓库里的 15.max30102.zip 并解压,得到一个标准 ESP-IDF 工程:main/ 是入口,components/max30102/ 是传感器驱动(核心逻辑在 max30102.c,共约 200 行,注释很全);
  2. 按上表接好线,手指指腹压住传感器窗口、按实,别悬空;
  3. idf.py build 编译,再 idf.py -p <串口> flash monitor 烧录并打开串口终端;
  4. 手指放上去后,串口应周期性打印 血氧:xx,心率:xx。

打印的那两个数是这样算出来的(components/max30102/max30102.c,原样贴出):

xueyang = (float)(data[1]) / (float)(data[0]);
xinlv = 30.354 * xueyang + 94.845 - 45.060 * xueyang * xueyang;
printf("血氧:%f,心率:%d\n", xueyang * 100, xinlv);

翻译成人话:红外光值除以红光值得到比值,代入那条拟合曲线就是血氧百分比,旁边那个数是按周期算出的心率——注意它只是工程给的近似算法,精度够用但别拿它和医用设备对表。

上手常见的坑(这部分文档不会告诉你)

  • 采样率与功耗的取舍:工程默认 100 SPS(每秒采样 100 次)、LED 电流 16 mA,实时性好但电流不低。MAX30102 支持降到 50/25/10 SPS,改成 25 SPS 后血氧读数依旧稳定,适合电池供电场景;但采样率调太低会漏掉心率峰值,不建议低于 25 SPS 测心率。
  • 按不实 = 没数据:红光信号弱于阈值时,程序直接打印"没有手指检测"。换个按法、让指腹把整个窗口盖住,比怀疑硬件更快。
  • 环境光是头号干扰:阳光、台灯直射传感器窗口,读数会明显漂移。调试时把设备转到背光位置再看。
  • INT 中断别漏清:源码里反复出现"读取 0x00 中断状态寄存器"的动作,就是为了清 PPG_RDY 标志——不读这个寄存器,第一次中断之后就再也不会响了,这是 MAX30102 最经典的坑。
  • 先看懂再改引脚:max30102.c 顶部把 SCL/SDA/INT 三个宏定义放在最前面,换板子改这三行就行,别去动 I2C 初始化里的其他参数。

下一步

建议第一次跑通后做两件事:把采样率宏从 100 改成 25,对比读数和电流;然后通读 max30102.c 里 max30102_init() 的寄存器注释,把 SpO2 模式、FIFO 和 LED 电流三项配置的含义吃透——这两步做完,这个工程对你来说就从"能跑"变成"能改"了。项目采用 MIT 协议,自由使用和二次开发都没问题。

登录后查看全文
ESP32-S3驱动MAX30102显示心率血氧