1. 项目概述与整体设计思路1.1 这个项目到底在做什么Y01-3IN1大气质量模块从名字就能看出端倪——一个模块集成了三样东西PM2.5粉尘浓度检测、温湿度检测以及甲醛浓度检测。这个模块在很多DIY空气净化器、室内环境监测站、新风系统项目里非常常见因为一颗模块就能解决三个核心参数不需要再外挂攀藤PMS5003、SHT30、ZE03甲醛模块等一系列传感器。很多人第一次拿到这块模块会被背面密密麻麻的引脚和丝印搞晕。简单说Y01-3IN1模块引脚定义一般是VCC5V供电、GND、TXD、RXD、AOUT、DOUT等。它内部其实是一个完整的传感器融合方案对外通过串口UART输出数据默认波特率9600数据帧格式是一组固定长度的十六进制数据包括了PM2.5、PM10、温度、湿度、甲醛数值等。所以我们这个项目的核心链路非常清晰STM32通过串口接收模块发出的数据帧解析出温湿度、PM2.5和甲醛数值然后通过I2C总线把结果送到OLED屏幕上显示。OLED屏幕用的是最常见的0.96寸128x64分辨率驱动芯片SSD1306I2C接口价格便宜、接线简单、显示效果又亮又清晰。1.2 为什么选STM32 HAL库方案我见过不少初学者在Aduino平台用现成库很快就点亮了OLED但换成STM32就卡住了。究其原因不是STM32难而是大家还没习惯STM32的开发逻辑——库函数一堆、引脚要配置、时钟要初始化每一步都要手动来。这个项目我推荐用STM32CubeMX HAL库方案理由很简单CubeMX可以图形化配置时钟树、串口、I2C引脚直接生成初始化代码把大量的寄存器操作自动处理掉。我们要做的核心工作就剩下两件事按通信协议解析数据帧、按OLED的显示原理写显示函数。如果自己从寄存器裸写单一个I2C时序问题就能让你调三天完全没有必要。另外这个项目用到了串口和I2C两条总线正好覆盖STM32最常见的两种通信方式做完这个项目你就等于把HAL库的两大核心模块都练熟了后面再去做其他传感器项目会很顺。1.3 最终成果长什么样设备上电后OLED屏幕会显示四行信息第一行显示当前甲醛浓度单位mg/m³第二行显示PM2.5浓度单位μg/m³第三行显示温度单位℃第四行显示湿度单位%RH。每秒钟刷新一次数据。这个“一秒刷新”的节奏不是拍脑袋定的因为Y01-3IN1模块本身数据刷新周期就是1秒串口每1秒发一帧数据我们跟随这个节奏就可以了。如果你按这个项目做出来不仅可以得到一个桌面空气质量监测仪还能把“数据帧解析”“OLED显示驱动”“I2C时序理解”这三块硬核技能一次打通。适合人群刚学会点亮LED、想进阶搞传感器开发的学生做毕业设计想做环境监测方向的同学还有那些手里正好有一块Y01-3IN1模块但一直没搞明白怎么玩的电子爱好者。2. 硬件准备与接线注意事项2.1 元器件清单写这篇文章前我专门去翻了配件箱把这次用的东西挨个列出来都是常见元器件某宝随便一搜就有元器件型号/规格说明主控板STM32F103C8T6最小系统板经典蓝板性价比高空气质量模块Y01-3IN1集成PM2.5温湿度甲醛OLED屏幕0.96寸 I2C接口SSD1306驱动芯片下载调试器ST-Link V2程序烧录与调试杜邦线母对母若干用于模块之间的连接面包板通用型方便临时搭建电路如果你的手里是STM32F407、STM32F429等开发板逻辑是一样的只是引脚号不同照着CubeMX重新映射一下就行。2.2 模块引脚定义详解Y01-3IN1模块的接口看起来复杂实际需要接的就几根线。我不建议你在没看资料的情况下直接接电强烈建议先找商家要一份数据手册或者问清楚引脚定义。以我手里这块为例VCC5V电源输入注意不是3.3V虽然内部传感器很多都是3.3V工作但模块上一般带了稳压电路要求供给5VGND电源地TXD串口发送引脚接STM32的RXRXD串口接收引脚接STM32的TX这个引脚一般不用接因为我们只是单向接收数据AOUT模拟信号输出引脚对应甲醛或PM2.5的模拟电压本项目不用DOUT数字信号输出引脚本项目不用这里最容易犯的一个错误就是TXD和RXD接反。很多人第一次调串口通信屏幕上数据全乱码或者什么都收不到百分之八十都是交叉接反了。记住一个口诀发送要接对方接收接收接对方发送。所以模块的TXD不是接STM32的TX引脚而是接STM32的RX引脚。2.3 供电问题别马虎我见过很多人在面包板上用杜邦线接了一堆东西结果传感器工作起来数据飘忽不定换一个好模块也一样。最后发现问题出在供电上。Y01-3IN1模块工作时电流在100mA左右OLED OLED背光点亮时也要几十毫安如果你用ST-Link的3.3V给整块板子供电电流可能就不够用了。STM32F103C8T6最小系统板虽然板载了稳压芯片但一般USB取电进来才靠谱。最稳的供电方式是用USB线给最小系统板供电由板载稳压输出3.3V给OLED同时另接一根5V线给Y01-3IN1模块。如果手头有5V/1A以上的稳压模块独立供电那就更稳了。传感器和主控之间共地就好GND一定要连在一起否则串口通信无法建立。2.4 I2C总线的上拉电阻问题OLED的I2C接口一般模块板上已经自带上拉电阻了所以不需要额外处理。但如果你自己拿SSD1306裸屏去接线I2C的SDA和SCL必须要接4.7kΩ到10kΩ的上拉电阻到3.3V否则通信根本不稳定屏幕时亮时不亮或者干脆白屏。另外OLED模块一般有0欧电阻可以切换I2C地址0x78或0x7A默认是0x78。如果你I2C扫描找不到设备检查一下这个地址配置。3. 环境搭建与CubeMX工程配置3.1 开发环境准备开发环境这块我不打算铺开讲因为网上教程太多了。简单归纳几个要点。第一STM32CubeMX版本建议1.6.0以上这是图形化初始化配置工具。第二固件包需要提前下载好如果你用STM32F103系列在CubeMX里选择F1系列固件包版本选1.8.0或者1.8.5都行。第三编译环境我用的Keil MDK5今年最新版本更新到了5.4x记得装好对应的Device Pack否则你在CubeMX生成的工程在Keil里打开会报缺芯片支持包的错误。烧录工具用ST-Link V2搭配STM32 ST-LINK Utility或者直接在Keil里配置烧录都行。驱动如果安装有问题设备管理器里会出现未知设备这时候重装ST-Link驱动基本都能解决。这里额外说一句有同学问能不能用J-Link下载完全可以工程配置里把调试器从ST-Link换到J-Link就行接线方式SWDIO、SWCLK、GND、3.3V四根线接好。3.2 新建工程的三个关键配置点CubeMX新建工程时芯片型号选STM32F103C8T6然后按以下步骤配置时钟树配置这个环节最容易被忽略很多人没配置就直接写代码结果串口波特率不对、OLED刷新异常。直接点开 Clock Configuration 页面在HCLK输入72MHz回车软件会自动帮你算好PLL参数确认后显示绿色就代表配置合法。STM32F103最高主频是72MHz这是标准配置。调试接口配置在System Core - SYS里面Debug选项选择Serial Wire否则你的ST-Link只能第一次下载程序第二次就提示找不到设备了。这个坑我踩过不止一次每次还要通过BOOT0拉高重新擦除Flash才能正常非常折腾。引脚分配在左侧Pinout面板里我们要配置两大部分。一个是UART1接收来自Y01-3IN1的数据。UART1的默认引脚是PA9TX和PA10RX我们只开接收NVIC里使能串口1全局中断。另一个是I2C1给OLED用默认引脚是PB6SCL和PB7SDA参数保持默认100kHz标准模式就行。3.3 UART和I2C参数设置细节串口这里波特率选9600数据位8位无校验停止位1位。这是Y01-3IN1模块默认的出厂配置。很多人喜欢把波特率调成115200结果收到的数据全部乱码这里特别强调一下9600这个波特率是由传感器模块端决定的不是你想改就能改的除非你有办法重新配置模块的参数寄存器。I2C这里要注意的是速度模式。OLED这种小屏标准模式100kHz完全够用不要为了图快选Fast Mode400kHz某些OLED屏幕在400kHz下反而通信更容易出错而且对杜邦线的质量更敏感。我在面包板上用长杜邦线的时候400kHz下OLED经常出现方块乱码降到100kHz后问题消失。一个小心得CubeMX生成工程后默认I2C频率是100kHz不用改它。把精力放在代码逻辑上。4. 核心代码实现与数据解析4.1 OLED底层驱动函数很多人拿到OLED例程就开始复制粘贴结果大概率屏幕亮是亮了但显示的内容位置不对、字体重叠。我建议从底层开始理解三个关键函数初始化函数、清屏函数、显示字符函数把这几个搞明白后面加任何界面都很自然。SSD1306是128x64的点阵驱动芯片它的显存是1024字节128*64/8。写屏幕本质上就是往这1024字节里写数据。I2C协议上一次写操作由控制字节数据字节组成控制字节0x00表示后面跟的是命令0x40表示后面跟的是显示数据。初始化序列中间有几个核心命令0xAE关闭显示、0x8D0x14打开内部电荷泵、0xAF开启显示。其他命令多半是设置显示起始行、段重映射、对比度这些用默认值就行。我见过有人从网上抄的初始化代码缺了电荷泵打开这一步结果屏幕白屏一片啥都不显示排查了半天。4.2 Y01-3IN1数据帧协议详解Y01-3IN1的数据帧是固定长度格式每帧以0xFF 0xFE开头后面跟着数据位和校验位。拿我手里这个模块来说一帧数据共22个字节结构如下字节序号内容说明0-1帧头固定0xFF 0xFE2-3PM2.5浓度高字节在前单位μg/m³4-5PM10浓度高字节在前单位μg/m³6-7温度高字节在前实际值需要除以108-9湿度高字节在前实际值需要除以1010-11甲醛浓度高字节在前单位mg/m³需要除以100...其他厂商定义见具体手册21校验字节从第0字节累加和取低八位注意不同批次模块的数据结构可能不同有些模块的甲醛在另一个字节位置有的温湿度是单字节带符号温度。所以再次强调拿到模块第一件事是去确认帧格式千万别拿着别人的代码硬套。4.3 串口接收中断解析逻辑这套解析逻辑我用的是最稳妥的方式串口接收中断把每个字节存进缓冲区同时维护一个数组下标每当数组下标等于帧长度这里是22字节时就检查帧头是否为0xFF 0xFE如果匹配就校验数据然后解析数值复位下标。核心代码示意如下uint8_t uart_buf[22]; uint8_t uart_index 0; uint8_t frame_flag 0; void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { if (huart-Instance USART1) { uart_buf[uart_index] receive_data; if (uart_index 22) { uart_index 0; if (uart_buf[0] 0xFF uart_buf[1] 0xFE) { frame_flag 1; } } HAL_UART_Receive_IT(huart1, receive_data, 1); } }然后在主循环里判断frame_flag如果为1就执行解析函数void parse_sensor_data(uint8_t *buf) { sensor_data.pm25 (buf[2] 8) | buf[3]; sensor_data.temp ((buf[6] 8) | buf[7]) / 10.0f; sensor_data.humi ((buf[8] 8) | buf[9]) / 10.0f; sensor_data.hcho ((buf[10] 8) | buf[11]) / 100.0f; }这套逻辑有个很关键的优点不管数据从什么时候开始进入只要连续收了22个字节就检查帧头如果帧头不对直接丢弃等待下一轮。即使刚开始接收时数据“错位”了最多丢一帧数据紧接着就能恢复同步。4.4 主循环刷新逻辑主循环里我们每秒刷新一次OLED。判断方式就是frame_flag这个标志位。当串口收到完整一帧数据并且校验通过就置位frame_flag主循环检测到标志位后更新OLED显示内容然后清掉标志位。OLED刷新频率没必要跟着传感器走因为显示的数值一秒内基本不会出现剧烈变化1Hz的刷新频率已经足够人眼感知。但你如果想让数值变化看起来更平滑可以做个简单的滑动平均滤波取最近4帧数据的平均值。while (1) { if (frame_flag) { frame_flag 0; parse_sensor_data(uart_buf); update_oled_display(); } }这个结构非常简单清晰没有任何delay阻塞整个系统实时响应。5. OLED显示优化与汉字取模5.1 显示布局设计OLED只有128x64像素一屏最多显示4行16×16的汉字或者8行英文字符。我们要显示的内容是四组数据甲醛、PM2.5、温度、湿度。推荐分两屏显示第一屏显示甲醛和PM2.5第二屏显示温湿度通过按键切换。不过为了简单这个项目我们一屏显示4行每行内容格式类似“PM2.5: 012 μg/m³”。OLED上的每个英文字符是8x16点阵一行可以放16个字符。我的布局是这样设计的第一行温度 xx.x℃第二行湿度 xx.x%第三行PM2.5 xxx第四行甲醛 x.xxx用OLED的ASCII字库显示英文冒号和数字足够了不需要中文。如果你想显示“温度”“湿度”这几个汉字就必须额外做一个16x16汉字字库因为SSD1306内部只带ASCII字库不带上万汉字的字库。5.2 汉字取模实操汉字显示的原理是把每个汉字按16x16像素点阵分成32个字节来存储每个字节的每一位对应一个像素点。用“字模软件”先把汉字转成数组然后在代码中调用。常用取模软件有PCtoLCD2002、Img2Lcd等。取模设置非常关键我建议这样设置点阵格式选“阴码”取模走向选“逐行式”取模走向选“顺向”输出数制选“十六进制”自定义格式里选“C51格式”。以“温”字为例取出来的数组长这样const uint8_t hanzi_wen[32] { 0x00, 0x00, 0x7F, 0xFC, 0x08, 0x20, 0x08, 0x20, // 继续省略... };显示汉字时先调用一次设置起始列和起始页的命令然后连续写32个字节整个汉字就显示出来了。16x16的汉字正好占两页第一页16个字节第二页16个字节。5.3 数值格式化与单位处理显示浮点数的时候要注意一个细节直接用sprintf处理浮点数在某些嵌入式环境下比较耗资源而且容易引入体积膨胀。我的做法是把浮点数拆成整数和小数分开显示。比如温度26.3℃我先计算整数部分26和小数部分3然后用整数转字符串的函数分别显示。展示代码如下void display_temp(float temp) { int int_part (int)temp; int dec_part (int)((temp - int_part) * 10); char buf[16]; sprintf(buf, T:%02d.%dC, int_part, dec_part); OLED_ShowString(0, 0, buf); }这样既保留了小数精度又不需要浮点格式化的大开销。5.4 老生常谈的闪烁问题解决很多人用OLED显示动态数据的时候遇到了屏幕闪烁、刷新不均的问题。这是由两个原因造成的一是整屏清屏再重新显示人眼感知到了清屏过程二是I2C连续写显存的间隙屏幕被多次局部刷新。解决办法很简单每次更新显示前只对需要更新的区域调用显示函数不要动不动就整屏清屏。OLED显示原理是“写进去什么就显示什么”所以只要要显示的区域足够覆盖旧内容就行。比如温度数值从26.3变成28.7你只需要在原来显示温度的那一行全部填充背景色再重新写字上去其他区域完全不碰这样肉眼基本看不到闪烁。6. 常见问题与排错实操6.1 ST-Link下载失败要怎么处理“Error: No STM32 Target Found”这个提示做过STM32的人十个里面有八个见过。这个提示的含义是调试器没有找到目标芯片。我从实际经历出发排了几个原因按优先级从高到低排列芯片供电问题检查3.3V引脚有没有电压SWDIO和SWCLK接反这俩线颜色像有些杜邦线色差不明显CubeMX配置工程时忘了勾选Serial Wire导致第一次下载后引脚被复用调试接口失效ST-Link驱动装了但没有正确识别设备管理器里显示带感叹号的设备最后一种情况如果存在重新安装驱动然后确认电脑把ST-Link识别成了“STM32 STLink”而不是USB串口设备。6.2 OLED白屏/黑屏的排查清单OLED白屏通电但无显示是仅次于下载失败的第二大问题。我整理的排查路径如下I2C地址是否正确。SSD1306常见地址是0x3C和0x3D对应写地址0x78和0x7A。如果你不确定写个I2C扫描函数把总线上所有设备地址打出来检查SDA/SCL接线是否接反I2C不像串口那样有TX和RX交叉的概念但SDA和SCL反了必然通信失败供电电压是不是3.3V。有些OLED模块虽然标称支持3.3V~5V但5V供电时对比度反而异常虽然能点亮但是显示非常淡数据线有没有上拉。模块板自带上拉就不用管如果是裸屏就需要加上拉电阻还有一种情况很多人遇到OLED成功显示了一次断电再上电就白屏了。这种通常是初始化代码执行不完整比如在HAL库的I2C发送函数里没有检查返回值总线忙时初始化失败重新初始化一次或者加一个小延时就能解决。6.3 传感器数据全零/数据乱跳分析传感器数据全为零首先检查串口是不是真的在接收。可以在串口中断里加一个计数器在OLED上显示这个计数值如果计数不增说明数据根本没进来。数据乱跳数值忽高忽低一般有三个原因。供电不稳。这是最常见的原因。传感器瞬间工作电流较大如果USB口供电能力弱电压跌落会导致读数异常。用外接5V电源或者换一个USB口试试。周围的干扰源。PM2.5激光传感器对气流和颗粒物很敏感你对着传感器哈一口气PM2.5瞬间冲到999是正常的不代表传感器坏了。串口波特率不对。如果波特率不是9600帧头永远对不上你的解析函数根本走不到赋值那一步显示的是上一次的旧数据。6.4 串口数据乱码排查数据乱码十有八九是波特率不匹配。检查CubeMX里配置的波特率是不是9600有没有改过系统主频导致波特率发生器计算错误。另外检查一下Y01-3IN1模块TXD引脚是否连接到STM32的RX引脚PA10如果接反了也会乱码。有个容易被忽视的地方如果板子上同时接了ST-Link的复位控制下载完程序后ST-Link会拉低复位脚导致芯片反复复位串口数据看着就像乱码。解决方法是程序里配置完串口后加个死循环延时或者干脆拔掉ST-Link只留供电。6.5 常见问题速查表问题现象排查方向解决思路OLED白屏I2C地址、接线、上拉扫描I2C地址检查接线OLED显示乱码I2C速率过高降到100kHz标准模式串口收不到数据TX/RX接反或不共地检查交叉接线确认GND相连串口乱码波特率不匹配确认为9600PM2.5读数全零供电不足换5V独立电源温湿度数值漂移大模块预热时间不够上电后等待60秒再判断甲醛数值一直不变甲醛传感器响应慢甲醛传感器需要较长时间稳定ST-Link下载失败调试接口未开启检查SWDIO/SWCLK连接屏幕亮但无内容初始化序列不完整确认电荷泵命令已发送7. 实测结果与扩展想法7.1 实测过程中的数据表现我拿到这个模块后第一时间做了简单测试。在办公室环境室内温度稳定在25度左右相对湿度约55%PM2.5数值在30到50之间浮动甲醛数值在0.02到0.05 mg/m³之间浮动。数值有轻微抖动是正常的因为空气本身就在流动颗粒物浓度时刻变化这种程度的抖动在实际使用中完全不影响判断。还有一点需要提醒甲醛传感器刚上电时数值会从高位慢慢下降这个过程可能需要半小时甚至更久。很多人刚上电看到甲醛0.5 mg/m³以为家里甲醛超标了其实是传感器在自校准。所以甲醛模块和PM2.5模块不一样它需要一段预热时间做成品时可以在说明书里注明这一点。7.2 这个项目还能往哪个方向扩展项目做完后如果你觉得不过瘾我列几个可以继续折腾的方向。第一个是数据存储。STM32内置Flash容量虽然不大但存几百组历史数据没问题。每隔5分钟存一组数据然后利用OLED做一个趋势曲线显示就能看到一天之内的变化趋势。第二个是添加报警功能。PM2.5超过75 μg/m³或者甲醛超过0.08 mg/m³蜂鸣器报警同时OLED大图标提示。这个功能实现起来不复杂就是在解析数据后加几个条件判断。第三个是蓝牙/WiFi上传。如果手头有ESP8266或者HC-05蓝牙模块把传感器数据通过串口转发出去配一个简单的手机App就能做一个物联网空气质量监测设备。ESP32的micropython环境也有类似的OLED驱动方式如果是ESP32平台I2C用法基本一致串口解析逻辑也完全能复刻。第四个方向比较进阶——自己画PCB。现在面包板上一堆杜邦线乱糟糟的学完整个流程后画一个集成STM32最小系统、Y01-3IN1模块接口、OLED排针的小板子这就是一个真正意义上的产品原型了也适合作为毕业设计的硬件部分。7.3 写在最后的一点个人建议项目整体做下来我最深的感受是这套方案把一个看似复杂的传感器系统拆成了两个独立模块串口的数据接收和I2C的显示控制互不干扰这对理解嵌入式多总线系统的架构特别有帮助。如果你正在调试中遇到问题不要急着怀疑硬件先把串口数据打印出来确认传感器数据正常再确认I2C能扫到OLED两个环节都通了整个系统自然就通了。我实际调试这个项目也踩了不少坑最花时间的是OLED的I2C时序问题一度以为屏幕坏了最后发现是杜邦线太长了。所以如果你在复现时有屏幕显示乱码的问题优先检查I2C通信速率和接线质量这两点确认无误后再去怀疑代码。希望大家都能把这套环境监测小设备跑起来享受把传感器数据变成可视化信息的成就感。
STM32实战：基于Y01-3IN1模块的空气质量监测系统设计与实现
1. 项目概述与整体设计思路1.1 这个项目到底在做什么Y01-3IN1大气质量模块从名字就能看出端倪——一个模块集成了三样东西PM2.5粉尘浓度检测、温湿度检测以及甲醛浓度检测。这个模块在很多DIY空气净化器、室内环境监测站、新风系统项目里非常常见因为一颗模块就能解决三个核心参数不需要再外挂攀藤PMS5003、SHT30、ZE03甲醛模块等一系列传感器。很多人第一次拿到这块模块会被背面密密麻麻的引脚和丝印搞晕。简单说Y01-3IN1模块引脚定义一般是VCC5V供电、GND、TXD、RXD、AOUT、DOUT等。它内部其实是一个完整的传感器融合方案对外通过串口UART输出数据默认波特率9600数据帧格式是一组固定长度的十六进制数据包括了PM2.5、PM10、温度、湿度、甲醛数值等。所以我们这个项目的核心链路非常清晰STM32通过串口接收模块发出的数据帧解析出温湿度、PM2.5和甲醛数值然后通过I2C总线把结果送到OLED屏幕上显示。OLED屏幕用的是最常见的0.96寸128x64分辨率驱动芯片SSD1306I2C接口价格便宜、接线简单、显示效果又亮又清晰。1.2 为什么选STM32 HAL库方案我见过不少初学者在Aduino平台用现成库很快就点亮了OLED但换成STM32就卡住了。究其原因不是STM32难而是大家还没习惯STM32的开发逻辑——库函数一堆、引脚要配置、时钟要初始化每一步都要手动来。这个项目我推荐用STM32CubeMX HAL库方案理由很简单CubeMX可以图形化配置时钟树、串口、I2C引脚直接生成初始化代码把大量的寄存器操作自动处理掉。我们要做的核心工作就剩下两件事按通信协议解析数据帧、按OLED的显示原理写显示函数。如果自己从寄存器裸写单一个I2C时序问题就能让你调三天完全没有必要。另外这个项目用到了串口和I2C两条总线正好覆盖STM32最常见的两种通信方式做完这个项目你就等于把HAL库的两大核心模块都练熟了后面再去做其他传感器项目会很顺。1.3 最终成果长什么样设备上电后OLED屏幕会显示四行信息第一行显示当前甲醛浓度单位mg/m³第二行显示PM2.5浓度单位μg/m³第三行显示温度单位℃第四行显示湿度单位%RH。每秒钟刷新一次数据。这个“一秒刷新”的节奏不是拍脑袋定的因为Y01-3IN1模块本身数据刷新周期就是1秒串口每1秒发一帧数据我们跟随这个节奏就可以了。如果你按这个项目做出来不仅可以得到一个桌面空气质量监测仪还能把“数据帧解析”“OLED显示驱动”“I2C时序理解”这三块硬核技能一次打通。适合人群刚学会点亮LED、想进阶搞传感器开发的学生做毕业设计想做环境监测方向的同学还有那些手里正好有一块Y01-3IN1模块但一直没搞明白怎么玩的电子爱好者。2. 硬件准备与接线注意事项2.1 元器件清单写这篇文章前我专门去翻了配件箱把这次用的东西挨个列出来都是常见元器件某宝随便一搜就有元器件型号/规格说明主控板STM32F103C8T6最小系统板经典蓝板性价比高空气质量模块Y01-3IN1集成PM2.5温湿度甲醛OLED屏幕0.96寸 I2C接口SSD1306驱动芯片下载调试器ST-Link V2程序烧录与调试杜邦线母对母若干用于模块之间的连接面包板通用型方便临时搭建电路如果你的手里是STM32F407、STM32F429等开发板逻辑是一样的只是引脚号不同照着CubeMX重新映射一下就行。2.2 模块引脚定义详解Y01-3IN1模块的接口看起来复杂实际需要接的就几根线。我不建议你在没看资料的情况下直接接电强烈建议先找商家要一份数据手册或者问清楚引脚定义。以我手里这块为例VCC5V电源输入注意不是3.3V虽然内部传感器很多都是3.3V工作但模块上一般带了稳压电路要求供给5VGND电源地TXD串口发送引脚接STM32的RXRXD串口接收引脚接STM32的TX这个引脚一般不用接因为我们只是单向接收数据AOUT模拟信号输出引脚对应甲醛或PM2.5的模拟电压本项目不用DOUT数字信号输出引脚本项目不用这里最容易犯的一个错误就是TXD和RXD接反。很多人第一次调串口通信屏幕上数据全乱码或者什么都收不到百分之八十都是交叉接反了。记住一个口诀发送要接对方接收接收接对方发送。所以模块的TXD不是接STM32的TX引脚而是接STM32的RX引脚。2.3 供电问题别马虎我见过很多人在面包板上用杜邦线接了一堆东西结果传感器工作起来数据飘忽不定换一个好模块也一样。最后发现问题出在供电上。Y01-3IN1模块工作时电流在100mA左右OLED OLED背光点亮时也要几十毫安如果你用ST-Link的3.3V给整块板子供电电流可能就不够用了。STM32F103C8T6最小系统板虽然板载了稳压芯片但一般USB取电进来才靠谱。最稳的供电方式是用USB线给最小系统板供电由板载稳压输出3.3V给OLED同时另接一根5V线给Y01-3IN1模块。如果手头有5V/1A以上的稳压模块独立供电那就更稳了。传感器和主控之间共地就好GND一定要连在一起否则串口通信无法建立。2.4 I2C总线的上拉电阻问题OLED的I2C接口一般模块板上已经自带上拉电阻了所以不需要额外处理。但如果你自己拿SSD1306裸屏去接线I2C的SDA和SCL必须要接4.7kΩ到10kΩ的上拉电阻到3.3V否则通信根本不稳定屏幕时亮时不亮或者干脆白屏。另外OLED模块一般有0欧电阻可以切换I2C地址0x78或0x7A默认是0x78。如果你I2C扫描找不到设备检查一下这个地址配置。3. 环境搭建与CubeMX工程配置3.1 开发环境准备开发环境这块我不打算铺开讲因为网上教程太多了。简单归纳几个要点。第一STM32CubeMX版本建议1.6.0以上这是图形化初始化配置工具。第二固件包需要提前下载好如果你用STM32F103系列在CubeMX里选择F1系列固件包版本选1.8.0或者1.8.5都行。第三编译环境我用的Keil MDK5今年最新版本更新到了5.4x记得装好对应的Device Pack否则你在CubeMX生成的工程在Keil里打开会报缺芯片支持包的错误。烧录工具用ST-Link V2搭配STM32 ST-LINK Utility或者直接在Keil里配置烧录都行。驱动如果安装有问题设备管理器里会出现未知设备这时候重装ST-Link驱动基本都能解决。这里额外说一句有同学问能不能用J-Link下载完全可以工程配置里把调试器从ST-Link换到J-Link就行接线方式SWDIO、SWCLK、GND、3.3V四根线接好。3.2 新建工程的三个关键配置点CubeMX新建工程时芯片型号选STM32F103C8T6然后按以下步骤配置时钟树配置这个环节最容易被忽略很多人没配置就直接写代码结果串口波特率不对、OLED刷新异常。直接点开 Clock Configuration 页面在HCLK输入72MHz回车软件会自动帮你算好PLL参数确认后显示绿色就代表配置合法。STM32F103最高主频是72MHz这是标准配置。调试接口配置在System Core - SYS里面Debug选项选择Serial Wire否则你的ST-Link只能第一次下载程序第二次就提示找不到设备了。这个坑我踩过不止一次每次还要通过BOOT0拉高重新擦除Flash才能正常非常折腾。引脚分配在左侧Pinout面板里我们要配置两大部分。一个是UART1接收来自Y01-3IN1的数据。UART1的默认引脚是PA9TX和PA10RX我们只开接收NVIC里使能串口1全局中断。另一个是I2C1给OLED用默认引脚是PB6SCL和PB7SDA参数保持默认100kHz标准模式就行。3.3 UART和I2C参数设置细节串口这里波特率选9600数据位8位无校验停止位1位。这是Y01-3IN1模块默认的出厂配置。很多人喜欢把波特率调成115200结果收到的数据全部乱码这里特别强调一下9600这个波特率是由传感器模块端决定的不是你想改就能改的除非你有办法重新配置模块的参数寄存器。I2C这里要注意的是速度模式。OLED这种小屏标准模式100kHz完全够用不要为了图快选Fast Mode400kHz某些OLED屏幕在400kHz下反而通信更容易出错而且对杜邦线的质量更敏感。我在面包板上用长杜邦线的时候400kHz下OLED经常出现方块乱码降到100kHz后问题消失。一个小心得CubeMX生成工程后默认I2C频率是100kHz不用改它。把精力放在代码逻辑上。4. 核心代码实现与数据解析4.1 OLED底层驱动函数很多人拿到OLED例程就开始复制粘贴结果大概率屏幕亮是亮了但显示的内容位置不对、字体重叠。我建议从底层开始理解三个关键函数初始化函数、清屏函数、显示字符函数把这几个搞明白后面加任何界面都很自然。SSD1306是128x64的点阵驱动芯片它的显存是1024字节128*64/8。写屏幕本质上就是往这1024字节里写数据。I2C协议上一次写操作由控制字节数据字节组成控制字节0x00表示后面跟的是命令0x40表示后面跟的是显示数据。初始化序列中间有几个核心命令0xAE关闭显示、0x8D0x14打开内部电荷泵、0xAF开启显示。其他命令多半是设置显示起始行、段重映射、对比度这些用默认值就行。我见过有人从网上抄的初始化代码缺了电荷泵打开这一步结果屏幕白屏一片啥都不显示排查了半天。4.2 Y01-3IN1数据帧协议详解Y01-3IN1的数据帧是固定长度格式每帧以0xFF 0xFE开头后面跟着数据位和校验位。拿我手里这个模块来说一帧数据共22个字节结构如下字节序号内容说明0-1帧头固定0xFF 0xFE2-3PM2.5浓度高字节在前单位μg/m³4-5PM10浓度高字节在前单位μg/m³6-7温度高字节在前实际值需要除以108-9湿度高字节在前实际值需要除以1010-11甲醛浓度高字节在前单位mg/m³需要除以100...其他厂商定义见具体手册21校验字节从第0字节累加和取低八位注意不同批次模块的数据结构可能不同有些模块的甲醛在另一个字节位置有的温湿度是单字节带符号温度。所以再次强调拿到模块第一件事是去确认帧格式千万别拿着别人的代码硬套。4.3 串口接收中断解析逻辑这套解析逻辑我用的是最稳妥的方式串口接收中断把每个字节存进缓冲区同时维护一个数组下标每当数组下标等于帧长度这里是22字节时就检查帧头是否为0xFF 0xFE如果匹配就校验数据然后解析数值复位下标。核心代码示意如下uint8_t uart_buf[22]; uint8_t uart_index 0; uint8_t frame_flag 0; void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { if (huart-Instance USART1) { uart_buf[uart_index] receive_data; if (uart_index 22) { uart_index 0; if (uart_buf[0] 0xFF uart_buf[1] 0xFE) { frame_flag 1; } } HAL_UART_Receive_IT(huart1, receive_data, 1); } }然后在主循环里判断frame_flag如果为1就执行解析函数void parse_sensor_data(uint8_t *buf) { sensor_data.pm25 (buf[2] 8) | buf[3]; sensor_data.temp ((buf[6] 8) | buf[7]) / 10.0f; sensor_data.humi ((buf[8] 8) | buf[9]) / 10.0f; sensor_data.hcho ((buf[10] 8) | buf[11]) / 100.0f; }这套逻辑有个很关键的优点不管数据从什么时候开始进入只要连续收了22个字节就检查帧头如果帧头不对直接丢弃等待下一轮。即使刚开始接收时数据“错位”了最多丢一帧数据紧接着就能恢复同步。4.4 主循环刷新逻辑主循环里我们每秒刷新一次OLED。判断方式就是frame_flag这个标志位。当串口收到完整一帧数据并且校验通过就置位frame_flag主循环检测到标志位后更新OLED显示内容然后清掉标志位。OLED刷新频率没必要跟着传感器走因为显示的数值一秒内基本不会出现剧烈变化1Hz的刷新频率已经足够人眼感知。但你如果想让数值变化看起来更平滑可以做个简单的滑动平均滤波取最近4帧数据的平均值。while (1) { if (frame_flag) { frame_flag 0; parse_sensor_data(uart_buf); update_oled_display(); } }这个结构非常简单清晰没有任何delay阻塞整个系统实时响应。5. OLED显示优化与汉字取模5.1 显示布局设计OLED只有128x64像素一屏最多显示4行16×16的汉字或者8行英文字符。我们要显示的内容是四组数据甲醛、PM2.5、温度、湿度。推荐分两屏显示第一屏显示甲醛和PM2.5第二屏显示温湿度通过按键切换。不过为了简单这个项目我们一屏显示4行每行内容格式类似“PM2.5: 012 μg/m³”。OLED上的每个英文字符是8x16点阵一行可以放16个字符。我的布局是这样设计的第一行温度 xx.x℃第二行湿度 xx.x%第三行PM2.5 xxx第四行甲醛 x.xxx用OLED的ASCII字库显示英文冒号和数字足够了不需要中文。如果你想显示“温度”“湿度”这几个汉字就必须额外做一个16x16汉字字库因为SSD1306内部只带ASCII字库不带上万汉字的字库。5.2 汉字取模实操汉字显示的原理是把每个汉字按16x16像素点阵分成32个字节来存储每个字节的每一位对应一个像素点。用“字模软件”先把汉字转成数组然后在代码中调用。常用取模软件有PCtoLCD2002、Img2Lcd等。取模设置非常关键我建议这样设置点阵格式选“阴码”取模走向选“逐行式”取模走向选“顺向”输出数制选“十六进制”自定义格式里选“C51格式”。以“温”字为例取出来的数组长这样const uint8_t hanzi_wen[32] { 0x00, 0x00, 0x7F, 0xFC, 0x08, 0x20, 0x08, 0x20, // 继续省略... };显示汉字时先调用一次设置起始列和起始页的命令然后连续写32个字节整个汉字就显示出来了。16x16的汉字正好占两页第一页16个字节第二页16个字节。5.3 数值格式化与单位处理显示浮点数的时候要注意一个细节直接用sprintf处理浮点数在某些嵌入式环境下比较耗资源而且容易引入体积膨胀。我的做法是把浮点数拆成整数和小数分开显示。比如温度26.3℃我先计算整数部分26和小数部分3然后用整数转字符串的函数分别显示。展示代码如下void display_temp(float temp) { int int_part (int)temp; int dec_part (int)((temp - int_part) * 10); char buf[16]; sprintf(buf, T:%02d.%dC, int_part, dec_part); OLED_ShowString(0, 0, buf); }这样既保留了小数精度又不需要浮点格式化的大开销。5.4 老生常谈的闪烁问题解决很多人用OLED显示动态数据的时候遇到了屏幕闪烁、刷新不均的问题。这是由两个原因造成的一是整屏清屏再重新显示人眼感知到了清屏过程二是I2C连续写显存的间隙屏幕被多次局部刷新。解决办法很简单每次更新显示前只对需要更新的区域调用显示函数不要动不动就整屏清屏。OLED显示原理是“写进去什么就显示什么”所以只要要显示的区域足够覆盖旧内容就行。比如温度数值从26.3变成28.7你只需要在原来显示温度的那一行全部填充背景色再重新写字上去其他区域完全不碰这样肉眼基本看不到闪烁。6. 常见问题与排错实操6.1 ST-Link下载失败要怎么处理“Error: No STM32 Target Found”这个提示做过STM32的人十个里面有八个见过。这个提示的含义是调试器没有找到目标芯片。我从实际经历出发排了几个原因按优先级从高到低排列芯片供电问题检查3.3V引脚有没有电压SWDIO和SWCLK接反这俩线颜色像有些杜邦线色差不明显CubeMX配置工程时忘了勾选Serial Wire导致第一次下载后引脚被复用调试接口失效ST-Link驱动装了但没有正确识别设备管理器里显示带感叹号的设备最后一种情况如果存在重新安装驱动然后确认电脑把ST-Link识别成了“STM32 STLink”而不是USB串口设备。6.2 OLED白屏/黑屏的排查清单OLED白屏通电但无显示是仅次于下载失败的第二大问题。我整理的排查路径如下I2C地址是否正确。SSD1306常见地址是0x3C和0x3D对应写地址0x78和0x7A。如果你不确定写个I2C扫描函数把总线上所有设备地址打出来检查SDA/SCL接线是否接反I2C不像串口那样有TX和RX交叉的概念但SDA和SCL反了必然通信失败供电电压是不是3.3V。有些OLED模块虽然标称支持3.3V~5V但5V供电时对比度反而异常虽然能点亮但是显示非常淡数据线有没有上拉。模块板自带上拉就不用管如果是裸屏就需要加上拉电阻还有一种情况很多人遇到OLED成功显示了一次断电再上电就白屏了。这种通常是初始化代码执行不完整比如在HAL库的I2C发送函数里没有检查返回值总线忙时初始化失败重新初始化一次或者加一个小延时就能解决。6.3 传感器数据全零/数据乱跳分析传感器数据全为零首先检查串口是不是真的在接收。可以在串口中断里加一个计数器在OLED上显示这个计数值如果计数不增说明数据根本没进来。数据乱跳数值忽高忽低一般有三个原因。供电不稳。这是最常见的原因。传感器瞬间工作电流较大如果USB口供电能力弱电压跌落会导致读数异常。用外接5V电源或者换一个USB口试试。周围的干扰源。PM2.5激光传感器对气流和颗粒物很敏感你对着传感器哈一口气PM2.5瞬间冲到999是正常的不代表传感器坏了。串口波特率不对。如果波特率不是9600帧头永远对不上你的解析函数根本走不到赋值那一步显示的是上一次的旧数据。6.4 串口数据乱码排查数据乱码十有八九是波特率不匹配。检查CubeMX里配置的波特率是不是9600有没有改过系统主频导致波特率发生器计算错误。另外检查一下Y01-3IN1模块TXD引脚是否连接到STM32的RX引脚PA10如果接反了也会乱码。有个容易被忽视的地方如果板子上同时接了ST-Link的复位控制下载完程序后ST-Link会拉低复位脚导致芯片反复复位串口数据看着就像乱码。解决方法是程序里配置完串口后加个死循环延时或者干脆拔掉ST-Link只留供电。6.5 常见问题速查表问题现象排查方向解决思路OLED白屏I2C地址、接线、上拉扫描I2C地址检查接线OLED显示乱码I2C速率过高降到100kHz标准模式串口收不到数据TX/RX接反或不共地检查交叉接线确认GND相连串口乱码波特率不匹配确认为9600PM2.5读数全零供电不足换5V独立电源温湿度数值漂移大模块预热时间不够上电后等待60秒再判断甲醛数值一直不变甲醛传感器响应慢甲醛传感器需要较长时间稳定ST-Link下载失败调试接口未开启检查SWDIO/SWCLK连接屏幕亮但无内容初始化序列不完整确认电荷泵命令已发送7. 实测结果与扩展想法7.1 实测过程中的数据表现我拿到这个模块后第一时间做了简单测试。在办公室环境室内温度稳定在25度左右相对湿度约55%PM2.5数值在30到50之间浮动甲醛数值在0.02到0.05 mg/m³之间浮动。数值有轻微抖动是正常的因为空气本身就在流动颗粒物浓度时刻变化这种程度的抖动在实际使用中完全不影响判断。还有一点需要提醒甲醛传感器刚上电时数值会从高位慢慢下降这个过程可能需要半小时甚至更久。很多人刚上电看到甲醛0.5 mg/m³以为家里甲醛超标了其实是传感器在自校准。所以甲醛模块和PM2.5模块不一样它需要一段预热时间做成品时可以在说明书里注明这一点。7.2 这个项目还能往哪个方向扩展项目做完后如果你觉得不过瘾我列几个可以继续折腾的方向。第一个是数据存储。STM32内置Flash容量虽然不大但存几百组历史数据没问题。每隔5分钟存一组数据然后利用OLED做一个趋势曲线显示就能看到一天之内的变化趋势。第二个是添加报警功能。PM2.5超过75 μg/m³或者甲醛超过0.08 mg/m³蜂鸣器报警同时OLED大图标提示。这个功能实现起来不复杂就是在解析数据后加几个条件判断。第三个是蓝牙/WiFi上传。如果手头有ESP8266或者HC-05蓝牙模块把传感器数据通过串口转发出去配一个简单的手机App就能做一个物联网空气质量监测设备。ESP32的micropython环境也有类似的OLED驱动方式如果是ESP32平台I2C用法基本一致串口解析逻辑也完全能复刻。第四个方向比较进阶——自己画PCB。现在面包板上一堆杜邦线乱糟糟的学完整个流程后画一个集成STM32最小系统、Y01-3IN1模块接口、OLED排针的小板子这就是一个真正意义上的产品原型了也适合作为毕业设计的硬件部分。7.3 写在最后的一点个人建议项目整体做下来我最深的感受是这套方案把一个看似复杂的传感器系统拆成了两个独立模块串口的数据接收和I2C的显示控制互不干扰这对理解嵌入式多总线系统的架构特别有帮助。如果你正在调试中遇到问题不要急着怀疑硬件先把串口数据打印出来确认传感器数据正常再确认I2C能扫到OLED两个环节都通了整个系统自然就通了。我实际调试这个项目也踩了不少坑最花时间的是OLED的I2C时序问题一度以为屏幕坏了最后发现是杜邦线太长了。所以如果你在复现时有屏幕显示乱码的问题优先检查I2C通信速率和接线质量这两点确认无误后再去怀疑代码。希望大家都能把这套环境监测小设备跑起来享受把传感器数据变成可视化信息的成就感。
