CCS811 eCO₂ 和挥发性有机化合物传感器
ccs811 传感器平台允许您在 ESPHome 中使用 CCS811 eCO₂ 和挥发性有机化合物传感器
(Adafruit)。
NOTE
大多数 CCS811 模块需要将 WAK 引脚拉低以唤醒传感器,如数据手册中所述。在非低功耗场景下,将 WAK 连接到地是推荐的配置。对于低功耗安装,应在测量前通过软件将 WAK 拉低。
与此传感器的通信通过 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)’。
- 来自 Text Sensor 的所有选项。
高级:
-
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 将被告知此静态基线,您将获得一致的数值。
请注意,一段时间(几个月)后,基线将需要重新校准,因为内部传感器随时间会有轻微的数值漂移。