Unit Mini TVOC/eCO2 Home Assistant 集成

本教程将介绍如何使用 Unit Mini TVOC/eCO2 气体传感器单元搭配 AtomS3R 主控，并将其集成到 Home Assistant 中，实现对空气中 TVOC（总挥发性有机化合物）和 eCO2（等效二氧化碳）浓度的实时监测。

1. 准备工作

硬件清单

1 x Unit Mini TVOC/eCO2
1 x AtomS3R
1 x HY2.0-4P Grove 连接线 (20cm)
1 x Home Assistant 主机（服务器、迷你电脑、NAS 等）

软件与版本

Home Assistant 2026.2.0 及以上
ESPHome Device Builder 2026.2.2 及以上

2. 创建设备

打开 ESPHome Dashboard，若出现初始引导界面，点击 CONTINUE。

点击右下角的绿色 + 按钮，开始创建新设备。

点击 New Device Setup，进入设备创建向导。

输入设备名称，点击 NEXT。

选择设备类型，点击 ESP32S3。

点击 SKIP，跳过加密密钥设置。

点击 EDIT，进入 YAML 配置页面，自定义设备功能。

3. 设备配置

3.1 I2C 总线配置

添加 I2C 组件，配置 Unit Mini TVOC/eCO2 与 AtomS3R 之间的通信引脚。

i2c:
  sda: GPIO2
  scl: GPIO1
  scan: true 

说明

AtomS3R 的 PORT.A 接口对应 SDA: GPIO2，SCL: GPIO1。若使用其他端口，请根据实际引脚进行调整。

3.2 传感器配置

添加 Sensor 组件，启用 SPG30 传感器实体。

sensor:
  - platform: sgp30
    address: 0x58
    update_interval: 2s
    store_baseline: true
    # Optional
    # baseline:
    #   eco2_baseline: 0x190 #400
    #   tvoc_baseline: 0x0   #0
    eco2:
      name: "eCO2"
    tvoc:
      name: "TVOC" 

主要参数说明：

参数	值	说明
`address`	0x41	Unit Mini TVOC/eCO2 的 I2C 地址。
`update_interval`	2s	向 Home Assistant 更新测量数值的时间间隔。
`store_baseline`	true	是否启用基线值存储功能。
`baseline`	可选配置项	预设基线值，可根据实际环境调整以提高测量准确性。
`eco2`	eCO2 传感器实体配置	配置 eCO2 传感器实体的名称等属性。
`tvoc`	TVOC 传感器实体配置	配置 TVOC 传感器实体的名称等属性。