心率血氧监测是健康监测、运动康复、医疗护理领域的核心功能,也是嵌入式医疗健康类项目开发的经典入门案例,更是电赛测控类题目的核心原型。市面成品便携式心率血氧仪价格从几十到数百元不等,而网上绝大多数开源方案,仅提供零散的传感器驱动代码,无PPG信号处理原理拆解、无心率血氧算法全流程讲解、无新手踩坑指导,新手不仅无法实现稳定精准的测量,甚至连传感器基础数据都无法正常读取。本项目基于STM32F103C8T6核心控制器,采用HAL库开发,基于MAX30102光电心率传感器,实现心率、血氧饱和度实时精准测量,支持数据掉电存储、超限声光报警、OLED实时显示、串口数据上报、低功耗运行等全功能,全程采用无跳步保姆式教学,零基础也能跟着完成项目复刻,是STM32 HAL库开发、医疗测控系统开发、电赛备赛实战的优质可复刻项目。
目录
- 一、项目整体介绍
- 1.1 项目背景与意义
- 1.2 项目核心功能
- 1.3 项目难度与适配说明
- 1.4 项目硬件成本说明
- 1.5 适配人群与前置知识要求
- 二、硬件选型与采购指南
- 2.1 核心控制器选型
- 2.2 完整硬件BOM清单
- 2.3 硬件采购避坑指南
- 三、硬件接线保姆式指南
- 3.1 硬件接线表
- 3.2 接线步骤分步讲解
- 3.3 接线完成自检方法
- 3.4 硬件接线避坑指南
- 四、代码全流程保姆式讲解
- 4.1 开发环境与工程创建全流程
- 4.2 代码整体架构
- 4.3 核心代码逐行讲解
- 4.4 单模块验证代码
- 4.5 完整工程主函数代码
- 4.6 代码自定义修改指南
- 五、调试排坑万能指南
- 5.1 分场景全流程排查逻辑
- 5.2 高频问题排查表
- 5.3 新手最容易踩的致命坑及解决方案
- 5.4 【博主真实踩坑实录】
- 六、功能演示与验证
- 6.1 核心功能分步测试步骤
- 6.2 功能验证标准
- 七、核心要点速记
- 八、小结
一、项目整体介绍
1.1 项目背景与意义
心率和血氧饱和度是反映人体心血管健康、呼吸循环状态的核心生理指标,无论是日常健康监测、运动健身数据追踪,还是医疗护理、高原环境监测,都离不开精准的心率血氧测量。而便携式、低功耗的心率血氧监测设备,是嵌入式医疗测控领域的典型应用,也是电赛测控类题目的高频考点,涵盖了光电传感、模拟信号处理、数字滤波、生物医学信号算法、低功耗嵌入式开发等核心技术。
网上绝大多数开源心率血氧方案,都存在严重的新手不友好问题:要么只提供MAX30102的寄存器读写代码,无核心的心率血氧解算算法,新手只能读到原始光强数据,根本算不出心率血氧值;要么算法无原理讲解、无参数注释,新手无法修改、调试,测量精度极差;要么硬件接线无详细说明,传感器光学设计、电源滤波完全不讲,新手根本无法复现测量效果。
本项目完全开源,所有硬件均为市面通用直插模块,无需复杂焊接和PCB设计,杜邦线即可完成所有接线;代码采用模块化分文件设计,带逐行注释,可直接编译运行;从传感器原理、PPG信号处理、心率血氧算法、硬件接线、CubeMX配置、代码开发、调试优化全流程无跳步拆解,新手不仅能做出一台精准可用的便携式心率血氧仪,还能彻底掌握背后的核心原理,全面提升STM32综合开发能力和测控系统设计思维,完全贴合STM32进阶学习、电赛备赛的核心需求。
1.2 项目核心功能
- 精准心率血氧测量:基于MAX30102光电心率传感器,实现心率(HR)、血氧饱和度(SpO2)实时测量,心率测量范围30-250次/分钟,测量精度±2次/分钟;血氧饱和度测量范围70%-100%,测量精度±2%,满足日常健康监测需求。
- 实时数据显示与人机交互:0.96寸OLED屏实时显示心率值、血氧值、测量状态、电池电量、历史数据等信息;3个独立按键实现测量启停、历史数据查看、阈值设置、系统校准等功能,操作简单直观。
- 超限声光报警功能:可自定义心率、血氧上下限阈值,当测量值超出阈值范围时,自动触发蜂鸣器声光报警,提醒异常状态,报警阈值可掉电保存。
- 数据存储与历史查询:基于AT24C02存储芯片,可存储100组历史测量数据,支持按键翻页查看,掉电不丢失,方便追踪健康数据变化。
- 低功耗与便携供电:支持3.7V锂电池供电,自带充电管理与低功耗模式,待机电流≤10mA,满电连续测量续航≥8小时;支持串口数据上报,可连接上位机实现数据记录、波形显示、批量导出功能。
1.3 项目难度与适配说明
- 难度等级:进阶级,基于STM32F103C8T6裸机开发,适配STM32 HAL库开发实战学习需求
- 知识覆盖范围:STM32CubeMX工程配置、GPIO输入输出、I2C/SPI/USART串口通信、ADC采集、定时器中断、MAX30102光电传感器驱动、PPG信号数字滤波、心率血氧解算算法、数据存储与掉电记忆、低功耗开发、模块化分文件编程
- 适配学习阶段:已完成STM32基础外设学习,想要进阶掌握传感器驱动、生物医学信号处理、测控系统全流程开发的嵌入式学习者;有51单片机基础,想要平滑过渡到STM32进阶项目开发的学习者;电赛备赛阶段,需要练习医疗测控类项目全流程开发、算法落地的参赛者。
- 实操落地性:所有硬件均为市面通用直插模块,杜邦线即可完成所有接线,无需复杂焊接和PCB设计,代码可直接编译运行,无跳步保姆式讲解,跟着步骤一步步操作,就能顺利完成项目复刻。
1.4 项目硬件成本说明
本项目整体参考总成本区间为50-180元,针对不同需求设置3个分级预算方案,所有元器件均为通用型号,可灵活替换:
| 预算方案 | 参考总成本 | 核心配置说明 | 适配人群 |
|---|---|---|---|
| 极简版 | ≤60元 | STM32最小系统板+MAX30102心率血氧模块+0.96寸OLED屏+2个按键 | 纯新手入门,仅实现基础心率血氧测量、实时显示功能,预算有限 |
| 推荐版 | 90-120元 | 极简版全配置+AT24C02掉电存储模块+有源蜂鸣器报警模块+3.7V锂电池+TP4056充电模块+3个功能按键 | 绝大多数学习者,实现完整的测量、报警、数据存储、便携供电全功能,兼顾性价比与实用性 |
| 进阶版 | 150-180元 | 推荐版全配置+1.3寸OLED屏+蓝牙模块+温湿度传感器+高精度LDO稳压模块+金属外壳 | 进阶开发者,想要扩展蓝牙无线数据传输、多参数监测、更高测量精度、便携外壳等功能 |
1.5 适配人群与前置知识要求
适配人群
- 有C语言基础,完成STM32基础外设学习,想要进阶传感器驱动与测控系统开发的嵌入式入门学习者
- 想要自制便携式心率血氧仪,学习生物医学信号处理的电子爱好者
- 电赛备赛阶段,需要练习测控类项目全流程开发、算法落地的参赛者
- 想要提升STM32 HAL库开发、多外设协同、模块化编程、工程化思维的嵌入式开发者
前置知识要求
【前置知识回顾】本项目核心外设的基础操作逻辑,均在我的《STM32入门保姆式教程》中有完整讲解,老粉可以直接跳过:
- GPIO推挽输出、上拉输入的配置逻辑,可回顾《STM32入门保姆式教程》第2章
- I2C与USART串口通信的底层原理与HAL库驱动方法,可回顾《STM32入门保姆式教程》第4章
- ADC采集的基础原理与HAL库驱动方法,可回顾《STM32入门保姆式教程》第3章
- 定时器中断的基础配置与使用方法,可回顾《STM32入门保姆式教程》第5章
- C语言结构体、函数封装、数组、浮点运算的基础用法,可回顾《C语言保姆式学习笔记》第6章、第8章
二、硬件选型与采购指南
2.1 核心控制器选型
本项目核心控制器选用STM32F103C8T6最小系统板,核心选型优势如下:
- 超高性价比,市面通用现货充足,参考单价仅15-25元,新手入门无成本压力
- 内置2个I2C接口、3个USART串口、2个SPI接口,可同时对接MAX30102传感器、OLED屏、AT24C02存储模块、蓝牙模块、按键等所有外设,无需扩展IO,完美适配本项目的外设需求
- 内置12位ADC,可实现电池电压精准采集,满足低功耗监测与电量显示需求;内置多个16位定时器,可实现精准的传感器采样时序控制、信号滤波与算法调度
- 72MHz系统时钟,可满足PPG信号实时采样、数字滤波、心率血氧算法运算、人机交互的实时性需求,算法运算无卡顿延迟
- 开发资料极其丰富,完全适配STM32CubeMX图形化配置工具,HAL库固件包完善,和我的《STM32入门保姆式教程》完全适配,新手可无缝衔接
- 引脚兼容同系列多款芯片,后续可无缝升级到STM32F103RCT6、GD32F103C8T6等型号,轻松扩展蓝牙通信、多参数监测、上位机波形显示等功能
和同类型号对比:相比STM32F030,外设接口更丰富,运算能力更强,完全满足实时信号处理的需求;相比STM32F407,成本仅为1/5,外设与运算能力完全满足本项目需求,无需性能过剩;相比51单片机,运算能力、外设接口、定时器资源提升数十倍,可实现复杂的数字滤波和心率血氧算法,而51单片机根本无法满足实时信号处理的要求。
2.2 完整硬件BOM清单
【合规提示】以下所有元器件仅提供型号参考,采购渠道仅可选择电商通用平台、正规元器件商城,无任何指定店铺推荐,所有单价为市面通用参考价格,实际价格以采购时为准。
| 序号 | 元器件名称 | 型号 | 数量 | 核心功能 | 参考单价(元) | 缺货替代型号 | 备注 |
|---|---|---|---|---|---|---|---|
| 1 | 核心控制器 | STM32F103C8T6最小系统板 | 1 | 项目核心控制、传感器驱动、算法运算、外设驱动、逻辑调度 | 22.0 | GD32F103C8T6、STM32F103RCT6 | 建议选择带排针焊好、CH340下载电路的版本,新手无需焊接 |
| 2 | 心率血氧传感器 | MAX30102光电心率模块 | 1 | 红光/红外光发射、光电信号采集、PPG信号输出,心率血氧测量核心 | 18.0 | MAX30100、AFE4400 | 自带光学窗口、稳压电路、I2C接口,驱动通用,新手友好 |
| 3 | 显示屏 | 0.96寸I2C OLED屏 128*64 | 1 | 心率血氧值、测量状态、电量、历史数据实时显示 | 12.0 | 1.3寸I2C OLED屏、0.91寸OLED屏 | I2C接口,接线简单,新手不易翻车 |
| 4 | 掉电存储模块 | AT24C02 I2C接口 | 1 | 测量阈值、历史数据、系统设置掉电存储 | 3.5 | AT24C04、AT24C08 | 容量完全满足数据存储需求,I2C驱动通用 |
| 5 | 声光报警模块 | 有源蜂鸣器+LED指示灯模块 | 1 | 心率血氧超限声光报警、系统状态提示 | 5.0 | 无源蜂鸣器模块 | 有源蜂鸣器无需PWM驱动,接线即可使用,新手友好 |
| 6 | 按键模块 | 轻触按键直插模块 | 3 | 测量启停、数据查看、阈值设置、功能切换 | 1.0/个 | 矩阵按键模块 | 不带自锁,带上拉电阻和防抖电容,新手无需额外加元件 |
| 7 | 充电管理模块 | TP4056锂电池充电模块 | 1 | 3.7V锂电池充电管理,带过充过放保护 | 4.0 | TP4057充电模块 | 带充电状态指示灯,适配单节3.7V锂电池 |
| 8 | 锂电池 | 3.7V 18650锂电池 2000mAh | 1 | 整机系统便携供电 | 12.0 | 3.7V锂聚合物电池 | 带保护板,避免过充过放,满电续航≥8小时 |
| 9 | 稳压模块 | AMS1117-3.3V稳压模块 | 1 | 锂电池3.7V降压到3.3V,给核心控制器和传感器供电 | 3.0 | RT9193、ME6211稳压模块 | 低压差,低纹波,保证传感器供电稳定 |
| 10 | 电池电压采集 | 100K/10K精密电阻 1%精度 | 2 | 锂电池电压分压采集,电量检测 | 0.5/个 | 同规格精密电阻 | 1%精度,保证电压采集准确 |
| 11 | 杜邦线/端子 | 公对母/母对母杜邦线 | 1套 | 硬件接线、线路连接 | 8.0 | 同规格接线配件 | 建议选择20cm长度杜邦线,适配所有模块接线 |
| 12 | 面包板 | 400孔面包板 | 1 | 模块固定与接线,无需焊接 | 5.0 | 830孔面包板 | 新手友好,可重复接线,无需焊接 |
| — | — | — | — | 推荐版合计参考成本 | — | 99.0元 | — |
2.3 硬件采购避坑指南
-
新手最高发采购坑1:MAX30102模块选型错误,测量精度极差、甚至无信号
很多新手为了省钱买了拆机翻新的MAX30102芯片模块,芯片内部的光电二极管损坏、光学窗口磨损,导致红外光/红光发射功率不足,光电接收信号极弱,根本无法采集到有效的PPG信号;还有的模块无稳压电路、无滤波电容,电源纹波极大,信号完全被噪声淹没,测量值乱跳,根本无法使用。
避坑方案:必须选择全新原装MAX30102芯片、带光学玻璃窗口、带3.3V稳压电路、完善滤波电容的成品模块,优先选择带红外/红光发射指示灯的版本,可直观看到传感器是否正常工作;严禁购买无品牌、无电路设计的散件模块、拆机芯片模块,否则不仅无法实现测量功能,还会浪费大量调试时间。 -
新手最高发采购坑2:传感器模块接口不匹配,驱动代码完全不兼容
很多新手买了MAX30100模块,却按照MAX30102的驱动代码开发,两个芯片的寄存器地址、FIFO深度、配置逻辑完全不同,导致传感器无法初始化、无数据输出,新手很难排查根因;还有的模块I2C地址与代码中不匹配,导致I2C通信失败,传感器无法正常工作。
避坑方案:必须明确采购MAX30102型号模块,采购前核对模块的I2C设备地址,默认地址为0x57,与代码中的定义匹配;若采购了MAX30100模块,需修改对应的驱动代码,两个芯片的驱动逻辑不通用,严禁混用;优先选择资料完善、提供驱动例程的模块,降低开发难度。 -
新手最高发采购坑3:电源模块选型错误,电源纹波大,信号噪声严重
很多新手直接用STM32核心板的3.3V引脚给MAX30102传感器供电,核心板的稳压电路负载能力差,传感器的红外/红光LED发光时,会产生大的脉冲电流,导致电源电压波动、纹波极大,光电采集信号完全被电源噪声淹没,测量值乱跳,根本无法解算出准确的心率血氧值。
避坑方案:必须给MAX30102传感器单独配置低压差、低纹波的LDO稳压模块,比如AMS1117-3.3V、ME6211-3.3V,单独给传感器供电,避免与核心板共用电源产生的噪声干扰;在传感器的电源输入端并联1000uF电解电容+104瓷片电容,做电源滤波,抑制电源纹波和脉冲干扰;严禁用核心板的3.3V引脚直接给传感器供电,尤其是锂电池供电的场景,电源波动会严重影响测量精度。 -
新手最高发采购坑4:锂电池无保护板,导致过充过放损坏,甚至引发安全隐患
很多新手买了无保护板的裸锂电池,充电时过充、放电时过放,导致电池鼓包、容量衰减,甚至出现短路、起火的安全隐患;还有的充电模块不带过充过放保护,无法匹配锂电池的充电曲线,严重缩短电池寿命。
避坑方案:必须选择带保护板的3.7V锂电池,保护板可实现过充、过放、过流、短路保护,避免电池损坏和安全隐患;搭配TP4056锂电池充电模块,模块自带充电管理、过充过放保护,适配单节3.7V锂电池的充电需求,带充电/充满状态指示灯,新手可直观看到充电状态;严禁使用无保护板的裸锂电池,严禁用5V电源直接给锂电池充电,避免引发安全事故。 -
缺货通用替代方案
若显示屏缺货,可替换为同I2C接口的其他型号OLED屏,仅需修改对应的屏幕驱动代码,主控制逻辑无需修改;核心控制器缺货,可直接替换为GD32F103C8T6,CubeMX配置、HAL库代码99%兼容,仅需修改时钟配置即可;MAX30102模块缺货,可替换为MAX30100模块,仅需修改对应的驱动代码,心率血氧解算算法完全无需修改;存储模块缺货,可替换为同I2C接口的AT24C系列芯片,仅需修改设备地址和存储地址映射,驱动逻辑完全通用。
三、硬件接线保姆式指南
【⚠️ 安全警示】本项目涉及锂电池供电,所有接线必须全程断电操作,严禁带电接线、带电触摸电池正负极;严禁短路锂电池正负极,否则会导致电池起火、爆炸,引发安全事故;接线必须先接控制回路,再接电源回路,上电前必须完成全流程自检,无短路、无接反才能上电!
3.1 硬件接线表
接线分为控制通信区和电源供电区两部分,新手必须先完成控制通信区接线,自检无误后,再进行电源供电区接线,所有模块必须可靠共地,这是系统稳定运行、传感器测量精准的核心前提。
| STM32控制器引脚 | 外设模块引脚 | 功能说明 | 杜邦线颜色建议 |
|---|---|---|---|
| 3.3V | MAX30102模块VCC、OLED屏VCC、AT24C02 VCC、按键模块VCC、稳压模块输出 | 控制模块3.3V电源供电 | 红色 |
| 5V | 蜂鸣器模块VCC、TP4056充电模块输出 | 5V电源供电 | 橙色 |
| GND | 所有模块GND引脚、稳压模块GND、锂电池GND、充电模块GND | 所有模块共地连接 | 黑色 |
| PB6 | OLED屏 SCL、MAX30102 SCL、AT24C02 SCL | I2C1时钟线,屏幕、传感器、存储模块驱动 | 黄色 |
| PB7 | OLED屏 SDA、MAX30102 SDA、AT24C02 SDA | I2C1数据线,屏幕、传感器、存储模块驱动 | 蓝色 |
| PA0 | 按键1(功能/切换) | 菜单切换、功能选择、历史数据翻页 | 橙色 |
| PA1 | 按键2(+) | 数值上调、阈值增加、测量启动 | 粉色 |
| PA2 | 按键3(-) | 数值下调、阈值减少、测量停止 | 紫色 |
| PA3 | 蜂鸣器模块 IN | 声光报警控制输出 | 棕色 |
| PA4 | 报警LED模块 IN | 报警指示灯控制输出 | 黄色 |
| PA5 | MAX30102 INT | 传感器中断引脚,数据就绪中断输入 | 绿色 |
| PA9(TX) | 串口模块 RX | 测量数据上传上位机 | 青色 |
| PA10(RX) | 串口模块 TX | 上位机指令接收 | 青色 |
| PB0 | 电池电压采集 ADC1通道8 | 锂电池分压采集,电量检测与低电压保护 | 红色 |
| AMS1117 输入+ | 锂电池3.7V正极 | 稳压模块电源输入 | 红色粗线 |
| AMS1117 输入- | 锂电池GND | 稳压模块电源地 | 黑色粗线 |
| AMS1117 输出+ | STM32 3.3V引脚、MAX30102 VCC | 稳压模块3.3V输出,给控制模块供电 | 红色 |
| AMS1117 输出- | STM32 GND引脚 | 稳压模块输出地 | 黑色 |
| TP4056 输入+ | 5V电源输入 | 充电模块电源输入 | 红色 |
| TP4056 输入- | 5V电源GND | 充电模块电源地 | 黑色 |
| TP4056 输出+ | 锂电池3.7V正极 | 充电模块充电输出 | 红色粗线 |
| TP4056 输出- | 锂电池GND | 充电模块充电地 | 黑色粗线 |
老粉都知道,所有模块必须可靠共地,这是单片机系统稳定运行的核心前提,这里给大家划个重点:STM32的GND、传感器模块GND、屏幕GND、存储模块GND、稳压模块GND、锂电池GND,必须全部可靠连接在一起,绝对不能出现控制回路和电源回路分开供电、不共地的情况,否则会出现I2C通信失败、传感器数据乱跳、系统频繁死机的问题,新手最容易在这里翻车。
3.2 接线步骤分步讲解
-
第一步:控制通信区接线
先将STM32最小系统板固定在面包板上,MAX30102模块尽量靠近STM32核心板安装,缩短I2C通信线长度,减少信号干扰。先接GND主线:将所有控制模块(MAX30102、OLED屏、AT24C02、按键、蜂鸣器)的GND引脚,用黑色杜邦线全部连接到STM32最小系统板的GND引脚,确保所有控制模块共地;再接VCC主线:将3.3V供电的控制模块VCC引脚连接到稳压模块的3.3V输出端,5V供电的模块VCC引脚连接到STM32的5V引脚,先接GND,再接VCC,避免模块上电瞬间出现电平异常,导致芯片损坏。 -
第二步:I2C总线通信接线
按照接线表,连接OLED屏、MAX30102、AT24C02的I2C总线,三个模块共用PB6(SCL)、PB7(SDA)引脚,严格区分时钟线和数据线,绝对不能接反;I2C总线的走线尽量短,避免和电源线平行走线,减少电磁干扰;MAX30102的INT中断引脚连接到PA5,配置为上拉输入模式,用于传感器数据就绪中断触发,提升采样实时性。 -
第三步:人机交互模块接线
连接3个按键模块,按键一端接对应GPIO引脚,另一端全部接GND,GPIO配置为上拉输入模式,无需额外加上拉电阻;连接蜂鸣器和LED报警模块,IN引脚接对应GPIO,VCC接5V,GND接STM32的GND,保证驱动电流充足,蜂鸣器报警音量足够。 -
第四步:电源供电区接线(全程断电,严禁带电操作)
【⚠️ 二次安全警示】本步骤涉及锂电池供电,必须全程断电,锂电池完全断开,严禁带电接线!- 先接稳压模块:AMS1117-3.3V稳压模块的输入端接锂电池3.7V正极和GND,输出端接STM32的3.3V和GND,确保输入输出不接反,否则会直接烧毁稳压模块和核心板。
- 再接充电模块:TP4056充电模块的输出端接锂电池正负极,输入端接5V电源,模块的B+接锂电池正极,B-接锂电池负极,绝对不能接反,否则会烧毁充电模块和电池。
- 最后接电池电压采集电路:锂电池正极串联100K精密电阻,负极串联10K精密电阻到GND,两个电阻的中间节点接STM32的PB0引脚(ADC采集通道),实现电池电压分压采集,分压比例11:1,最大输入电压4.2V时,ADC引脚电压为0.38V,远低于3.3V量程上限,绝对安全。
3.3 接线完成自检方法
-
第一步:断电通断自检(全程断电,锂电池完全断开,无安全风险)
所有模块接线完成后,先不要接锂电池,用万用表通断档,测量锂电池正负极接线端子之间的阻值,若阻值接近0,说明存在严重短路,必须立即排查接线,重点检查稳压模块输入输出是否接反、锂电池正负极是否短路、充电模块接线是否接反,直到短路问题解决,绝对不能接锂电池上电,否则会直接烧芯片、模块,甚至导致电池起火。
再测量3.3V和GND之间、5V和GND之间的阻值,若阻值接近0,说明控制回路存在短路,排查控制模块的VCC和GND是否接反,杜邦线是否有毛刺导致短路,直到短路问题完全解决。 -
第二步:控制区空载上电自检(仅给控制区上电,锂电池、电源模块完全断开)
断开所有电源回路的接线,仅用USB线给STM32核心板通5V电,观察核心板、OLED屏、MAX30102模块的电源指示灯是否正常亮起,若有模块指示灯不亮,立即断电,排查该模块的VCC/GND是否接反、是否虚接。持续上电5分钟,观察所有模块无发热、冒烟、异味等异常情况,用万用表测量每个模块的供电电压,确保3.3V模块电压在3.2V-3.4V之间,5V模块电压在4.8V-5.2V之间,无电压过低、电压波动的问题。 -
第三步:控制功能自检(控制区上电,下载单模块验证代码)
下载单模块验证代码,依次测试每个控制模块的功能:OLED屏是否正常点亮、显示内容正常;按键按下是否正常响应,无误触发;MAX30102模块是否能正常初始化,读取芯片ID,采集光强数据;AT24C02读写是否正常;蜂鸣器和LED报警是否正常;ADC电池电压采集是否正常,确保所有控制模块功能正常,再接入电源回路和锂电池,进行整机测试。 -
第四步:电源回路安全自检(断电状态下接入电源回路,锂电池断开)
断电状态下,接入稳压模块、充电模块接线,用万用表测量稳压模块的输入输出阻值,无短路;用万用表测量充电模块的输入输出阻值,无短路;确认无误后,先不接锂电池,给充电模块通5V电,观察充电指示灯是否正常亮起,稳压模块输出是否稳定在3.3V,无电压异常;确认电源模块正常后,断电接入锂电池,测量锂电池两端电压,确保在3.0V-4.2V之间,再给整车上电,观察系统正常启动,无异常发热、无电压跌落,确认电源回路正常。
3.4 硬件接线避坑指南
-
高频错误1:I2C引脚接反、总线走线过长,导致通信失败、传感器无数据
异常后果:MAX30102、OLED屏、AT24C02无法初始化,I2C通信失败,传感器无数据输出,屏幕无显示,新手很难排查根因。
解决方案:严格区分I2C的SCL时钟线和SDA数据线,绝对不能接反;三个模块共用I2C总线,必须并联接线,不能串联;I2C总线的走线长度尽量控制在10cm以内,避免过长的走线导致信号衰减、干扰;在SCL和SDA线上串联4.7K上拉电阻,提升I2C通信的抗干扰能力,保证通信稳定。 -
高频错误2:MAX30102模块电源接反,直接烧毁传感器芯片
异常后果:MAX30102模块的VCC和GND接反,上电瞬间直接烧毁芯片,无法修复,模块完全报废。
解决方案:接线前先查看模块的引脚标注,明确VCC和GND引脚,严格按照接线表接线,先接GND,再接VCC;上电前用万用表测量模块的VCC和GND之间的阻值,无短路才能上电;模块的VCC必须接3.3V,绝对不能接5V,否则也会烧毁芯片,MAX30102的供电电压范围为1.8V-3.3V,5V供电会直接击穿芯片。 -
高频错误3:控制回路和电源回路不共地,传感器数据乱跳、系统死机
异常后果:MAX30102采集的光强数据乱跳,无有效PPG信号,I2C通信频繁失败,系统频繁死机重启,新手很难排查根因。
解决方案:必须保证所有模块的GND全部连接在一起,STM32的GND、传感器GND、稳压模块GND、锂电池GND,必须用粗线可靠连接,形成完整的地回路;严禁控制回路和电源回路分开供电、不共地,即使分开供电,也必须将两个电源的GND可靠连接在一起,否则会出现电平异常,导致所有外设工作异常。 -
高频错误4:电池电压采集分压电路错误,烧坏ADC引脚
异常后果:分压电阻比例错误,输入到ADC引脚的电压超过3.3V,直接烧坏STM32的ADC引脚,甚至整个芯片,无法修复。
解决方案:单节锂电池满电电压最高4.2V,必须采用100K+10K的精密电阻分压,分压比例11:1,4.2V输入时,ADC引脚的电压为4.2/11≈0.38V,远低于3.3V的量程上限,绝对安全;严禁用小阻值电阻分压,导致分压后的电压超过3.3V;同时在ADC引脚和GND之间并联3.3V TVS管和104瓷片电容,做过压保护和硬件滤波,保护ADC引脚。 -
高频错误5:传感器中断引脚未接,采样时序混乱,测量精度下降
异常后果:传感器采样时序混乱,FIFO数据溢出、丢失,PPG信号不连续,心率血氧解算精度严重下降,甚至无法解算出有效值。
解决方案:必须将MAX30102的INT中断引脚连接到STM32的GPIO引脚,配置为上升沿触发中断,传感器FIFO数据就绪时,会触发中断,MCU在中断中读取FIFO数据,保证采样时序精准,数据不丢失、不溢出;若不接中断引脚,采用轮询方式读取数据,会出现采样时序混乱、数据丢失的问题,严重影响测量精度。
四、代码全流程保姆式讲解
【合规声明】本代码仅供嵌入式学习与开发参考使用,禁止无修改直接复用提交课程作业/竞赛作品,需根据自身需求进行修改、优化与创新,严格遵守对应场景的学术规范与AI内容使用规则。本内容为教学参考框架,严禁直接AI生成后提交课程作业/竞赛作品,需开发者自主完成硬件调试、代码修改、创新优化。
4.1 开发环境与工程创建全流程
本项目采用STM32CubeMX+HAL库开发,完全适配我的《STM32入门保姆式教程》的开发流程,新手可无缝衔接,所有配置无跳步,跟着操作就能完成工程创建。
开发环境版本说明(必须匹配,避免编译报错)
- STM32CubeMX版本:6.10.0
- STM32Cube_FW_F1固件包版本:V1.8.5
- Keil MDK版本:5.38
- 编译器版本:ARM Compiler V6
STM32CubeMX工程配置分步教程
-
芯片选择
打开STM32CubeMX,点击「ACCESS TO MCU SELECTOR」,在芯片搜索框输入「STM32F103C8T6」,选择对应芯片,点击「Start Project」,进入工程配置界面。 -
时钟源配置
点击左侧「RCC」选项,在「High Speed Clock (HSE)」下拉菜单选择「Crystal/Ceramic Resonator」(外部高速晶振),「Low Speed Clock (LSE)」选择「Disable」,本项目无需外部低速晶振。
点击顶部「Clock Configuration」选项卡,进入时钟树配置,将系统时钟配置为72MHz:HSE输入8MHz,PLL倍频为9倍,系统时钟源选择PLL,AHB分频器为1,APB1分频器为2,APB2分频器为1,配置完成后按回车,CubeMX会自动计算所有时钟频率,确保所有时钟无红色报错。 -
调试接口配置
点击左侧「SYS」选项,在「Debug」下拉菜单选择「Serial Wire」(串行线调试接口),这是ST-Link下载器对应的调试接口,必须配置,否则后续无法下载代码、调试程序。 -
GPIO外设配置
按照接线表,依次配置所有GPIO引脚,点击对应引脚,选择对应的功能模式,所有GPIO配置完成后,在左侧「GPIO」选项中,统一配置引脚参数:引脚号 功能模式 上拉下拉 输出速度 引脚标签 PA0-PA2 输入模式 上拉输入 - KEY1-KEY3 PA3-PA4 推挽输出 下拉 中速 BEEP、LED PA5 输入模式 上拉输入 - MAX30102_INT 【前置知识回顾】GPIO推挽输出、上拉输入的配置逻辑,可回顾我的《STM32入门保姆式教程》第2章,老粉可以直接跳过。
-
I2C外设配置
本项目使用I2C1驱动OLED屏、MAX30102、AT24C02模块,点击左侧「I2C1」选项,模式选择「I2C」,I2C时钟频率配置为400KHz(快速模式),GPIO引脚对应PB6(SCL)、PB7(SDA),保持默认参数即可。
【前置知识回顾】I2C通信的基础原理与HAL库驱动方法,可回顾我的《STM32入门保姆式教程》第4章。 -
串口外设配置
本项目使用USART1用于上位机数据上报,点击左侧「USART1」选项,模式选择「Asynchronous」(异步通信),波特率配置为115200,数据位8位,停止位1位,校验位无,开启USART1全局中断,中断优先级配置为3。
【前置知识回顾】USART串口通信的基础原理与HAL库驱动方法,可回顾我的《STM32入门保姆式教程》第4章。 -
ADC配置
本项目使用ADC1通道8(PB0)采集电池电压,点击左侧「ADC1」选项,开启通道8,单次转换模式,右对齐,采样时间配置为239.5个周期,提升采样精度。
【前置知识回顾】ADC采集的基础原理与HAL库驱动方法,可回顾我的《STM32入门保姆式教程》第3章。 -
定时器配置
本项目使用TIM3定时器作为系统时基,实现5ms定时中断,用于传感器采样、算法调度,点击左侧「TIM3」选项,时钟源选择「Internal Clock」(内部时钟),预分频器PSC=71,自动重装载值ARR=4999,定时周期=72MHz/(71+1)/(4999+1)=5ms,开启TIM3全局中断,中断优先级配置为2,保证采样和算法的实时性。
【前置知识回顾】定时器中断的基础配置与使用方法,可回顾我的《STM32入门保姆式教程》第5章。 -
工程生成配置
点击顶部「Project Manager」选项卡,输入工程名称、工程保存路径(路径不能有中文、空格,否则会编译报错),工具链/IDE选择「MDK-ARM V5」,最小版本选择5.32。
点击左侧「Code Generator」选项,勾选以下核心配置:- 「Generate peripheral initialization as a pair of ‘.c/.h’ files per peripheral」(每个外设生成单独的.c/.h文件,模块化编程)
- 「Generate HAL API calls」
- 「Set all free pins as analog (to optimize the power consumption)」
其他配置保持默认,点击右上角「GENERATE CODE」,等待工程生成完成,点击「Open Project」,自动打开Keil MDK工程。
4.2 代码整体架构
本项目采用分层模块化分文件编程,高内聚低耦合,每个功能模块单独拆分.c/.h文件,新手可轻松修改、移植、增删功能,完全贴合STM32模块化编程教程的核心逻辑。
1234



被折叠的 条评论
为什么被折叠?



