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

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

准备工作

• Home Assistant 主机。
• 在 Home Assistant 中安装并启用ESPHome Builder。
• 参考文档：
  • SHT30 Datasheet
  • PMSA003 Datasheet

注意事项

• 本教程中，套件在 ESPHome 2025.9.0 下编译和上传，如果遇见编译 / 上传问题，考虑将 ESPHome 切换至此版本。

创建设备

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

   

2. 在弹窗中点击CONTINUE。

   

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

   

4. 填写配置文件名称。

   

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

   

   

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

   

修改配置

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

   

2. 在文件末尾添加：

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

   1 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。

   

   提示：

   首次编译可能会需要较长时间，编译时间与 Home Assistant 主机性能和网络质量相关。

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

   

下载和烧录固件

1. 下载固件：通过 ESPHome Builder 的Manual download方式下载 Factory Format 固件。

2. 使用 web 工具烧录固件：

   • 将套件通过 USB-C 数据线连接至主机，打开ESPHome Web，点击CONNECT连接设备。

     

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

     

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

     

开始使用

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

   

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

   

3. Dashboard 示例：

   

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

   
   提示

   LCD 屏显上的时间源来自 Home Assistant，当连接到 Home Assistant 后会自动同步时间。传感器数据需要一段时间采样后才能输出到屏显。

相关视频