PM2.5 Air Quality 套件 (SHT30) Home Assistant 集成

本章节介绍将 PM2.5 Air Quality Kit-SHT30 空气质量监测套件集成至 Home Assistant 并输出数据至 LCD 屏显的方法。

1. 准备工作

环境准备

1. 参考 Home Assistant 官方文档安装 Home Assistant。
2. 参考 ESPHome 官方文档完成 ESPHome Device Builder 插件安装。（注意：本教程基于 ESPHome 2025.9.0 版本编写，如遇编译或上传问题，建议先切换至该版本进行验证。）

硬件产品

• PM2.5 Air Quality Kit-SHT30
• Home Assistant 主机。

参考资料

• 传感器数据手册：
  • SHT30 Datasheet
  • PMSA003 Datasheet

2. 在线烧录

点击下方在线烧录按钮，按提示完成固件烧录和 Wi-Fi 配置，即可快速体验 PM2.5 Air Quality Kit-SHT30 接入 Home Assistant。

烧录及配置的详细操作可参考在线 ESPHome 固件烧录与配置说明。

在线烧录

使用在线烧录功能完成后，无需执行“固件编译 & 烧录”步骤，直接跳转至4. 开始使用章节继续后面的操作。

3. 固件编译 & 烧录

本小节将说明如何基于 yaml 配置文件重新编译项目，便于二次开发、功能修改或新增功能。

创建设备

1. 打开 ESPHome Builder，点击右下角的NEW DEVICE，创建一个新设备。

2. 弹窗点击CONTINUE。

3. 选择New Device Setup，创建新的配置文件。

4. 填写配置文件名称。

5. 选择设备类型，首先取消勾选Use recommended settings，然后点击ESP32，选择M5Stack Core ESP32。

6. 复制 API Encryption Key 备用，点击SKIP。

修改配置

1. 点击生成的配置文件卡片中的EDIT进行编辑。

2. 在文件末尾添加：

packages:
  m5stack.pm2_5-air-quality-kit: github://m5stack/esphome-yaml/common/pm2_5-air-quality-kit-base.yaml@main

3. 点击右上角的SAVE和INSTALL，在弹出的安装方式中选择Manual download。

4. 编译完成后，点击Download按钮，选择Factory Format下载固件。

烧录固件

1. 下载固件：通过 ESPHome Builder 的Manual download方式下载 Factory Format 固件。
2. 使用 ESPHome Web 烧录固件：

• 使用 USB Type-C 数据线将套件连接至电脑，打开 ESPHome Web，点击CONNECT连接设备。

• 点击INSTALL，选择之前编译的固件进行上传。

• 再次点击INSTALL进行烧录，等待烧录完成。

4. 开始使用

1. 完成固件烧录后，设备开机将自动进行 Wi-Fi 连接。Home Assistant 服务自动发现新设备，在 Notifications 中选中新设备并Check it out->CONFIGURE，按照弹框步骤将设备添加到指定的区域即可完成配置。

2. 若未收到新设备提示消息，也可导航至 Settings > Devices & Services 查看设备情况。点击Add即可添加设备至 Home Assistant。

3. Dashboard 示例：

4. 同时，Basic 主机上的按键可以切换页面，显示更多信息。

5. 相关视频