M5Stack PM2.5空气质量套件ESPHome配置
M5Stack-Air-Quality-ESPHome
智能家居, ESP32
1/5
已发布
项目简介
ESPHome configuration for M5Stack's PM2.5 Air Quality Kit with the PMSA003 particulate matter sensor and the SHT20 tempe
这是一个基于ESPHome的开源固件项目，专为M5Stack PM2.5空气质量套件（PMSA003颗粒物传感器 + SHT20温湿度传感器）设计。项目核心功能是实时监测并显示空气中PM1、PM2.5、PM10颗粒物浓度，以及温度、湿度、水汽压差和露点等环境数据。技术栈以ESPHome框架为基础，通过YAML配置文件实现硬件驱动与Home Assistant智能家居平台的无缝集成。针对ESPHome原生不支持SHT20传感器的问题，项目开发者自研了基于uFire_SHT20 Arduino库的自定义组件，解决了传感器兼容性痛点。安装方式灵活，既可通过支持Web Serial的浏览器在线刷写固件并配置Wi-Fi，也支持命令行编译上传。项目解决了M5Stack空气质量套件在智能家居场景中的快速部署问题，用户无需编写底层代码即可将设备接入Home Assistant，实现空气质量数据的可视化与自动化联动。适用场景包括家庭环境监测、办公室空气质量预警、实验室洁净度监控等。值得注意的是，开发者指出该套件SHT20传感器存在硬件设计缺陷，温湿度读数受机壳内其他元件发热影响而偏高，建议用户通过数据校准或外部传感器补偿来获取更准确的环境参数。项目采用MIT开源协议，代码结构清晰，适合作为ESPHome自定义组件的学习范例。
标签
项目特点
支持M5Stack PM2.5空气质量套件（PMSA003 + SHT20）
实时显示PM1、PM2.5、PM10颗粒物浓度
实时显示温度、湿度、蒸汽压差和露点
支持通过Web Serial在线安装固件（Chrome/Edge/Opera）
可直接集成Home Assistant
中间按钮控制显示屏背光开关
开源MIT许可证
技术规格
| 主控 | M5Stack Core |
|---|---|
| 颗粒物传感器 | PMSA003 |
| 温湿度传感器 | SHT20 |
| 显示 | M5Stack LCD显示屏 |
| 固件平台 | ESPHome |
| 通信方式 | Wi-Fi |
| 集成平台 | Home Assistant |
| 安装方式 | Web Serial / esphome run |
| 许可证 | MIT |
项目资源
搜索资源
物料清单 (BOM)
| 物料名称 | 数量 | 参考价格 | 备注 |
|---|---|---|---|
| M5Stack Core | 1 | — | 包含LCD显示屏 |
| M5Stack PM2.5空气质量套件 | 1 | — | 含PMSA003和SHT20 |
| USB数据线 | 1 | — | 用于固件烧录和供电 |
| USB电源适配器 | 1 | — | 5V供电 |
能力画像
⚪ 记忆与知识检索: 1/5
🔵 逻辑推演: 2/5
⚪ 表达与交流: 1/5
⚪ 感知与观察: 1/5
⚪ 数理与计算: 2/5
🔵 动手与操作: 3/5
⚪ 狂热与坚持: 2/5
⚪ 创造与创新: 2/5
项目图库
所需技能
🔧 **动手能力**：需要连接M5Stack套件、使用USB数据线烧录固件，具备基本的硬件连接能力。
💻 **编程能力**：需要了解YAML配置文件语法，熟悉ESPHome基本概念，能够使用命令行或Web界面进行固件编译和上传。
⚡ **电子电路**：无需额外电路设计，但需了解传感器基本工作原理和M5Stack硬件接口。
适用场景
家庭室内空气质量监测，实时了解PM2.5、温湿度等环境数据
集成Home Assistant实现智能家居自动化，如根据空气质量自动开关空气净化器
办公室或教室环境监测，保障健康舒适的工作学习环境
空气质量数据记录和分析，了解长期环境变化趋势