1. 项目缘起为什么要在小屏幕上显示PM2.5最近几年空气质量成了大家日常关心的话题尤其是PM2.5这个指标。你可能在手机上用各种App查看过或者在街头的电子大屏上见过滚动数据。但作为一个喜欢动手折腾的硬件爱好者我总觉得这些方式不够“直接”和“专属”。手机App需要打开大屏数据是公共的有没有一种方法能让我在书桌、工作台或者床头一抬眼就看到一个专属于我这个小空间的、实时的空气质量读数呢答案就是自己动手做一个。这个项目的核心目标非常明确将专业的PM2.5传感器数据实时地显示在一块小巧、色彩鲜艳的TFT液晶屏上。我选择的硬件组合是经典的GP2Y1014AU0F粉尘传感器和ILI9341驱动的TFT LCD屏幕。GP2Y1014AU0F是一款通过光学原理检测空气中粉尘浓度的传感器性价比高资料丰富而ILI9341则是一颗非常流行的TFT驱动芯片对应的2.4寸或2.8寸屏幕在开源硬件圈里几乎是“标配”色彩好、驱动库成熟。这个项目看似简单——无非是传感器读数、屏幕显示——但其中涉及了模拟信号采集、数据处理算法、屏幕驱动优化等多个嵌入式开发中的经典环节。它能让你完整地走通“感知-处理-显示”的物联网数据链路对于学习Arduino、ESP32等平台以及理解传感器应用来说是一个绝佳的练手项目。接下来我将从硬件选型、电路连接、代码编写到调试优化一步步拆解如何实现这个功能。2. 硬件选型与电路连接搭建可靠的感知与显示系统选择正确的硬件并可靠地连接它们是项目成功的第一步。这里我们需要三个核心部件主控板、PM2.5传感器和TFT屏幕。2.1 核心部件详解与选型理由主控板MCU我推荐使用ESP32开发板如ESP32 DevKitC。理由有三点第一它拥有足够的GPIO口和硬件SPI接口能轻松驱动ILI9341屏幕第二它内置的Wi-Fi功能为未来扩展如数据上传云端预留了可能第三其双核处理器和较高主频能流畅处理传感器数据和图形刷新避免卡顿。当然使用Arduino Uno或Nano也可以完成基础功能但需要注意其有限的RAM和Flash可能对复杂的图形库造成压力。PM2.5传感器GP2Y1014AU0F这款传感器是夏普的经典产品。它内部有一个红外发光二极管和一个光电晶体管构成一个光学迷宫。当空气流过时其中的粉尘颗粒会散射红外光光电晶体管检测到的光强变化经过转换即可反映粉尘浓度。它的输出是一个模拟电压信号浓度越高电压越高在一定范围内。选择它是因为其原理直观、价格亲民且有大量的社区应用案例可供参考。需要注意的是它检测的是悬浮颗粒物总量通过特定的公式可以估算出PM2.5的浓度但并非法律认证的计量仪器适合作为环境趋势监测和兴趣项目。TFT LCD屏幕ILI9341驱动芯片市面上很多2.4寸、2.8寸的TFT屏都使用这颗驱动芯片。它支持262K色分辨率常见为240x320通过SPI或8位并行接口与主控通信。我强烈建议选择SPI接口的版本。虽然并行接口刷新更快但需要占用大量GPIO口。SPI接口通常只需要4-6根线CLK, MOSI, MISO, CS, DC, RST节省了宝贵的IO资源并且有非常成熟的库如TFT_eSPI支持对初学者更友好。屏幕的背光通常需要单独供电要注意其电压3.3V或5V。2.2 电路连接图与接线要点下面以ESP32开发板为例给出具体的接线方式。请务必在断电情况下操作。ESP32引脚连接至 ILI9341 (SPI)连接至 GP2Y1014AU0F备注3.3VVCCVCC (LED)为屏幕和传感器LED供电GNDGNDGND共地至关重要GPIO 18SCLK-SPI时钟线GPIO 23MOSI (SDI)-SPI主出从入线GPIO 5CS (Chip Select)-屏幕片选低电平有效GPIO 2DC (Data/Command)-数据/命令控制线GPIO 4RST (Reset)-屏幕复位可接可不接用软件复位-LED (Backlight)-屏幕背光通常串联一个电阻接3.3V或5VGPIO 15-LED传感器内部LED控制脚GPIO 34-Vo (Analog Output)传感器模拟输出必须接ADC引脚--VCC (Sensor)传感器工作电压接3.3V或5V见数据手册注意1电源处理。GP2Y1014AU0F的LED引脚需要串联一个150欧姆的电阻来限流。传感器本身的VCC非LED-VCC供电电压范围较宽5-7V典型但很多开发板兼容3.3V逻辑。为确保稳定建议从其VCC引脚接5V如果ESP32板载有5V输出或者接3.3V并测试输出灵敏度。LED控制脚GPIO 15输出低电平时内部LED点亮。注意2ADC引脚选择。ESP32的某些引脚如GPIO34, 35, 36, 39是仅作输入的ADC引脚没有内部上拉电阻非常适合接模拟传感器。避免使用那些兼具其他功能如触摸、串口的ADC引脚以减少干扰。注意3SPI引脚分配。上述GPIO 18和23是ESP32默认的SPI引脚VSPI你也可以使用另一组SPIHSPI。CS,DC,RST引脚可以更改为其他任何数字IO只需在代码中相应配置即可。MISO线在本项目中可以不接因为我们只向屏幕发送数据。3. 软件环境搭建与核心库配置硬件连接好后我们需要在Arduino IDE中搭建软件环境并配置驱动库。3.1 安装必要的库首先确保你已安装Arduino IDE并添加了ESP32开发板支持通过开发板管理器。然后我们需要两个核心库TFT_eSPI库这是驱动ILI9341等SPI TFT屏幕的利器。在Arduino IDE的库管理中搜索“TFT_eSPI”并安装。用于GP2Y1014AU0F的库或头文件虽然没有官方标准库但社区有成熟的代码片段。我们可以直接使用经典的驱动逻辑或者安装像“Adafruit PM25AQI”这类库来学习数据处理结构但需注意传感器不同。本项目我们将手写核心采集函数。3.2 配置TFT_eSPI库关键步骤这是最容易出错的一步。TFT_eSPI库通过一个用户配置文件来适配上百种不同的屏幕。找到Arduino库的安装目录进入libraries/TFT_eSPI文件夹。你会看到一个名为User_Setup.h的文件。不要直接修改它在该文件夹内寻找User_Setups子文件夹里面有很多已经写好的针对特定屏幕的配置文件如Setup24_ILI9341.h。根据你的屏幕型号复制对应的配置文件例如Setup24_ILI9341.h的内容完全覆盖User_Setup.h文件中的内容。打开User_Setup.h文件检查并修改以下关键配置#define ILI9341_DRIVER确保这行是启用的没有注释掉。引脚定义找到TFT_CS,TFT_DC,TFT_RST,TFT_MOSI,TFT_SCLK等定义将其修改为你在电路连接中实际使用的ESP32引脚编号。例如#define TFT_CS 5 // Chip select control pin #define TFT_DC 2 // Data Command control pin #define TFT_RST 4 // Reset pin (could connect to Arduino RESET pin) #define TFT_MOSI 23 // Data out #define TFT_SCLK 18 // Clock out如果你的屏幕有TFT_MISO线也需要定义。背光控制TFT_BL如果接的是固定电平可以不定义或设为-1。确保#define SPI_FREQUENCY设置在一个合理的值如27000000或40000000。过高的频率可能导致屏幕花屏。保存文件。至此屏幕驱动配置完成。4. 代码实现从数据采集到图形显示一切就绪现在开始编写代码。代码逻辑主要分为三部分初始化、PM2.5数据采集与计算、屏幕显示。4.1 基础框架与初始化首先包含必要的头文件并定义引脚和全局变量。#include TFT_eSPI.h // 图形库 TFT_eSPI tft TFT_eSPI(); // 实例化屏幕对象 // GP2Y1014AU0F 引脚定义 const int sensorLED 15; // 控制传感器内部LED的引脚 const int sensorVo 34; // 传感器模拟输出引脚 (ADC) // 全局变量 float pM25 0.0; // 计算得到的PM2.5浓度值μg/m³ unsigned long samplingTime 280; // 传感器LED点亮时间微秒 unsigned long deltaTime 40; // 采样等待时间微秒 unsigned long sleepTime 9680; // 采样周期内的休眠时间微秒 void setup() { Serial.begin(115200); // 初始化串口用于调试输出 pinMode(sensorLED, OUTPUT); pinMode(sensorVo, INPUT); // ADC引脚设为输入 // 初始化TFT屏幕 tft.init(); tft.setRotation(1); // 根据屏幕方向调整0-3可选 tft.fillScreen(TFT_BLACK); // 清屏为黑色 // 绘制静态界面元素标题、单位等 drawStaticUI(); } void loop() { // 1. 采集并计算PM2.5浓度 pM25 readPM25(); // 2. 在屏幕上更新动态数值 updateDisplay(pM25); // 3. 延时控制数据刷新率例如每2秒更新一次 delay(2000); }4.2 PM2.5数据采集函数详解readPM25()函数是核心它严格遵循GP2Y1014AU0F数据手册的时序要求进行采样。float readPM25() { digitalWrite(sensorLED, LOW); // 拉低点亮传感器内部LED delayMicroseconds(samplingTime); // 保持点亮280us int voRaw analogRead(sensorVo); // 在点亮期间读取模拟值 delayMicroseconds(deltaTime); // 等待40us digitalWrite(sensorLED, HIGH); // 关闭LED delayMicroseconds(sleepTime); // 等待一个完整周期剩余的时间 // 将ADC读数转换为电压值 (ESP32 ADC参考电压一般为3.3V12位分辨率0-4095) float voltage voRaw * (3.3 / 4095.0); // 使用经验公式将电压转换为粉尘浓度μg/m³ // 注意这个公式是估算基于特定环境和校准可能需要调整系数 float dustDensity 0.17 * voltage - 0.1; // 一个常用的近似公式 // 确保数值非负并处理可能的误差 if (dustDensity 0) { dustDensity 0.00; } // 将总粉尘浓度折算为PM2.5浓度另一个经验系数 // 重要这个折算系数因环境而异最准确的方法是使用标准仪器进行校准对比。 float pm25 dustDensity * 0.5; // 示例系数仅供参考 Serial.print(Raw ADC: ); Serial.print(voRaw); Serial.print( | Voltage: ); Serial.print(voltage, 3); Serial.print(V | Dust Density: ); Serial.print(dustDensity, 2); Serial.print( μg/m³ | PM2.5: ); Serial.print(pm25, 2); Serial.println( μg/m³); return pm25; }关键解析与避坑点时序是灵魂samplingTime、deltaTime、sleepTime这三个时间参数必须严格按照数据手册。不正确的时序会导致读数完全错误或极不稳定。公式的局限性dustDensity 0.17 * voltage - 0.1这个线性公式是社区广泛使用的但它是在特定条件下颗粒物成分、湿度得出的。它计算的是“总悬浮颗粒物”的质量浓度近似值并非精确的PM2.5。将其乘以一个系数如0.5来估算PM2.5是非常粗略的方法。校准是王道对于任何测量项目校准都至关重要。如果你有一个相对可靠的商用PM2.5检测仪可以将你的设备与其放在同一环境中同时读数通过线性回归等方法修正你的公式系数0.17、-0.1和0.5。没有校准这个项目更偏向于“相对趋势监测”而非“绝对精确测量”。ADC精度与噪声ESP32的ADC在默认情况下存在一定的非线性度和噪声。对于要求不高的环境监测可以接受。如果追求更好稳定性可以尝试启用ADC的衰减器配置或对同一引脚进行多次采样取平均。4.3 屏幕显示优化与UI设计在drawStaticUI()和updateDisplay()函数中我们利用TFT_eSPI库强大的图形功能来创建直观的界面。void drawStaticUI() { tft.setTextColor(TFT_WHITE, TFT_BLACK); // 设置字体颜色前景色背景色 tft.setTextSize(2); // 设置字体大小 tft.setCursor(20, 10); // 设置光标起始位置x, y tft.println(Air Quality Monitor); tft.setTextSize(1); tft.setCursor(50, 50); tft.println(PM2.5 Concentration:); // 绘制一个值显示框 tft.drawRect(40, 80, 160, 60, TFT_CYAN); // 绘制单位 tft.setTextSize(2); tft.setCursor(180, 100); tft.println(ug/m3); // 绘制空气质量等级提示静态文本 tft.setTextSize(1); tft.setCursor(20, 160); tft.println(Level: ); } void updateDisplay(float value) { // 在指定区域矩形框内更新数值采用“先覆盖后打印”的方式避免残影 tft.setTextColor(TFT_YELLOW, TFT_BLACK); // 数值用黄色显示 tft.setTextSize(4); // 大号字体 tft.setCursor(60, 90); // 调整光标到框内居中位置 // 格式化输出总宽度6位保留2位小数 char buf[10]; dtostrf(value, 6, 2, buf); // 将浮点数转换为字符串 tft.print(buf); // 根据数值更新空气质量等级和颜色提示 updateAQILevel(value); } void updateAQILevel(float pm25) { tft.setTextSize(2); tft.setCursor(80, 158); // 覆盖“Level: ”后面的区域 // 根据PM2.5浓度范围定义等级和颜色 String level; uint16_t color; if (pm25 35) { level Good; color TFT_GREEN; } else if (pm25 75) { level Moderate; color TFT_YELLOW; } else if (pm25 115) { level Unhealthy; color TFT_ORANGE; } else { level Hazardous; color TFT_RED; } // 先清除之前的内容用黑色矩形覆盖 tft.setTextColor(color, TFT_BLACK); tft.fillRect(80, 158, 100, 20, TFT_BLACK); // 清除旧文本区域 tft.setCursor(80, 158); tft.print(level); // 可以在屏幕另一区域增加一个颜色条或圆点作为视觉提示 tft.fillCircle(220, 170, 10, color); }显示优化技巧避免闪烁updateDisplay()中更新数字时如果直接打印新值旧值位数不同会产生残影。更好的做法是计算数字占据的像素宽度用背景色黑色矩形完全清除那个区域再打印新值。fillRect()是清除局部屏幕的好帮手。使用dtostrf()格式化浮点数直接打印float到屏幕可能导致格式混乱。dtostrf()函数可以控制总宽度和小数位数确保显示对齐。颜色与视觉编码利用颜色绿、黄、橙、红直观地传达空气质量等级比纯文字更有效。TFT_eSPI预定义了许多颜色常量如TFT_GREEN非常方便。合理设置刷新率PM2.5浓度变化不会非常剧烈loop()中delay(2000)即每2秒更新一次屏幕是合理的。过于频繁的刷新如每秒多次不仅没必要还会增加处理器负担和屏幕闪烁感。5. 调试、校准与进阶优化代码烧录后项目基本就能运行了。但要让显示的数据更有参考价值还需要进行调试和优化。5.1 串口调试与数据观察在开发阶段务必利用Serial.print()将关键数据原始ADC值、计算电压、浓度值打印出来。通过串口监视器观察数据是否稳定在静止空气中读数应在一个小范围内波动。如果跳动剧烈检查电源是否稳定传感器引脚是否接触良好或者尝试对analogRead()进行软件滤波如连续采样10次取中值或平均值。数值是否合理在清洁室内PM2.5估算值通常在20-50 μg/m³以下。如果你看到几百甚至上千的异常值首先检查时序函数delayMicroseconds()是否准确或者ADC引脚是否受到其他电路噪声干扰。5.2 传感器校准实践如前所述未经校准的传感器只能看趋势。校准需要一台可信的参考设备如小米空气净化器显示的PM2.5或专业的检测仪。将你的设备和参考设备置于同一位置避免直接通风口。收集多组数据对你的设备读数 vs 参考设备读数覆盖低、中、高浓度可以通过点燃一段香来制造烟雾注意安全并在通风处进行。在Excel或任何绘图工具中以参考值为X轴你的设备原始电压或计算值为Y轴绘制散点图。进行线性拟合得到新的斜率和截距替换代码中的0.17和-0.1。这个步骤能显著提高你设备读数的相对准确性。5.3 软件滤波算法为了得到更平滑、更可靠的读数可以在readPM25()函数返回前加入滤波算法。最简单的是一阶滞后滤波指数加权平均float filteredPM25 0.0; // 全局滤波后值 float alpha 0.2; // 滤波系数 (0 alpha 1)越小越平滑响应越慢 float readAndFilterPM25() { float rawPM25 readPM25(); // 获取原始计算值 filteredPM25 alpha * rawPM25 (1 - alpha) * filteredPM25; return filteredPM25; }在loop()中调用readAndFilterPM25()并显示filteredPM25你会发现数值变化平缓了许多跳变减少。5.4 功耗考虑与未来扩展目前设备是持续工作的。如果你希望它电池供电可以考虑加入深度睡眠功能。让ESP32每隔一段时间如5分钟唤醒一次采集数据、更新屏幕然后再次进入深度睡眠可以极大延长续航。 此外ESP32的Wi-Fi功能为联网提供了可能。你可以很容易地将数据上传到物联网平台如Blynk、ThingsBoard或自建的MQTT服务器实现远程监控和历史数据记录。屏幕则作为本地实时显示器两者结合项目实用性将大大增强。6. 常见问题排查QA在制作过程中你可能会遇到以下问题Q1: 屏幕白屏或花屏没有任何显示。检查电源确保屏幕的VCC和背光LED都已正确供电。有些屏幕背光需要独立的5V供电。检查SPI引脚确认User_Setup.h中的引脚定义与你的实际接线完全一致。特别是TFT_DC和TFT_CS接错会导致无显示。检查库和配置确认安装了正确的TFT_eSPI库并且User_Setup.h文件已根据你的屏幕型号正确配置。尝试降低SPI频率在User_Setup.h中找到#define SPI_FREQUENCY将其改为20000000或更低排除因线长或屏幕体质导致的通信不稳定。Q2: PM2.5读数始终为0或接近0。检查传感器LED在传感器工作时用手机摄像头普通模式对准传感器进气孔旁边的窗口。如果LED正常工作你应该能在摄像头里看到微弱的红光红外光对摄像头可见。如果看不到检查senorLED引脚控制逻辑和限流电阻。检查ADC读数通过串口监视器查看voRaw的值。在清洁空气中它应该是一个较低的数值例如几十到几百。如果一直是0或4095检查senorVo引脚是否接在了ESP32的ADC引脚上以及接线是否牢固。验证时序确保readPM25()函数中的delayMicroseconds()参数准确。可以尝试稍微调整samplingTime。Q3: 数值异常高且不随环境变化。传感器污染光学传感器内部积灰会导致误报。尝试用压缩空气轻轻吹扫传感器进气孔。电压干扰确保传感器和ESP32共用良好的GND地线。模拟信号线尽量远离数字信号线如SPI时钟线。公式错误检查电压转换公式。确认ESP32的ADC参考电压通常是3.3V和分辨率12位0-4095。Q4: 屏幕刷新有残影或者局部内容擦不干净。使用局部清屏更新数字时不要只print新值。先用fillRect(x, y, w, h, TFT_BLACK)清除上一帧数字所在的整个矩形区域再打印新值。双缓冲高级对于复杂的动态图形TFT_eSPI支持创建内存中的帧缓冲区TFT_eSprite。所有绘图操作先在缓冲区完成然后一次性推送到屏幕可以完全消除闪烁。但对于简单的数字更新局部清屏已足够。完成以上所有步骤你就拥有了一个本地化的、实时显示的PM2.5浓度监测装置。它不仅是一个实用的桌面小工具更是一个融合了模拟信号处理、嵌入式编程和人机界面设计的综合性学习项目。你可以进一步为它设计一个3D打印的外壳让它看起来更精致。最重要的是通过动手实践你对传感器、微控制器和显示设备如何协同工作的理解远比阅读文档要深刻得多。