ENS160 挥发性有机化合物 (VOC) 和 eCO₂ 传感器

ens160 传感器平台允许您使用 ENS160 （数据手册）空气质量传感器与 ESPHome 配合使用。需要在配置中设置 I²C 或 SPI 才能使此传感器工作。

NOTE

ENS160 传感器首次上电时，在读取数据可用之前有 1 小时的初始启动延迟。对于后续启动或重启，有 3 分钟的预热期才能获得读数。另外，请注意 ENS160 连续数据测量可能需要长达 1 秒才能准备就绪。

# I2C 示例配置条目
sensor:
  - platform: ens160_i2c
    eco2:
      name: "ENS160 eCO2"
    tvoc:
      name: "ENS160 Total Volatile Organic Compounds"
    aqi:
      id: ens160_air_quality_index
      name: "ENS160 Air Quality Index"
    compensation:
      temperature: id_temperature_sensor
      humidity: id_humidity_sensor

# SPI 示例配置条目
sensor:
  - platform: ens160_spi
    eco2:
      name: "ENS160 eCO2"
    tvoc:
      name: "ENS160 Total Volatile Organic Compounds"
    aqi:
      name: "ENS160 Air Quality Index"
    cs_pin: GPIOXX
    compensation:
      temperature: id_temperature_sensor
      humidity: id_humidity_sensor

配置变量

eco2 (可选): eCO2 传感器的配置。
- 所有选项来自传感器。
tvoc (可选): TVOC 传感器的配置。
- 所有选项来自传感器。
aqi (可选): 空气质量指数传感器的配置。
- 所有选项来自传感器。
update_interval (可选, 时间): 检查传感器的时间间隔。默认为 60s。更新间隔应大于 ENS160 的测量频率，最长可达 1 秒。
address (可选, 整数): 仅 I²C。 手动指定传感器的 I²C 地址。默认为 0x52。另一个地址可以是 0x53。
cs_pin (必需, 引脚模式): 仅 SPI。 片选引脚。

高级：

compensation (可选): 包含用于补偿的传感器的块。温度和湿度补偿可提高传感器读数的准确性。没有补偿时，ENS160 内部假设 25°C 温度和 50% 湿度，在没有温度和湿度补偿的情况下，读数会明显偏离实际变化。
- temperature (必需, ID): 外部温度传感器的 ID。
- humidity (必需, ID): 外部湿度传感器的 ID。

示例文本传感器配置

此传感器的空气质量指数 (AQI) 是一个介于 1 和 5 之间的数字。ENS160 （数据手册）指出 “AQI-UBA 空气质量指数源自德国联邦环境署基于 TVOC 总信号的指南”。以下是将数字 ENS160 AQI 转换为评级文本的示例配置。

text_sensor:
  - platform: template
    name: "ENS160 Air Quality Rating"
    lambda: |-
      switch ( (int) (id(ens160_air_quality_index).state) ) {
        case 1: return {"Excellent"};
        case 2: return {"Good"};
        case 3: return {"Moderate"};
        case 4: return {"Poor"};
        case 5: return {"Unhealthy"};
        default: return {"Not Available"};
      }

ENS160 挥发性有机化合物 (VOC) 和 eCO₂ 传感器

配置变量

示例文本传感器配置

另见