pdf-icon

Air Quality V1.1 套件 Home Assistant 集成

Air Quality v1.1 是一款一体化低功耗空气质量监测装置,内置多功能空气质量传感器 SEN55 和 CO2 传感器 SCD40,能监测空气中的 PM1.0、PM2.5、PM4、PM10 颗粒物、温度、湿度、VOC 和 CO2 浓度。本教程提供了将设备集成至 Home Assistant 方法

从ESPHome获取最新的配置范例

准备工作

提示
本教程中,套件在 ESPHome 2025.10.3 下编译和上传,如果遇见编译/上传问题,考虑将ESPHome切换至此版本

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

弹窗点击CONTINUE

选择New Device Setup,创建新的配置文件

填写配置文件名称

选择设备类型,首先取消勾选Use recommended settings,然后点击ESP32-S3

选择M5Stack StampS3

复制API Key备用,点击SKIP跳过

配置设备

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

在文件末尾添加:

yaml
1 2 3 4 5 6
packages:
  air_quality_base_config:
    url: https://github.com/m5stack/esphome-yaml
    files: common/air-quality-v1-rev1-base.yaml
    ref: main
    refresh: 1d

之后点击右上角SAVE, INSTALL,弹出的安装方式中选择Manual download

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

编译完成后,点击Download按钮,选择Factory Format下载固件

烧录固件

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

提示
如果无法显示设备,请参照操作说明进入下载模式

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

再次点击INSTALL进行烧录,等待烧录完成

添加设备至 Home Assistant

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

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

Dashboard示例:

同时,按下USER_A/USER_B按键可以切换页面,显示更多信息

EPaper Display Page 1 EPaper Display Page 2 EPaper Display Page 3
提示
1. 墨水屏屏显上的时间源来自 Home Assistant,当连接到 Home Assistant 后会自动同步时间。
2. 传感器数据需要一段时间采样后才能输出到屏显(最短1分钟),且开启Wi-Fi持续工作会导致功耗增加,电池电量消耗快,建议连接电源使用以获取更稳定的读数。

相关视频

On This Page