ESP32+MAX30102零基础上手：让开发板“听见”心跳

真正让ESP32“长出一只耳朵”，去听心脏跳动的项目，我玩了整个周末。主角就是这块小小的MAX30102模块，网上也叫“心率血氧传感器”，其实它的原理特别朴素：往指尖打一束光，再根据透射回来的光变化判断血液脉冲。听起来像玄学，实际做出来之后，你会发现它输出的波形清清楚楚，就像心脏在对你打拍子。

说“零基础”并不夸张。你不需要懂傅里叶变换，不需要会画PCB，甚至不一定要会写复杂的程序。Arduino IDE里敲几十行代码，接四根杜邦线，串口监视器里就能蹦出一个BPM数值。这篇文章我按自己实际踩过的流程来写，从项目怎么拆、硬件怎么接、环境怎么搭、代码怎么看，到最后的调参和排坑，尽量让第一次摸ESP32的朋友也能照着做出来。

1. 项目怎么拆：为什么说它能让ESP32“听心跳”

1.1 这个项目到底做了什么

简单说，就是让ESP32通过I2C接口连接MAX30102，以一定的采样频率持续读取传感器返回的红外光强度值，再对这些值做实时分析：如果在某一时刻光强度出现一个明显下降，说明指尖血管里刚涌入了一波血液，也就是一次心跳。代码统计两次心跳的间隔时间，换算成每分钟心跳数，也就是BPM（Beats Per Minute）。

听起来是不是像在“听”？心脏每泵一次血，末梢血管的容积就涨一次，透过的光就少一点。MAX30102看到的是一串忽大忽小的光强度，我们把这种光强度随时间变化的曲线叫PPG（光电容积脉搏波）。ESP32要做的，就是把这条曲线的峰峰间隔找出来，翻译成人类看得懂的数字。

1.2 传感器原理：光学脉搏波是怎么来的

MAX30102内部集成了两路LED，一路红光（660nm左右），一路红外光（880nm左右），还有一个光电检测器。工作时，LED发出的光有一部分被皮肤、骨骼、组织吸收，剩下的透射回来被检测器接收。当心脏收缩时，动脉血量增加，血红蛋白对光的吸收增强，透射光减弱；心脏舒张时，血量减少，透射光增强。因此，检测器接收到的光强度信号，其实就携带了脉搏的节律信息。

实际使用时，我们通常优先读红外光通道的数据。因为红外光对血红蛋白的吸光度变化更稳定，受指尖肤色深浅、环境光扰动的影响比红光小。红光通道更多被用在血氧饱和度计算上，也就是SPO2，那里需要红光和红外两路信号做比值，项目如果只测心率，先用IR通道即可。

1.3 为什么要用ESP32来跑

过去很多人拿Arduino UNO做心率计，也能跑，但一旦想加点东西就容易憋屈。MAX30102的采样率即使调到200Hz，UNO的8位MCU处理起来也不难，但你不满足于只看一个串口数字吧？想加OLED屏、想通过Wi-Fi把心率推送到手机、想做无线上报，这时候ESP32的优势就非常明显了。

ESP32板载Wi-Fi和蓝牙，内存和主频都比传统AVR单片机高一大截，价格还很便宜。最关键的是，它完全兼容Arduino生态。也就是说，你学的Arduino代码、用的库，基本都能无缝迁移过来。对零基础来说，这是非常友好的路径：先用手边的Arduino经验把传感器调通，后面再慢慢切到ESP32的高级玩法。

2. 动手前的准备：器材清单与接线

2.1 需要的器材和参考价

这个项目需要的硬件很少，我列一个清单，基本都是入门常备件：

注意，MAX30102模块市面上有好几种版本，有的是完整的传感器小板，引脚是VIN、GND、SCL、SDA、INT；有的带了电平转换电路，板子上会有明显的一排芯片。我建议直接买带电平转换的版本，就是小板子上有额外电平转换芯片的那种，这种对3.3V/5V兼容性更好，不容易烧。

2.2 引脚连线与电压细节

接线是整个项目最不容易出错，也最容易出错的地方。MAX30102和ESP32都是3.3V逻辑，理论上可以直接对接，不需要额外电阻分压。但反过来，如果你把它接到5V单片机上，最好确认模块是否带电平转换，否则长期运行容易发热甚至损坏。

标准接法如下：

如果你用的是其他ESP32开发板，I2C引脚可能不同。例如部分ESP32-S2板默认是GPIO8/GPIO9，ESP32-S3常见的是GPIO8/GPIO9，但很多板子仍然沿用GPIO21/GPIO22。只要确定板子引出哪些引脚，程序里用Wire.begin(sda, scl)显式指定即可，不一定非要死记默认值。

2.3 上电自检：用I2C扫描确认硬件没问题

接好线后先别急着写完整代码，先做一个“体检”：用I2C扫描程序确认ESP32能看到MAX30102。MAX30102的I2C地址通常为0x57。这个步骤非常重要，它能帮你区分“硬件没接好”和“代码有问题”。

#include <Wire.h> void setup() { Serial.begin(115200); Wire.begin(21, 22); // SDA, SCL Serial.println("\nI2C Scanner"); } void loop() { byte error, address; int devices = 0; for (address = 1; address < 127; address++) { Wire.beginTransmission(address); error = Wire.endTransmission(); if (error == 0) { Serial.print("Found I2C device at 0x"); if (address < 16) Serial.print("0"); Serial.println(address, HEX); devices++; } } if (devices == 0) { Serial.println("No I2C devices found, check wiring!"); } delay(2000); }

如果串口打印出Found I2C device at 0x57，说明硬件链路已经打通。如果找不到，大概率就是杜邦线接触不良或者供电问题。我建议把这几件事按顺序检查：模块是否上电（VIN和GND有没有接反）、SCL/SDA是否接反、杜邦线是否插紧、USB供电是否够。MAX30102正常工作电流其实很小，一般USB供电完全够，但如果开发板还带了其他外设，要留意总电流。

3. 搭建开发环境：零基础装好Arduino IDE

3.1 给Arduino IDE添加ESP32板卡支持

这一步是很多新手的第一个门槛。Arduino IDE默认不带ESP32支持，需要手动添加板卡管理地址。

打开Arduino IDE，在“文件 -> 首选项 -> 附加开发板管理器网址”里添加下面这个地址：

https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json

然后打开“工具 -> 开发板 -> 开发板管理器”，搜索“esp32”，找到“esp32 by Espressif Systems”，点击安装。安装时间取决于网络状况，可能出现几十MB的下载。国内网络偶尔会超时，如果反复失败，建议检查代理或换个网络环境，多试几次也行。

装完之后，在“工具 -> 开发板”下拉菜单里会看到一堆ESP32型号，比如ESP32 Dev Module、ESP32-S3 Dev Module等。我用的板子是常见的ESP32 DevKitC，选“ESP32 Dev Module”即可。烧录前确认三件事：开发板型号选对、端口选对、上传速度可以保持默认921600，如果上传不稳定就降到115200。

3.2 安装MAX30102传感器库和心率算法库

我们不会从零写PPG信号处理算法，直接用现成的开源库。推荐装两个：

• SparkFun MAX3010x Pulse and Proximity Sensor Library
• SparkFun MAX3010x Heart Rate Library（或者叫heartRate库）

在Arduino IDE的“库管理器”里搜索MAX3010x，找到SparkFun发布的那几个，分别安装即可。注意库名字里有“Pulse Oximeter”字样，它包含了血氧相关的功能，虽然我们这个项目只用心率部分，但装完整库没坏处。

安装后，在“文件 -> 示例”里能看到SparkFun MAX3010x的示例程序，比如Example5_HeartRate。直接烧录这个示例，其实已经能出BPM了。但示例代码偏参数化，新手看起来有点懵。我建议把示例当参考，自己动手写一份更可控的代码，才知道每一行在干嘛。

3.3 常见环境报错和我的建议

• 烧录时报“A fatal error occurred: Failed to connect to ESP32”：最常见原因是板子没有进入下载模式。按住板子上的BOOT键不放，点烧录，看到“Connecting…”时松手，基本能过。
• 串口监视器乱码：波特率没对上。统一设置为115200，并且和代码里的Serial.begin保持一致。
• 开发板管理器安装失败：网络问题。多试几次，或者把附加开发板管理器网址里的github raw地址换成镜像源，但镜像源的时效性要注意。
• 找不到端口：检查USB线是不是只有充电功能的数据线，换一根数据线。

这些坑我当年全踩过一遍。尤其是那个BOOT键，很多教程一笔带过，结果我卡了半小时没烧进去。

4. 核心代码实现：从原始波形到BPM数值

4.1 第一步：只读原始红外信号

写心率算法前，先确保能稳定读取原始IR值。我把这个过程比作“先听清楚心跳，再数节拍”。如果原始信号一团糟，后续所有滤波和计算都是白搭。

#include <Wire.h> #include "MAX30105.h" MAX30105 particleSensor; void setup() { Serial.begin(115200); Wire.begin(21, 22); if (!particleSensor.begin(Wire, I2C_SPEED_FAST)) { Serial.println("MAX30102 was not found. Check wiring."); while (1); } particleSensor.setup(0x1F6, 4, 2, 200, 411, 0); } void loop() { long irValue = particleSensor.getIR(); Serial.println(irValue); delay(10); }

这段代码的作用就是持续打印IR值。你把手指放在传感器上，正常波形应该是：数值整体在一个基准线附近波动，每次心跳出现一次明显下凹。如果数值恒定不动，说明采集有问题；如果数值抖动剧烈无规律，说明按压或环境光干扰太大。

4.2 第二步：接入心率算法解析BPM

心率计算的本质是检测波形峰值（或者谷值），统计两次心跳的时间间隔。开源库heartRate.h里封装了一个checkForBeat函数，原理简单讲就是：当IR值的变化速率超过一个动态阈值，就认为检测到一次心跳。

完整代码如下：

#include <Wire.h> #include "MAX30105.h" #include "heartRate.h" MAX30105 particleSensor; const byte RATE_SIZE = 4; byte rates[RATE_SIZE]; byte rateSpot = 0; long lastBeat = 0; float beatsPerMinute = 0; int beatAvg = 0; void setup() { Serial.begin(115200); Wire.begin(21, 22); if (!particleSensor.begin(Wire, I2C_SPEED_FAST)) { Serial.println("MAX30102 was not found. Check wiring."); while (1); } particleSensor.setup(0x1F6, 4, 2, 200, 411, 0); particleSensor.setPulseAmplitudeRed(0x0A); particleSensor.setPulseAmplitudeIR(0x1F6); } void loop() { long irValue = particleSensor.getIR(); if (checkForBeat(irValue)) { long delta = millis() - lastBeat; lastBeat = millis(); beatsPerMinute = 60 / (delta / 1000.0); if (beatsPerMinute > 20 && beatsPerMinute < 255) { rates[rateSpot++] = (byte)beatsPerMinute; rateSpot %= RATE_SIZE; beatAvg = 0; for (byte x = 0; x < RATE_SIZE; x++) { beatAvg += rates[x]; } beatAvg /= RATE_SIZE; } } Serial.print("IR="); Serial.print(irValue); Serial.print(", BPM="); Serial.print(beatsPerMinute); Serial.print(", Avg="); Serial.println(beatAvg); delay(10); }

这里有几点要说明：

• 我用了4个元素的数组rates做滑动平均，也就是只保留最近4次BPM值求平均。这么做是为了平滑单次测量抖动，避免一个噪声脉冲导致读数乱跳。
• 检测到一次心跳后，立即用millis()计算与上一次心跳的时间差delta，然后换算成BPM。delta以毫秒为单位，所以公式是60 / (delta / 1000.0)。
• beatsPerMinute > 20 && < 255这个条件是为了过滤明显不合理的数值。低于20或高于255的情况基本是误检，直接丢弃。

4.3 关键参数详解

particleSensor.setup(ledBrightness, sampleAverage, ledMode, sampleRate, pulseWidth, adcRange)这一行很多人照着抄但没弄清意义。我逐个说一下：

如果你发现波形噪声大，可以把sampleAverage从4调到8甚至16，但代价是响应变慢，单次测量延迟变大。心率检测对这种延迟不敏感，所以调高些无妨。

4.4 为什么IR通道比红光通道更稳

如果你把getIR()换成getRed()，也能看到波形，但实际测下来，IR通道在大多数肤色和光照条件下都更稳定。原因很简单：红光更容易被皮肤表面反射干扰，而红外光穿透性更强，反映的是更深处动脉血的容积变化。再加上肤色深浅对红光吸收差异很大，对红外光的差异相对小，所以心率检测默认以IR为主。

这个项目如果想进一步做血氧饱和度，再用红光+红外比值计算，那是另一套算法。

5. 实测与参数调优：让读数稳定下来

5.1 如何用串口绘图仪看波形

Arduino IDE自带“串口绘图仪”（Serial Plotter），可以非常直观地看IR波形。烧录上面代码后，点击“工具 -> 串口绘图仪”，波特率选115200，就能看到一条上下波动的曲线。

正常现象是：手指静止放在传感器上时，曲线呈规律的波浪状，波谷对应一次心跳。如果曲线几乎是一条直线，说明没检测到有效脉搏，可能是手指没盖住传感器窗口，或者按压力度不对。如果曲线疯狂抖动，可能是手指不稳、环境光太强或LED亮度不够。

我建议先把原始IR波形调到“肉眼看上去循环规律”，再进行BPM计算。波形不好看的时候调算法参数没意义，物理层先搞定。

5.2 佩戴和按压的细节

很多人第一次用MAX30102，会不自觉地用力按压传感器，心想按得越紧信号越清楚。实际恰恰相反，压太紧会把毛细血管压扁，血流被阻断，反而导致信号消失。最佳状态是手指肚轻轻盖住传感器窗口，既能遮光，又没有明显压迫感。

另外，传感器窗口那一圈凸起如果和手指皮肤接触不好，也会有影响。我的经验是手指以大约45度角斜放，让指尖最饱满的肉垫正好覆盖窗口中心，耐心等一两秒让波形稳定下来，不要频繁移动手指。如果你做的是可穿戴原型，想固定在手腕或手臂上，一定要考虑运动伪影问题，静态测量比动态测量简单得多，新手先别急着追求运动中测心率。

5.3 调优方向：LED亮度、滤波、滑动窗口

如果你发现IR值整体很低（比如只有几百），波形幅度也小，可以把setPulseAmplitudeIR的数值调大，比如从0x1F6调到0x2FF，增强LED亮度。同样，如果波形幅度太大，接近饱和，可以适当调小。

如果BPM跳动很大，先看平均窗口大小。我把RATE_SIZE设为4，是比较折中的方案。设成1就完全没有平滑效果，设成10会太平滑，对于心率变化反应滞后。心率本来就是慢变量，平滑大一点也没关系，但作为教学项目，4更合适。

还有一个容易被忽略的点：delay(10)决定了主循环的采样节流。MAX30102硬件采样率已经设为200Hz，但如果你在loop里加上串口打印和数据处理，整体循环周期可能超过10ms。串口打印开销不小，建议调试阶段才开启完整打印，产品化阶段可以降低打印频率。

6. 踩坑记录：零基础最容易翻车的几个环节

6.1 排查速查表

我把常见问题整理成一张表，方便快速定位：

6.2 三个最隐蔽的坑

第一个坑是“模块发热”。MAX30102本身功耗不高，但如果你用的是不带电平转换的裸模块，VIN接到了5V，板载稳压电路会持续发热，时间长了传感器窗口会发烫，影响数据稳定性。所以不管什么教程说什么“5V也能用”，我始终建议接3.3V。

第二个坑是“传感器窗口旁边的玻璃盖板”。很多MAX30102模块出厂带一层保护膜，用来保护光学窗口。如果你一直贴着保护膜测，可能会觉得信号怎么都调不好。揭掉那层膜，信号立刻稳定。这个细节很多教程不会提，但确实会影响贴敷效果。

第三个坑是“手指静电”。尤其在干燥季节，皮肤与模块摩擦可能产生静电放电，虽然不至于马上坏，但我有一块模块就是这么“莫名其妙”坏掉的。后来我养成习惯，拿模块前先摸一下金属水龙头放掉静电，电路板尽量不要触碰传感器窗口区域。

6.3 关于电源和干扰的提醒

ESP32在开启Wi-Fi时瞬态电流很大，会造成电源电压小幅跌落。如果传感器和ESP32共用一根供电线路，IR数值可能在Wi-Fi连接瞬间出现突变。我实测在Wi-Fi广播密集的环境下，波形偶尔会出现毛刺。

解决思路有两个：一是给传感器供电加一个10uF左右的滤波电容；二是主循环里避开Wi-Fi事件处理，或者把传感器读数放到一个独立任务里。对入门项目来说，先用USB供电并保持Wi-Fi关闭状态调试即可，等后期接入物联网再考虑电源设计。

7. 下一步扩展：从心率到可穿戴原型

7.1 加一块OLED屏做本地显示

项目一旦跑通，下一步最自然的就是加显示。推荐0.91寸或0.96寸OLED，I2C接口，直接并联在同一个I2C总线上。注意MAX30102地址是0x57，OLED常见地址是0x3C或0x3D，两者不冲突，可以共用SCL/SDA。

接线是OLED的VCC接3.3V，GND接GND，SCL接GPIO22，SDA接GPIO21。程序里初始化两个设备后，在心率更新时把beatAvg用display.setTextSize等方式绘制到屏幕上。需要注意的是，OLED刷新不宜太频繁，否则会有闪烁感。我一般每200ms刷一次BPM数字就够用了。

7.2 接入Wi-Fi上报数据

ESP32的Wi-Fi是它的招牌。你可以把心率数据通过HTTP POST或者MQTT上报到服务器或手机App，做一个简易的远程心率监测装置。实际上，我在自己的项目里就是通过HTTP请求把BPM值发到一个局域网部署的接口，手机端用浏览器就能看实时数据。

这里有一个建议：Wi-Fi连接尽量放在setup里完成，不要在每次循环里都执行连接操作。如果Wi-Fi断开，用定时重连策略，比如每10秒检查一次连接状态，而不是每个循环都尝试重连，否则会影响传感器采样的实时性。

7.3 低功耗与更多传感器组合

MAX30102的LED是耗电大户，如果你想做纽扣电池供电的便携设备，需要开启传感器的低功耗模式，控制LED的采样占空比，让ESP32进入深度睡眠，定时醒来采集一次数据。这块涉及的内容比较多，我后续准备单独写一篇低功耗心率腕带的实现。

另外，把MAX30102和DHT11温湿度传感器、MPU6050六轴传感器组合在一起，就能在监测心率的同时获取体温、姿态、运动状态数据。做老年健康看护或者睡眠监测原型时，这种组合非常实用。整套系统依旧用Arduino生态开发，扩展门槛并不高。

写到最后，说一个我的真实体会：MAX30102这个传感器并不复杂，但它特别考验“物理接触”的细心程度。很多时候你以为是代码问题、算法问题，结果只是手指没放稳，或者模块贴了保护膜。所以做这类项目，我的习惯永远是先把原始波形看清，再谈滤波和数值计算。只要波形稳定了，BPM自然就准了。

如果你也照着做完，第一次看到稳定的BPM数字在串口里跳动，那种感觉还是很爽的。这套硬件链路搭起来以后，后面换OLED、上MQTT、做低功耗，都是水到渠成的事情。祝玩得开心。