跳转到内容

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

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

NOTE

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

CCS811 传感器。图片由 Adafruit 提供

与此传感器的通信通过 I²C 总线 进行,因此您需要在配置中有 i2c: 部分才能使此组件工作。

# 示例配置条目
sensor:
- platform: ccs811
eco2:
name: "CCS811 eCO2 Value"
tvoc:
name: "CCS811 Total Volatile Organic Compound"
  • eco2 (可选): 传感器的 eCO₂ 数据,单位为百万分之一 (ppm)。

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

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

  • version (可选): 此传感器以文本形式报告固件(‘应用程序’)版本,后面跟着版本号的内部十六进制表示,因此版本 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 的日志消息。

现在在您的配置文件中设置基线属性,使用您通过日志获得的值:

# 示例配置条目
sensor:
- platform: ccs811
# ...
baseline: 0xA483

下次上传代码时,CCS811 将被告知此静态基线,您将获得一致的数值。

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