pdf-icon

Unit ENV-Pro 传感器 Home Assistant 集成

Unit ENV-Pro 传感器是一款高集成度的环境检测单元,内置 BME688 传感器方案,支持测量 VOC 等挥发性有机化合物、CO₂ 当量、室内空气质量 ( IAQ )、温湿度和大气压等多种环境参数。

本篇文档将展示如何把 Unit ENV-Pro 集成至 Home Assistant 中,主要参考:

注意
因为 Unit ENV-Pro 只是单独的传感器平台,需要额外的主控设备(如 Atom 系列、Stamp 系列, Stick 系列,Core/Basic 系列等)才能集成至 Home Assistant,如上组件使用了专有软件 BSEC2,BSEC2 库仅在接受其软件许可协议后方可使用。通过在配置中启用此组件,即表示您明确同意 BSEC 许可协议的条款。请注意,该许可禁止分发包含此组件的任何编译固件二进制文件。

配置传感器

需要在 ESPHome 配置中启用I²C组件:

yaml
1 2 3 4 5
# Example configuration entry for ESP32
i2c:
  sda: GPIOXX
  scl: GPIOXX
  scan: true

这里的 GPIO 引脚会因为使用的主控设备不一而不同。比如使用 Atom Lite 作为主控:

yaml
1 2 3 4
# I2C Bus on Grove Port (HY2.0-4P)
i2c:
  sda: GPIO26
  scl: GPIO32

Unit ENV-Pro 配置范例

yaml
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47
text_sensor:
  - platform: bme68x_bsec2
    iaq_accuracy:
      name: "BME68x IAQ Accuracy"
  - platform: template
    name: "BME68x IAQ Classification"
    lambda: |-
      if ( int(id(iaq).state) <= 50) {
        return {"Excellent"};
      }
      else if (int(id(iaq).state) >= 51 && int(id(iaq).state) <= 100) {
        return {"Good"};
      }
      else if (int(id(iaq).state) >= 101 && int(id(iaq).state) <= 150) {
        return {"Lightly polluted"};
      }
      else if (int(id(iaq).state) >= 151 && int(id(iaq).state) <= 200) {
        return {"Moderately polluted"};
      }
      else if (int(id(iaq).state) >= 201 && int(id(iaq).state) <= 250) {
        return {"Heavily polluted"};
      }
      else if (int(id(iaq).state) >= 251 && int(id(iaq).state) <= 350) {
        return {"Severely polluted"};
      }
      else if (int(id(iaq).state) >= 351) {
        return {"Extremely polluted"};
      }
      else {
        return {"error"};
      }

sensor:
  - platform: bme68x_bsec2
    temperature:
      name: "Temperature"
    pressure:
      name: "Pressure"
    humidity:
      name: "Humidity"
    iaq:
      id: iaq
      name: "IAQ"
    co2_equivalent:
      name: "CO2 Equivalent"
    breath_voc_equivalent:
      name: "Breath VOC Equivalent"
注意
由于使用了BSEC2 库,传感器的 update_interval 配置选项将无法使用(无法配置拉取间隔时间),数据由专有库中进行处理和发布。

将传感器添加至 Home Assistant

完成配置和上传后,将传感器添加至 Home Assistant

On This Page