跳转到内容

CCS811 eCO_2 和挥发性有机化合物传感器

ccs811 传感器平台允许您在 ESPHome 中使用 CCS811 eCO_2 和挥发性有机化合物传感器 (Adafruit)。

NOTE

大多数 CCS811 模块需要将 WAK 引脚拉低以唤醒传感器,如数据手册中所述。 在低功耗场景之外,将 WAK 连接到地线是推荐的配置。对于低功耗安装, 在采取措施之前,应在软件中将 WAK 拉低。

CCS811 传感器。图片由 Adafruit 提供

与此传感器的通信通过 I²C 总线 完成,因此您需要在配置中包含 i2c: 部分才能使此组件正常工作。

# Example configuration entry
sensor:
- platform: ccs811
eco2:
name: "CCS811 eCO2 Value"
tvoc:
name: "CCS811 Total Volatile Organic Compound"
  • eco2 (可选): 传感器的 eCO_2 数据,单位为百万分之一 (ppm)。

    • 来自 Sensor 的所有选项。
  • tvoc (可选): 总挥发性有机化合物传感器的信息, 单位为十亿分之一 (ppb)。

    • 来自 Sensor 的所有选项。
  • update_interval (可选, Time): 检查传感器的时间间隔。默认为 60s。

  • version (可选): 此传感器以文本形式报告固件(‘application’)版本,后面跟版本号的内部十六进制表示,因此版本 1.0.0 将报告为 ‘1.0.0 (0x1000)’。

高级:

  • address (可选, int): 传感器的 I²C 地址。默认为 0x5A。

  • baseline (可选, int): 用于校准目的的单元的基线值。 更多信息请参阅 校准基线。

  • temperature (可选, ID): 在此提供外部温度传感器 ID。 这可以改善传感器的内部计算。

  • humidity (可选, ID): 在此提供外部湿度传感器 ID。 这可以改善传感器的内部计算。

CCS811 传感器每次通电时都会重新校准自己。遗憾的是, 这也意味着如果传感器在空气质量低于正常水平时重启, 值将具有恒定偏移,无法与上次 启动前的值进行比较。

为了获得一致的值,您需要指定一个静态 baseline 值(校准因子)。 为此,首先让传感器在未设置基线的情况下启动,让传感器自行校准。 大约 20-30 分钟后,您可以查看 ESP 上的远程日志。下次 读取传感器时,您将看到类似 baseline=0xA483 的日志消息。

现在在配置文件中设置 baseline 属性,如下所示,使用您从 日志中获得的值:

# Example configuration entry
sensor:
- platform: ccs811
# ...
baseline: 0xA483

下次上传代码时,CCS811 将获得此静态基线 信息,您将得到一致的值。

请注意,经过一段时间后(几个月),基线需要 重新校准,因为内部传感器会随时间产生轻微的值漂移。