
想在 Arduino 上做个能显示心跳数的小玩意,MAX30102 大概是绕不开的一颗芯片。它把红光 LED、红外 LED 和光电接收器都塞进一个指甲盖大的模块里,I2C 两根线就能通信,十几块钱一个,手环上测心率用的就是同一路数。最近我把 Last Minute Engineer 那份经典教程从头到尾捋了一遍,接线、装库、跑代码这条线不复杂,但有几个新手特别容易卡住的地方,这篇就按"你照着做会经过什么"的顺序把它们标出来。
先搞懂它怎么"看见"你的心跳
MAX30102 用的是光电容积脉搏波,英文缩写 PPG。说人话就是:往你的指尖打光,血液里的血红蛋白会吸光,心脏每泵一次血,指尖毛细血管里的血量就涨一下,吸的光也跟着多一下。模块里的接收器把反射回来的光记下来,这条随心跳起伏的曲线,就是你的脉搏波。
模块里有两颗 LED:红光 660 纳米,红外 880 纳米。带氧血红蛋白吸红外多一些,缺氧血红蛋白吸红光多一些,比较两个波长的吸收比例,就能算出血氧饱和度,健康人一般在 95% 到 100% 之间。只看红外一路的起伏,数峰值间隔,就是心率 BPM。芯片自身功耗很低,测量时约 600 微安,待机 0.7 微安,I2C 地址固定,写 0xAE 读 0xAF,不用你操心地址跳线。

先泼盆冷水:这是给做项目玩的,不是医疗器械。手指动一下、压歪一点,读数就飘,别拿它替代血氧仪做健康判断,教程里也是这么强调的。
接线:其实就四根线的事
最常见的 GY-MAX30102 小板有 5 到 7 个引脚,核心是这四根:
- VIN 接 3.3V 或 5V。芯片内核要 1.8V、LED 要 3.3V,板载稳压器自己搞定,VIN 官方标称范围 3.3V 到 5.5V,接 Uno 直接挂 5V 没问题。
- GND 接 GND,一根都不能省。
- SDA 接 A4,SCL 接 A5。Uno 和 Nano 的 I2C 就是这两个口,接反了传感器初始化必然失败。
- INT 是中断脚,平时拉高,有中断事件才拉低,新手阶段可以不接。

有些板上还有标着 IRD 和 RD 的引脚,那是内部 LED 的接地端,已经接到 GND 了,悬空就行,别手贱往 5V 上怼。另外板背面有个焊接跳线,默认选 3.3V 逻辑,接 ESP32 这类 3.3V 主控不用动它;跳线区域图上画得很清楚,改之前先看清丝印。
装库:认准 SparkFun MAX3010x
打开 Arduino IDE 的库管理器,搜 MAX3010x,装 SparkFun Electronics 出品的"SparkFun MAX3010x Pulse and Proximity Sensor Library"。虽然芯片叫 MAX30102,库叫 MAX3010x,因为它兼容 30102、30105 这一家族,装这个就对了。
装完先跑库自带的 Example1_Basics 确认硬件活着,再往下一步,能少走很多弯路。唯一要注意的是:站点正文里尖括号头文件会被吃掉,所以下文代码里 #include 统一写成双引号形式,在 Arduino 里两种写法对库搜索路径是等价的,直接复制能编译。
第一段代码:把红光和红外的原始值读出来
下面这段照原教程机械搬运,作用是初始化传感器,然后把红光和红外两路原始 ADC 值打到串口:
#include "Wire.h"
#include "MAX30105.h"
MAX30105 particleSensor;
void setup() {
Serial.begin(9600);
// Initialize sensor
if (particleSensor.begin() == false) {
Serial.println("MAX30102 was not found. Please check wiring/power.");
while (1)
;
}
particleSensor.setup(); //Configure sensor. Use 6.4mA for LED drive
}
void loop() {
Serial.print(" R[");
Serial.print(particleSensor.getRed());
Serial.print("] IR[");
Serial.print(particleSensor.getIR());
Serial.println("]");
}
烧进去,打开串口监视器,手指按上去,R 和 IR 的数值会明显往下掉——因为组织吸了光,反射回来的光变少了。IR 值低于 50000,代码层面就默认"没检测到手指"。把 loop 换成下面这样,再用 IDE 自带的串口绘图器看波形,脉搏波会直接画出来,比盯数字直观得多:
void loop() {
Serial.print(particleSensor.getRed());
Serial.print(", ");
Serial.println(particleSensor.getIR());
}
如果串口一直打印 "MAX30102 was not found",九成是 SDA/SCL 接反,或者 VIN 没供上电,先查线再怀疑库。
正经测心率:BPM 读数
确认波形有了,再上测心率的完整程序。原理是逐个采样红外值,checkForBeat() 检测到一次心跳就用两次心跳的时间差算出瞬时 BPM,再取最近 4 次的平均,让数字不那么上蹿下跳:
#include "Wire.h"
#include "MAX30105.h"
#include "heartRate.h"
MAX30105 particleSensor;
const byte RATE_SIZE = 4; //Increase this for more averaging. 4 is good.
byte rates[RATE_SIZE]; //Array of heart rates
byte rateSpot = 0;
long lastBeat = 0; //Time at which the last beat occurred
float beatsPerMinute;
int beatAvg;
void setup() {
Serial.begin(9600);
Serial.println("Initializing...");
// Initialize sensor
if (!particleSensor.begin(Wire, I2C_SPEED_FAST)) {
Serial.println("MAX30102 was not found. Please check wiring/power. ");
while (1)
;
}
Serial.println("Place your index finger on the sensor with steady pressure.");
particleSensor.setup(); //Configure sensor with default settings
particleSensor.setPulseAmplitudeRed(0x0A); //Turn Red LED to low to indicate sensor is running
particleSensor.setPulseAmplitudeGreen(0); //Turn off Green LED
}
void loop() {
long irValue = particleSensor.getIR();
if (checkForBeat(irValue) == true) {
//We sensed a beat!
long delta = millis() - lastBeat;
lastBeat = millis();
beatsPerMinute = 60 / (delta / 1000.0);
if (beatsPerMinute < 255 && beatsPerMinute > 20) {
rates[rateSpot++] = (byte)beatsPerMinute; //Store this reading in the array
rateSpot %= RATE_SIZE; //Wrap variable
//Take average of readings
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 BPM=");
Serial.print(beatAvg);
if (irValue < 50000)
Serial.print(" No finger?");
Serial.println();
}串口监视器会每行输出 IR 原始值、瞬时 BPM 和平均 BPM,手指拿开时还会提示 "No finger?"。刚开机时数字可能飘得离谱,等手指稳按几秒、平均值收敛了再当真,教程原话也是"拿稳了再看数"。
手指怎么放,决定你读出来的是心跳还是噪声
这个模块八成的"翻车"都出在手指姿势上。按太重,指腹血管被压瘪了,血都被挤走了,波形直接躺平;按太轻,环境光从缝隙钻进来,噪声盖过脉搏。原教程给的诀窍是找"捏着一枚硬币的力度",指腹盖住传感窗口、不透光又不发麻。
- 测之前静坐几秒,别一边走路一边测,运动伪影会让 BPM 飞上天。
- 手指抖的,拿橡皮筋把手指绑在传感器上,比胶带方便。
- 指尖实在不行,换耳垂、下唇这些皮薄血多的位置试试。
- 避开阳光直射的窗台测,模块有环境光取消中断,就是为这种情况准备的。
新手最容易踩的几个坑
第一,别看 INT 不接也能跑,做正式项目时它是好东西:新数据就绪、FIFO 快满、环境光过强都会通过它通知主控,省得你轮询。FIFO 芯片内置 32 组缓存,主控忙别的也不丢样本。
第二,波形毛刺多,先做软件滤波再谈算法:库里的 sampleAverage 参数默认做 4 点平均,还能调到 8 或 16,配合固定手指姿势,大多数抖动都能压下去。想算血氧,教程里有配套的 SpO2 算法示例,但注意 Uno 的 SRAM 不够存 100 个 32 位样本,那段代码已经做了 16 位截断,在 Uno 上照搬即可,别自己改大缓冲。
第三,GY-MAX30102 这类小板和 SparkFun 官方板的丝印不完全一样,接线前先核对自己板上的 VIN/GND/SDA/SCL/INT 五个丝印再下手,尤其是某些板把 SCL 印成 SCK,别接到串口的 TX 上去。
总的来说,MAX30102 是那种"接线十分钟、调姿势半小时"的模块,代码全是现成的,功夫都在手感和滤波上。照着这份教程跑通第一版之后,接个 OLED 屏把 BPM 显示出来,就是一个小桌面心率计,作为新手第一个能给别人"演示"的项目,成就感挺足。











这个模块我之前也买过两个,坑确实主要在手指姿势上。按重了波形直接躺平那段太真实了,我当时以为买到坏件,差点退货。后来发现橡皮筋把手指绑在传感器上这条是关键,波形立刻稳了。另外补充一句:ESP32 上跑的话记得 Vin 接 3.3V,而且这个库在 ESP32 上要自己指定 I2C 引脚,begin(Wire, I2C_SPEED_FAST, I2C_SCL, I2C_SDA) 传自定义脚位,不然默认脚位找不到传感器。
A4/A5 别接反这条很实在,我第一次玩 I2C 就是 SDA SCL 对调,查了一晚上。
IR
编译文讲得挺细,连 Uno SRAM 不够要 16 位截断都提到了,比一堆只贴代码的教程强。