STM32+MAX30102+DS18B20+OLED体征监测系统源码解析

简介这套源代码是一份基于STM32单片机的智能健康监测手环毕业设计/课程设计项目集成MAX30102心率血氧传感器、DS18B20温度传感器与OLED屏幕可采集心率、血氧和体温数据并实时显示同时通过串口发送到电脑端调试助手适合嵌入式方向学生参考或在此基础上扩展二次开发。资源包为RAR压缩格式共254个文件、约7.05MB主要包含C源码、H头文件、Keil工程文件.uvprojx/.uvoptx以及编译生成的.o、.axf、.map等目标与调试文件工程结构清晰可在Keil中直接打开和重新编译。代码涵盖传感器驱动、外设初始化、OLED显示与串口通信模块能帮助理解STM32从数据采集、处理到传输的完整流程项目也便于按需求增加蓝牙、上位机等功能作为毕业设计或课程设计的基础平台较为合适。目前已有1314人学习是一份实用性与可扩展性兼备的健康监测参考项目。1. 一屏看全的体征监测这套源代码解决什么问题把 STM32、MAX30102、DS18B20、OLED 这四样凑在一起最常见的落地场景是做一个桌面小护士手指往 MAX30102 上一搭OLED 上同时出现心率、血氧饱和度、体温三个数。很多基于 STM32 的毕业设计选的就是这套组合因为它把 I2C、单总线、显示驱动、信号处理一次全练到硬件成本也压得住。拿到这类源代码包的人多数不是冲着某一个算法去的而是想要一条能直接跑通的路径知道怎么初始化传感器、怎么把原始数据变成能看的数字、怎么让显示不拖后腿。这篇文章就沿着烧录前的核对、三路传感器的读写、数据融合和排错往下讲。适合正在做课设、准备电赛作品或者第一次把多传感器项目拼起来的读者。2. 为什么都是这三颗料传感器原理与选型理由不少人在拿到这套源码时会先问一句MAX30102 和 DS18B20 能不能换更便宜的能换但换了以后代码里一半的功夫就白费了。这套组合的价值在于每颗传感器都代表一种典型的嵌入式通信方式MAX30102 走 I2CDS18B20 走单总线OLED 屏也是 I2C少数是 SPI一个工程里同时出现两条总线、两种时序这才是题目真正想练的东西。2.1 MAX30102I2C 访问的光电容积脉搏波黑匣子MAX30102 的封装很小内部把红光 LED、红外 LED、光电二极管和 18 位 ADC 全塞在一起外部只需要很少的被动器件就能工作。它采集的是 PPG 信号血液搏动时手指内血容量周期性变化对光的吸收也跟着变光电二极管把透过手指的光转换成电流ADC 再量化成数值。红光波长约 660nm红外约 880nm血氧饱和度靠这两路光的吸收差来推算心率则从任意一路信号的周期性波动里提取。从代码角度看这颗传感器是个典型的 I2C 从设备7 位地址 0x57写地址 0xAE、读地址 0xAF。寄存器不多但有几个必须搞清楚模式配置寄存器 0x09 要写成 0x03 才同时开启心率和血氧测量SpO2 配置寄存器 0x0A 控制 LED 脉宽和采样率常见写成 0x27 表示 411\mu s 脉宽、100Hz 采样率LED 电流寄存器 0x0C 和 0x0D 决定红光和红外的发射强度写在 0x40 附近通常能拿到比较明显的脉搏波。数据不是直接读某个寄存器就完事的它先落到内部 FIFO再通过 0x04 到 0x07 这几个 FIFO 数据寄存器依次读出来。这颗传感器像黑匣子的地方在于它给你的只是 ADC 数不是现成的心率和血氧。能不能算出正确数字取决于你手指按得实不实、LED 电流调没调对、FIFO 有没有读空。很多人烧完代码看到屏幕上心率不是 60 多而是 140第一反应是算法坏了其实多半是原始信号里根本没有干净的脉搏波。2.2 DS18B20一根线的测温时序课DS18B20 走的是单总线1-Wire数据线和供电可以共用一根线再加上一根地就够跑了。但省线的代价是时序要求严格所有读写都靠主机在总线上制造特定宽度的低电平脉冲从机用不同的响应时间来区分 0 和 1。代码里最常见的是 GPIO 模拟时序因为 STM32 没有原生单总线外设HAL 库也不管这件事。整个读温度过程分三段复位、发 ROM 命令、发功能命令。复位时主机拉低总线 480\mu s 以上然后释放从机会在 60 到 240\mu s 后把总线拉低给出存在脉冲接下来写 0xCC 跳过 ROM 匹配只挂一颗传感器时用写 0x44 启动温度转换再等一段时间最后重新复位写 0xBE 读暂存器连续读两个字节得到温度原始值。温度分辨率默认 12 位转换时间最长 750ms这个等待时间是很多人没耐心等的但跳过它读到的永远是上次的结果。如果工程里挂了不止一颗 DS18B200xCC 就行不通了得先发 0x33 读每颗传感器的 64 位 ROM 序列号再通过 0x55 匹配指定那颗。题目里既然只打包了一颗那 0xCC 就是够用的路径。DS18B20 的实物长得很像三极管封装上印着型号没有字的那面是背面引脚顺序别记反经常有人把电源和地焊反一上电传感器直接发热报废。时序实现要靠微秒级延时。标准库时代大家都用 SysTick 或者空循环数数HAL 库下建议用 DWT 或者定时器做延时因为空循环在不同主频和优化等级下误差很大。很多翻车现场不是逻辑错是延时不准复位总线的低电平只拉了 200\mu s感应不到存在脉冲read 到的全是 0xFF。2.3 OLED 和主控显示刷新与采集调度的关系0.96 寸 128x64 的 OLED驱动芯片几乎都是 SSD1306接口最常见是 I2C地址 0x3C 或 0x3D。它内部自带一块 1KB 的 GDDRAM你要显示什么就是往这块显存里写字节。写进去之后屏自己刷新MCU 不用管保持显示这件事。这意味着刷屏的代价全部花在 I2C 传输上全屏更新一次要传 8 页 x 128 列差不多 1KB 数据在 400kHz 的 I2C 下大约 20ms 上下听起来不多但如果每 100ms 刷一次全屏I2C 总线就快被占满了MAX30102 的 FIFO 读取会被反复延后。常见做法是用局部刷新哪块区域的数据变了就只改那块。比如心率和血氧数字每秒变一次那就每秒只更新对应坐标上的数字温度和显示字样基本不变只在变化时重画。标题里的显示器是 OLED很多人会顺带研究 HAL 库驱动 OLED 代码里面最核心的不是画点函数而是初始化命令序列和坐标到显存地址的换算。SSD1306 的显存按 8 像素一页组织y 坐标要除以 8 得出页地址再用较低位决定字节内位置这个换算错一格显示的就是乱码或者错位。主控选型上F103C8T6 是这套方案最常见的选择因为 64KB Flash 够放下 HAL 库、两个传感器的驱动和显示字库20KB RAM 也够开采样数组。C8T6 没有硬件 I2C 的坑多数人早就绕开了直接 GPIO 模拟 I2C 做 OLED 反而更省心。时钟树配置上一般用外部 8MHz 晶振倍频到 72MHz 给内核I2C 外设时钟从 APB1 来。如果用的是国产替代芯片引脚兼容但 Flash 容量可能不同烧录前要在 Keil5 里确认芯片型号和包版本免得代码里地址越界。3. 把源码包跑成实物工程结构、初始化与最小可运行步骤源码包拿到手第一步不是打开 main.c 从头读而是先把工程结构和引脚映射核对清楚。这类多传感器项目最怕的就是引脚对不上代码写得再漂亮PB6 和 PB7 接错了线屏幕上就永远是白板一块。3.1 拿到项目先核对这三处别急着烧录先看工程结构。一个典型的 STM32 工程不管是标准库还是 HAL 库通常长这样Project/ ├── Core/ │ ├── Inc/ │ │ ├── main.h │ │ ├── max30102.h │ │ ├── ds18b20.h │ │ └── oled.h │ └── Src/ │ ├── main.c │ ├── max30102.c │ ├── ds18b20.c │ └── oled.c ├── Drivers/ │ └── STM32F1xx_HAL_Driver/ ├── MDK-ARM/ │ └── Project.uvprojx └── ioc/ └── Project.ioc拿到后第一件事打开 .ioc 文件如果是 CubeMX 工程或者直接看 GPIO 初始化代码确认三个传感器的引脚分配。常见分配是MAX30102 连在 I2C1 的 PB6/PB7OLED 也用 I2C1 或者用软件 I2C 挂在别的 IO 上DS18B20 单独占一个 GPIO比如 PA0。第二件事确认 Keil5 里的芯片型号和宏定义。F103 系列要检查 STM32F10X_HD 还是 STM32F10X_MD标准库工程经常因为宏不对导致编译报错或者外设时钟打不开。芯片包没装的话在 Keil5 的 Pack Installer 里按芯片型号补装不然打开工程会提示 Device 不存在。第三件事看延时函数用的什么实现。HAL 库工程里如果直接用 HAL_Delay(1) 来做微秒级延时那是一定翻车的因为 HAL_Delay 的最小粒度是 1ms。正常源码包里会自己写 delay_us要么用 SysTick要么用 DWT。没有这个函数的话后边 DS18B20 的时序怎么调都没用。这块花五分钟核对比烧录后对着逻辑分析仪猜半天省事得多。3.2 MAX30102 初始化与 FIFO 读取代码MAX30102 的驱动核心就两个动作写寄存器初始化读 FIFO 拿原始数据。用 HAL 库写 I2C 发送接收代码很直接#define MAX30102_ADDR_W 0xAE #define MAX30102_ADDR_R 0xAF #define MAX30102_REG_FIFO_DATA 0x05 static int32_t max30102_write_reg(uint8_t reg, uint8_t val) { uint8_t buf[2]; buf[0] reg; buf[1] val; return HAL_I2C_Master_Transmit(hi2c1, MAX30102_ADDR_W, buf, 2, 100); } static int32_t max30102_read_fifo(uint8_t *buf, uint8_t len) { return HAL_I2C_Mem_Read(hi2c1, MAX30102_ADDR_R, MAX30102_REG_FIFO_DATA, I2C_MEMADD_SIZE_8BIT, buf, len, 100); }初始化序列放在 max30102_init 里常见顺序是先关中断、写模式寄存器、写 SpO2 配置、设置 LED 电流、清 FIFO最后再开中断void max30102_init(void) { max30102_write_reg(0x02, 0x40); // 中断使能寄存器只开 FIFO 几乎满中断 max30102_write_reg(0x01, 0x00); // 关所有中断标志 max30102_write_reg(0x09, 0x03); // 模式心率 血氧同时测 max30102_write_reg(0x0A, 0x27); // SpO2 配置100Hz 采样411us 脉宽 max30102_write_reg(0x0C, 0x40); // 红光 LED 电流约 8mA 量级 max30102_write_reg(0x0D, 0x40); // 红外 LED 电流 max30102_write_reg(0x0E, 0x01); // 禁止多点采样单点模式 max30102_write_reg(0x04, 0x00); // FIFO 写指针归零 max30102_write_reg(0x05, 0x00); // FIFO 读指针归零 max30102_write_reg(0x06, 0x00); // FIFO 溢出计数器清零 }说明一下几个关键参数。0x09 写成 0x03 是双 LED 模式如果只测心率可以写 0x02这样红外 LED 不工作省一点电流。0x0A 的低三位是采样率控制0x27 对应 100Hz这个频率对脉搏波足够了不必开满 400Hz否则 FIFO 很快堆满主循环一卡就读溢出。LED 电流寄存器 0x40 不是绝对数值它由两个字段拼成高 5 位是电流档位低 3 位是微调0x40 表示约 8mA 附近。实际按手指肤色和遮挡程度可以整体往上调但别超过 0x7F太亮会饱和波形顶部削平算法反而算不准。FIFO 读取时每次读几个字节有讲究。MAX30102 的每个样本是 6 字节先是红光三字节再是红外三字节每路取低 18 位有效。典型做法是一次读 6 个字节组一个样本或者一次读 30 字节拿 5 个样本。代码里要注意的是FIFO 数据寄存器是 0x05寄存器 0x04 是写指针有人把读地址写成 0x04会把指针值当数据读出来那波形自然是乱的。3.3 DS18B20 的读时序与温度换算DS18B20 驱动是这套代码里最考验延时的地方。用 GPIO 模拟时先把引脚配置成开漏输出并外接 4.7k 上拉或者直接在代码里切换输入输出模式。一个常见的读温度函数骨架如下uint8_t ds18b20_reset(void) { uint8_t presence 1; DS18B20_GPIO_MODE_OUTPUT(); DS18B20_PIN_LOW(); delay_us(500); // 主机拉低至少 480us DS18B20_PIN_HIGH(); DS18B20_GPIO_MODE_INPUT(); delay_us(70); // 等从机响应窗口 presence DS18B20_PIN_READ(); delay_us(410); // 补齐存在脉冲后的时间 return presence; // 返回 0 表示检测到设备 } uint8_t ds18b20_read_byte(void) { uint8_t val 0; for (int i 0; i 8; i) { val 1; DS18B20_GPIO_MODE_OUTPUT(); DS18B20_PIN_LOW(); delay_us(2); DS18B20_PIN_HIGH(); DS18B20_GPIO_MODE_INPUT(); delay_us(10); if (DS18B20_PIN_READ()) { val | 0x80; } delay_us(50); } return val; } float ds18b20_get_temp(void) { uint8_t lsb, msb; int16_t raw; if (ds18b20_reset()) { return 85.0f; // 复位失败返回一个明显异常的值 } ds18b20_write_byte(0xCC); // 跳过 ROM ds18b20_write_byte(0x44); // 启动温度转换 while (!ds18b20_read_bit()); // 等待高温就绪信号最多约 750ms ds18b20_reset(); ds18b20_write_byte(0xCC); ds18b20_write_byte(0xBE); // 读暂存器 lsb ds18b20_read_byte(); msb ds18b20_read_byte(); raw (int16_t)((msb 8) | lsb); return raw * 0.0625f; // 12 位分辨率每一位代表 0.0625 度 }这里有个容易踩的细节温度转换结束后DS18B20 会把总线拉低表示转换完成所以读转换状态用的是读一位而不是固定 delay 750ms。写成固定 delay 也能用但要浪费 750ms而且主线在等FIFO 数据会越堆越多。用读一位的方式常规温度下转换时间大约是 100 到 200ms速度上来不少。原始温度值是有符号数负温度下 lsb 和 msb 拼成的 16 位值直接用 int16_t 接收再乘 0.0625 就行不需要额外处理补码。延时函数建议直接用 DWT 实现因为 SysTick 在 HAL 库下已经被 HAL_Delay 占用了。主频 72MHz 时DWT 的 CYCCNT 每计数一次是 1/72 微秒用两个时刻的差值就能算准微秒延时不会受中断影响这是单总线时序最省心的量法。3.4 OLED 显示配置命令HAL 库驱动与界面布局OLED 这部分有两种写法硬件 I2C 用 HAL 库软件 I2C 用 GPIO 模拟。用 HAL 库驱动 OLED 代码时核心是初始化命令序列和写显存两个函数static void oled_write_cmd(uint8_t cmd) { uint8_t buf[2] {0x00, cmd}; // 控制字节 0x00 表示后续是命令 HAL_I2C_Master_Transmit(hi2c1, 0x3C 1, buf, 2, 100); } static void oled_write_data(uint8_t data) { uint8_t buf[2] {0x40, data}; // 控制字节 0x40 表示后续是数据 HAL_I2C_Master_Transmit(hi2c1, 0x3C 1, buf, 2, 100); } void oled_init(void) { oled_write_cmd(0xAE); // 关闭显示 oled_write_cmd(0x20); // 设置内存寻址模式 oled_write_cmd(0x00); // 水平寻址模式坐标递增最直观 oled_write_cmd(0xC0); // 扫描方向从左上角开始 oled_write_cmd(0x8D); // 电荷泵设置 oled_write_cmd(0x14); // 开启电荷泵这一步漏了屏会不亮 oled_write_cmd(0xAF); // 打开显示 oled_clear(); }初始化命令里最容易被漏掉的是 0x8D 和 0x14 这对电荷泵命令。SSD1306 内部升压电路不开启时即使电源供电正常屏幕也是一片黑。另外 0x20 之后必须跟一个参数指定寻址模式有人说「我初始化没写这条也能显示」那是因为模块默认值恰好是水平寻址但不写总归是隐患。写数据时控制字节是 0x40和命令的 0x00 不一样。很多人因为只改了命令没改数据段写显存变成了写命令结果屏幕花得一塌糊涂。显存写入要先把列地址和页地址设置到位再连续写入字节。128x64 的屏分 8 页每页 128 字节页地址寄存器 0xB0 到 0xB7列地址低四位由 0x00 到 0x0F 指定高四位由 0x10 到 0x1F 指定。写一个中文字模就是把这个字对应的 16x16 像素点拆成 4 页写入坐标换算有一行算错就整体偏移。界面布局上一行放一个数据比较合适比如第一行写 HR第二行写 SpO2第三行写 Temp第四行留空或者放个小状态。每秒刷新一次数值就好不要每 100ms 重画一次OLED 虽然响应快但 I2C 带宽和 MCU 时间都耗不起。4. 三路数据合成一屏采样、滤波、心率血氧算法与刷新节奏传感器驱动通了屏幕上开始出数但这只是第一步。MAX30102 读出来的是波动值DS18B20 读出来的是 0.0625 度的原始温度OLED 要显示的是人能一眼看懂的心率、血氧、体温。中间这一步换算和滤波决定了这套源代码是好用还是只能演示。4.1 心率与血氧的数据换算逻辑心率的最常见算法是时域峰值检测从红外信号里找脉搏波的波峰两个相邻波峰的时间间隔就是一个心动周期60 除以这个间隔就是每分钟心跳数。工程上不会直接数波峰而是先维护一个滑动窗口窗内数据做基线漂移消除再用阈值和最小间距双重筛选峰避免把噪声当心跳。#define PPG_WINDOW 200 // 200 个样本100Hz 采样下对应 2 秒 static uint32_t ir_buf[PPG_WINDOW]; static uint32_t red_buf[PPG_WINDOW]; static int16_t find_peaks_and_calc_hr(uint32_t *buf, uint32_t len) { int32_t baseline 0; for (uint32_t i 0; i len; i) { baseline buf[i]; } baseline / len; // 滑动窗口均值当作基线 int16_t peaks 0; uint16_t last_peak 0; uint16_t min_interval (uint16_t)(100 * 60 / 200); // 心率上限 200BPM 对应的最小间隔 for (uint32_t i 2; i len - 2; i) { if (buf[i] (uint32_t)(baseline * 1.1f)) { // 左右各比 5 个点高才算一个峰 if (buf[i] buf[i-1] buf[i] buf[i-2] buf[i] buf[i1] buf[i] buf[i2]) { if (peaks 0 || (i - last_peak) min_interval) { peaks; last_peak i; } } } } return peaks; } static float calc_spo2(uint32_t *red, uint32_t *ir, uint32_t len) { int32_t ac_r 0, dc_r 0, ac_i 0, dc_i 0; for (uint32_t i 0; i len; i) { dc_r red[i]; dc_i ir[i]; } dc_r / len; dc_i / len; for (uint32_t i 0; i len; i) { ac_r abs((int32_t)red[i] - dc_r); ac_i abs((int32_t)ir[i] - dc_i); } ac_r / len; ac_i / len; if (ac_i 0 || dc_r 0 || dc_i 0) { return 97.0f; // 数据异常时给一个保守值 } float r ((float)ac_r / dc_r) / ((float)ac_i / dc_i); float spo2 110.0f - 25.0f * r; // 经验公式只适合工程演示 if (spo2 100.0f) spo2 100.0f; if (spo2 70.0f) spo2 70.0f; return spo2; }说明一下上面这段的关键参数。窗口长度 200 对应 2 秒数据心率 60 时一个周期约 60 个样本2 秒内能抓到两个峰够算一次窗口太短峰数不够太长则心率变化被平均掉反应迟钝。min_interval 这里限制最大心率 200BPM如果被测者心率真超过这个值会被漏掉但对普通场景足够还能干掉大量抖动噪声。峰检测用左右各两个点做局部最大这比单一阈值可靠得多。血氧公式用的是行业里最常见的经验式先算 AC 和 DC 比值 R再套一次性拟合公式。这个公式在中低血氧段误差不小医用级不可能这么干但作为课设和便携设备演示完全够。代码里对 R 做除零保护是必要的因为手指拿开瞬间 ADC 值会掉到很低不保护直接除零程序就飞了。4.2 采样窗口和显示刷新率怎么搭配MAX30102 在 100Hz 采样率下每秒往 FIFO 里塞 100 组六字节。如果主循环每 10ms 读一次 FIFO一次读 6 个样本绰绰有余。但 OLED 刷屏如果占了 20ms这轮循环就把 FIFO 读晚了下轮读的时候 FIFO 已经堆了几十组。堆太多不是不行只是延迟变大数据显示滞后半秒手一抖波形全糊。我一般把主循环拆成两段节奏高频段每 10ms 读一次 FIFO把样本塞进环形缓冲区低频段每 500ms 算一次心率和血氧每 1s 刷新一次 OLED。用 STM32 的定时器触发读取比主循环死等要稳比如用定时器 2 做 10ms 中断中断里只做 I2C 读和缓冲区写入主循环只做算法和显示。这样显示再慢也不影响采样连续性。缓冲区用环形结构比滑动数组省心因为读取是持续的环形缓冲区天然处理新旧数据交替#define RING_SIZE 600 // 6 秒数据足够算法窗口用 static uint32_t ring_ir[RING_SIZE]; static volatile uint16_t ring_head 0; void on_timer_10ms(void) { uint8_t raw[6]; uint32_t ir_val, red_val; if (max30102_read_fifo(raw, 6) HAL_OK) { ir_val ((uint32_t)(raw[3] 0x03) 16) | ((uint32_t)raw[4] 8) | raw[5]; red_val ((uint32_t)(raw[0] 0x03) 16) | ((uint32_t)raw[1] 8) | raw[2]; ring_ir[ring_head] ir_val; ring_red[ring_head] red_val; ring_head (ring_head 1) % RING_SIZE; } }每 10ms 读一组样本一组样本是六字节正好对应一次测量。这里把 18 位数据拼回来的方式要注意每个通道的高两位在控制的字节里所以 raw[0] 只取低两位再左移 16 位。有些人直接 raw[0] 16把状态位也拼进数据里波形会出现周期性的毛刺。FIFO 读是否成功要判返回值I2C 在总线上被 OLED 占用时可能超时不判断就继续取数拿到的可能是半截旧数据。4.3 把原始数据从串口导出来看波形OLED 上显示的是算法结果而算法有没有算对得看原始波形。很多人调心率算法时盯着 OLED 数字猜这效率太低。正确的做法是让原始数据从串口出来在电脑上画成波形再调参数。标题里如果配套代码原本就带串口打印那直接用没有的话自己加一段很简单#include stdio.h #ifdef __GNUC__ int _write(int fd, char *p, int len) // 配合 GCC 工具链的 printf 重定向 { (void)fd; return HAL_UART_Transmit(huart1, (uint8_t *)p, len, 100) HAL_OK ? len : 0; } #endif void debug_dump(uint16_t idx) { printf(%lu,%lu\r\n, ring_red[idx], ring_ir[idx]); }串口输出用 CSV 格式一列红光一列红外这样 Excel 或者 Python 脚本都能直接读。USB 虚拟串口方式也可行STM32 的 USB 虚拟串口发送数据本质上就是把 CDC 的收发缓冲区接上注意别在中断里直接 printf会卡死。打印速率不用太快每 20ms 打一行每秒 50 行波特率 115200 毫无压力。导出的数据能看到三种典型形态第一种是明显起伏的脉搏波波峰间隔均匀这种波形算法随便写都能算对第二种是平线说明手指没放好或者 LED 电流太小第三种是整体浮动的慢波那是手指压力变化带来的基线漂移算法里加一个高通滤波或者用滑动均值做基线扣除就解决了。没有串口就调不出这个问题这是所有读 MAX30102 的代码里最值得先做的事。5. 避坑指南五个必翻车的点与排查流程这套组合的翻车现场我来来回回见过太多从 OLED 花屏到温度卡在 85再到期期艾艾的心率数字基本都是几个固定原因。5.1 OLED 花屏不是屏的问题现象屏幕能亮但显示内容是乱的要么全是乱点要么字符错位有时刷几下又正常。密码门锁 OLED 屏花屏那些案例多数也是同一个病根。原因最常的是 I2C 速率过高400kHz 下 OLED 模块上的走线和上拉电容导致时序变形其次是初始化序列少了电荷泵开启命令屏幕处于欠压状态还有就是显存写入时列地址和页地址没有成对设置写了一半跳到别的页去了。解决先把 I2C 速率降到 100kHz 试一下如果花屏消失就是速率问题。初始化序列补上 0x8D 0x14 这对命令。再检查每次写显存前是否都调用了设置坐标函数SSD1306 在连续写一页后列地址会自动回绕跨页写必须重新设置地址。最后看供电OLED 和传感器共用一颗 LDO 时MAX30102 的 LED 一亮会拉低电压给 OLED 屏的 VCC 加一个 10\mu F 电容能解决大部分闪烁和花屏。5.2 MAX30102 一直读到 0xFF现象初始化不报错但读 FIFO 永远拿到 0xFFFFFF 或 0x000000换传感器也一样。原因I2C 地址写错是最典型的有人把 7 位地址 0x57 直接当 8 位地址传给 HAL 函数读写地址没左移从机地址自然对不上。第二个原因是通信引脚缺上拉STM32 的 I2C1 引脚在开漏模式下没有外部上拉电阻时总线电平拉不高传输直接失败。第三个原因是 LED 电流太小或者手指没放实传感器能初始化但采不到有效信号。解决确认 HAL_I2C_Master_Transmit 的地址参数是 0xAE8 位写地址I2C 的 Mem_Read 用 0xAF。用示波器或者逻辑分析仪看 SCL 上有没有正常的时钟没有就查上拉。手指放上去后用串口打印 LED 电流调大的原始值如果还是全零查 FIFO 写指针寄存器 0x04它一直不动就说明传感器根本没在采数重点查模式寄存器 0x09 是不是 0x03。5.3 DS18B20 显示 85℃现象OLED 温度永远是 85.0或者开机 85 过一阵变成别的大数但和实际温度明显不符。原因85℃ 是 DS18B20 上电复位后暂存器里的默认值。程序读到 85 只有一种可能就是启动转换的命令没被执行读的时候传感器还在用上电默认值。典型原因有三个复位时序不合格导致存在脉冲没被正确识别程序把复位失败当成成功了写 0x44 时写时序的时隙长度不对命令没写进去还有从机没等到转换完成就发起了读读到的还是旧暂存器。解决用逻辑分析仪抓整个单总线过程重点看是否存在脉冲。没有存在脉冲先查外接 4.7k 上拉电阻和 GPIO 模式切换确认拉低后释放时引脚真的变成了输入态。存在脉冲有了但温度还是 85就用读位函数去等转换完成信号代码里写成 while 等待比固定 delay 更直接。另外注意DS18B20 供电电压低于 3.3V 时转换时间会变长等位超时要适当放宽到 1s。5.4 心率血氧乱跳现象屏幕显示心率从 70 一下蹦到 150血氧在 92 到 99 之间反复横跳数据看着吓人。原因多数是原始信号质量差不是算法问题。手指按压位置不对、力度忽大忽小、LED 电流太大导致 PPG 波峰削顶都会让峰检测抓到假峰。还有一个常见原因是窗口太短心率低的时候 2 秒窗口里只有两三个峰稍微抖一下峰值就翻了。解决第一步先看串口波形确认原始信号是平滑的周期性波形。第二步给算法加上峰间隔限制心率 30 到 200 之间的间隔才算有效低于 30 就丢弃重算。第三步是降速把采样率从 100Hz 降到 50Hz对脉搏波完全够用还能减少 LED 发热和功耗。手指固定方式比算法更重要给 MAX30102 做个指套或者用胶带固定比整天调参数管用。5.5 I2C 总线被拉死的排查现象程序跑一会儿OLED 再也不刷新MAX30102 也读不到整个系统像是卡住复位后又正常过一段时间又死。原因HAL 库的 I2C 传输函数是阻塞的超时时间到了才返回错误。当 SCL 或 SDA 被从设备拉低时主机的传输会一直等看起来就是死机。OLED 和 MAX30102 共用一条 I2C 总线时任何一个设备的时序出错都可能把总线锁住。还有一种情况是中断里调用了 HAL_I2C_Master_Transmit和主循环的调用冲突了。解决检查是不是中断和主循环同时操作 I2C如果是把读 FIFO 的 I2C 调用放到主循环或者加互斥标志。I2C 死锁后用软件复位总线把 SCL 翻转九次让从设备释放总线这个办法治标长期看还是要查哪个设备把 SCL 或 SDA 长时间拉低。用 100kHz 低速运行这套双设备总线大多数玄学死机都能消失。6. 用逻辑分析仪和串口数据把「能亮」变成「能用」到这一步你的板子已经能显示三个数据剩下的功夫都花在「验证」而不是「新功能」上。我建议按这个顺序做一轮自测先用逻辑分析仪抓 DS18B20 的完整时序确认复位、存在脉冲、读时隙三段波形都符合手册然后用串口导出一段 10 秒的 MAX30102 原始数据自己手动数一下波峰和算法算出的心率对一下最后给 OLED 做一个渐变刷新测试连续显示 20 分钟看会不会花屏或者堆积错误。这三个验证过了这套源代码才算真正在你手上落地。进阶改动从低功耗做起性价比最高。MAX30102 的 LED 是耗电大户把采样率降到 25Hz只在需要测量时点亮 LED平时寄存器模式切到待机整机功耗能掉一大截。DS18B20 可以改成隔 5 秒才发起一次转换体温本来就不是毫秒级变化的量。OLED 则把显示内容分级空闲时只显示大字需要时才刷新次要信息。这样改完之后一块 18650 电池可以用非常久而这套代码的骨架不用动。再往后可以做数据记录。环形缓冲区里的原始值定时写入 Flash 或者 SD 卡攒一天的数据导出在电脑上画出血氧趋势线和体温曲线对睡眠监测这种方向就是现成的起点。心率算法也可以换思路从时域峰值检测换成自相关或者频域 FFT代码结构和脉率估计会更扎实。我现在拿到这类源码的习惯是先抓时序再看波形最后才动手改参数顺序错了就是玄学调参现场。这条路走通一遍再回头看 I2C 和单总线就不是黑匣子了。希望这些拆解能帮到你少走我当年绕过的弯路。本文还有配套的精品资源点击获取