PMS5003接ESP32:读PM2.5并显示到OLED

想在自己桌上放一台空气监测仪,PMS5003 是绕不开的一块传感器:Plantower 出的激光颗粒物传感器,几十块钱就能把 PM1.0、PM2.5、PM10 三个数全部读出来,单位微克每立方米,跟官方空气质量指数用的是同一套口径。最近我把两份英文教程合在一起理了一遍,一份来自 gokul.builds(用 ESP32-C3 加 OLED 上屏),一份来自 airdeets(用 Adafruit 官方库走最简路线),这篇就是把新手会卡住的坎提前标出来。

ESP32 与 PMS5003 接线示意图

先弄懂:激光散射是怎么数出 PM2.5 的

PMS5003 里面有一台风扇和一束激光。风扇把空气吸进测量腔,颗粒物掠过激光束时会把光散射开,光电探测器数这些散射脉冲,再换算成每立方米的质量浓度。所以它给你的不是"大概有点灰",而是 PM1.0、PM2.5、PM10 三个具体数字。

传感器通过串口对外吐数据,UART 波特率 9600,8N1。逻辑电平是 3.3V,跟 ESP32 直连没有任何问题,不需要电平转换。有一点新手容易忽略:逻辑 3.3V 不等于供电 3.3V,风扇和激光源要 5V 才转得动,供电必须接 5V 引脚。

数据是以帧的形式流出来的:每帧 32 字节,以 0x42 0x4D 开头,后面跟着各种浓度字段。你可以自己写解析,也可以直接用现成库。开机后风扇需要大约 30 秒才能稳定,这段时间读数飘是正常现象,别急着怀疑传感器坏了。

接线:TX/RX 要交叉,供电必须 5V

串口通信最经典的坑就是忘了交叉。传感器是"说话"的一方,我们只需要读,所以 PMS5003 的 TX 要接到 ESP32 的 RX,PMS5003 的 RX 接 ESP32 的 TX——两个 TX 对着插,屏幕上永远是一片空白。

按 gokul.builds 那份教程的接法(ESP32-C3 SuperMini,5 针 G 系列线缆):PMS5003 的 TX 接 GPIO20,RX 接 GPIO21,VCC 接 5V,GND 共地。OLED 那边走 I2C:VCC 接 3V3,GND 共地,SDA 接 GPIO4,SCL 接 GPIO5。

PMS5003 与 SSD1306 OLED 接 ESP32-C3 接线图

如果你手上是普通 ESP32 开发板(不是 C3),airdeets 的教程用的是 Serial2,传感器直接挂 RX2 引脚,思路完全一样:微控制器的 RX 接传感器的 TX。用面包板加杜邦线就能搭起来,注意 5V 别接到 OLED 上,OLED 吃 3.3V。

两条读数路线:自己解析帧,还是交给库

读数有两条路。第一条是 airdeets 教程走的极简路线:装 Adafruit 的 PM25AQI 库(库管理器里搜"Adafruit PM25 AQI Sensor"),把串口以 9600 波特率打开,用 begin_UART 挂上去,然后循环调 read 拿数据。数据结构里 pm25_standard 就是标准口径的 PM2.5 浓度,串口监视器每秒打印一次就行。这条路线代码量最小,适合先验证硬件接线对不对。

第二条是 gokul.builds 用的 PMS Library(作者 Mariusz Kacki)。它把帧解析封装好了,readUntil 会一直等到凑齐一个完整帧才返回,偶尔丢一个包也没关系,等下一帧就行。两份教程殊途同归,串口参数都是 9600、8N1,读出来的数值口径一致。

我的建议是先走 Adafruit 库那条路把串口调通,确认硬件没问题,再换成带 OLED 显示的完整方案。一次只排查一个变量,是折腾硬件的老规矩。

OLED 显示与完整代码

要在 0.96 寸 SSD1306 上屏显示,需要三个库:PMS Library、Adafruit SSD1306、Adafruit GFX。下面这份完整代码照搬自 gokul.builds 的教程(唯一改动是为了过站点的代码清洗,尖括号头文件改成了引号写法,两种写法在 Arduino 工具链下编译等价):

#include "Wire.h"
#include "Adafruit_GFX.h"
#include "Adafruit_SSD1306.h"
#include "PMS.h"

Adafruit_SSD1306 display(128, 64, &Wire, -1);

HardwareSerial pmsSerial(1);   // UART1
PMS pms(pmsSerial);
PMS::DATA data;

void setup() {
  Serial.begin(115200);
  Wire.begin(4, 5);
  display.begin(SSD1306_SWITCHCAPVCC, 0x3C);
  pmsSerial.begin(9600, SERIAL_8N1, 20, 21);  // RX=GPIO20, TX=GPIO21
}

void loop() {
  if (pms.readUntil(data)) {                  // wait for a full frame
    display.clearDisplay();
    display.setTextColor(SSD1306_WHITE);
    display.setTextSize(1);
    display.setCursor(0, 0);  display.println("PMS5003 ug/m3");
    display.setCursor(0, 18); display.printf("PM1.0: %u", data.PM_AE_UG_1_0);
    display.setCursor(0, 34); display.printf("PM2.5: %u", data.PM_AE_UG_2_5);
    display.setCursor(0, 50); display.printf("PM10 : %u", data.PM_AE_UG_10_0);
    display.display();

    Serial.printf("PM1.0 %u  PM2.5 %u  PM10 %u ug/m3\n",
                  data.PM_AE_UG_1_0, data.PM_AE_UG_2_5, data.PM_AE_UG_10_0);
  }
  delay(1000);
}

烧录后打开 115200 的串口监视器,同时 OLED 上会分三行显示 PM1.0、PM2.5、PM10。想验证传感器灵不灵,教程里给了个直观办法:在旁边点一根火柴再吹灭,看 PM2.5 的数字往上蹿,那个烟就是最好的测试气溶胶。

摆放位置和读数怎么解读

传感器放哪很重要。别贴着窗户缝、空调出风口或者风扇正对的方向,气流太乱读数会抖。桌面监测放呼吸高度附近最有意义——毕竟 PM2.5 影响的是你吸进去的那口空气。风扇一直在转,长期开机是它的设计工况,但 airdeets 系列的后续教程也提到,想延长寿命可以做成读一次睡十五分钟的方案。

读数怎么算好怎么算差,可以对照官方空气质量指数的常用区间:35 以下算优良,75 以上就明显偏脏了,150 以上基本建议关窗开净化器。这些档位只是日常参考,不同标准的具体限值略有差异。

有几个数字我特意没写死:精度、量程、寿命这些细节,官方页面上并没有给全,查不到的我就不编了,真要较真请以 Plantower 的数据手册为准。这类几十块钱的传感器本来就是趋势计,不是计量仪器,看趋势、比变化比纠结绝对值更有意义。

整套方案的成本就是一块 ESP32-C3 SuperMini、一块 PMS5003、一块 SSD1306 OLED 加几根杜邦线,一个下午能搭完。对新手来说,它同时练到了串口交叉接线、帧协议读数和 I2C 点屏三件事,性价比相当高。搭完你会发现,空气好不好,桌上那块小屏幕比你鼻子诚实多了。


作者:隔壁老王的教程
链接:https://www.aiddithome.com/p/63d46c98bcf37.html
本作版权归作者所有,未经允许请勿转载。若存在违规行为,您可以点击 “举报”。


登录 后发表评论
5条评论
刷着刷着入坑了
1楼 · 2026-11-19 07:28:07

PMS5003这玩意确实便宜好用,就是风扇声在安静的房间里有点存在感,放卧室的话建议做个间歇读数。

修啥都行二哥
2楼 · 2026-11-19 07:28:07

问一下,ESP32-C3 SuperMini的GPIO20/21是不是就是板子背面那两个?普通ESP32用Serial2是不是要另外指定引脚?

老张装机
3楼 · 2026-11-19 07:28:07

照着走了一遍,一次点亮,OLED三行数字都出来了,教程里代码能直接用

锡点
4楼 · 2026-11-19 07:28:06

这个我上周刚踩过一样的坑:两个TX对着插,屏幕上就是没数,查了一个多小时才发现是串口没交叉。这篇要是早两天发我就省了,写得很全,5V供电那个点尤其关键,好多人以为逻辑3.3V就整根线都接3V3,结果风扇根本转不起来。

第三次终于亮了
5楼 · 2026-11-19 07:28:06

火柴那个验证方法很妙,比对着数据手册干瞪眼直观多了