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许可证
技术规格
| 主控 | |
|---|---|
| 颗粒物传感器 | |
| 温湿度传感器 | |
| 显示 | |
| 固件平台 | |
| 通信方式 | |
| 集成平台 | |
| 安装方式 | |
| 许可证 |
项目资源
物料清单 (BOM)
| 物料名称 | 数量 | 参考价格 | 备注 |
|---|---|---|---|
| M5Stack Core | 1 | — | 包含LCD显示屏 |
| M5Stack PM2.5空气质量套件 | 1 | — | 含PMSA003和SHT20 |
| USB数据线 | 1 | — | 用于固件烧录和供电 |
| USB电源适配器 | 1 | — | 5V供电 |
所需工具
| 工具 | 用途 | 是否必需 |
|---|---|---|
| 电脑 | 编译和上传固件 | ✅ 是 |
| Chrome/Edge/Opera浏览器 | Web Serial在线安装 | ▢ 推荐 |
| ESPHome开发环境 | 手动编译固件 | ▢ 推荐 |
| USB数据线 | 连接M5Stack和电脑 | ✅ 是 |
能力画像
记忆与知识检索
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实现智能家居自动化，如根据空气质量自动开关空气净化器
办公室或教室环境监测，保障健康舒适的工作学习环境
空气质量数据记录和分析，了解长期环境变化趋势