跳转到内容

AGS10 挥发性有机化合物 (VOC) 传感器

ags10 传感器平台 VOC 传感器允许您将 ASAIR AGS10 (数据手册, ASAIR) 传感器与 ESPHome 配合使用。配置中必须设置 I²C 总线 才能使此传感器工作。

NOTE

该传感器支持最高 15kHz 的运行,因此应在 i2c 配置中指定最高 frequency: 15kHz。

AGS10 VOC 传感器
# 示例配置条目
sensor:
- platform: ags10
tvoc:
name: TVOC
  • tvoc (必选): 总挥发性有机化合物传感器的信息。 来自 Sensor 的所有选项。

  • address (可选, int): 手动指定传感器的 I²C 地址。 默认为 0x1A。

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

  • version (可选): 传感器的固件版本。 来自 Sensor 的所有选项。

  • resistance (可选): 传感器电阻的初始值。 来自 Sensor 的所有选项。

AGS10 的零点已在出厂前校准。用户可根据 需要对零点重新校准。

# 示例配置条目
sensor:
- platform: ags10
id: ags10_1_id
# ...
# 在某些触发器中
on_...:
- ags10.set_zero_point:
id: ags10_1_id
mode: CURRENT_VALUE

配置选项:

  • id (必选, ID): AGS10 传感器的 ID。

  • mode (必选, enum, templatable): 支持的某一模式:

    • FACTORY_DEFAULT - 恢复出厂零点
    • CURRENT_VALUE - 以当前电阻设置零点校准
    • CUSTOM_VALUE - 以 value 选项指定的电阻值设置零点校准
  • value (可选, int, templatable): 要设置的指定电阻值(单位:0.1 kΩ)。

AGS10 的 I2C 地址可以修改,可以在一条总线上使用多个 AGS10 传感器。 发送地址更改命令后,新地址会被保存,并立即生效,即使 断电后依然有效。

# 示例配置条目
sensor:
- platform: ags10
id: ags10_1_id
# ...
# 在某些触发器中
on_...:
- ags10.new_i2c_address:
id: ags10_1_id
address: 0x1E

配置选项:

  • id (必选, ID): AGS10 传感器的 ID。
  • address (必选, int, templatable): 新的 I2C 地址。