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

先弄懂:激光散射是怎么数出 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。

如果你手上是普通 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 点屏三件事,性价比相当高。搭完你会发现,空气好不好,桌上那块小屏幕比你鼻子诚实多了。











PMS5003这玩意确实便宜好用,就是风扇声在安静的房间里有点存在感,放卧室的话建议做个间歇读数。
问一下,ESP32-C3 SuperMini的GPIO20/21是不是就是板子背面那两个?普通ESP32用Serial2是不是要另外指定引脚?
照着走了一遍,一次点亮,OLED三行数字都出来了,教程里代码能直接用
这个我上周刚踩过一样的坑:两个TX对着插,屏幕上就是没数,查了一个多小时才发现是串口没交叉。这篇要是早两天发我就省了,写得很全,5V供电那个点尤其关键,好多人以为逻辑3.3V就整根线都接3V3,结果风扇根本转不起来。
火柴那个验证方法很妙,比对着数据手册干瞪眼直观多了