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

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

NOTE

该传感器支持高达 15kHz 的操作，因此您应该在 i2c 配置中指定 frequency: 15kHz。

AGS10 VOC 传感器

# 示例配置条目
sensor:
  - platform: ags10
    tvoc:
      name: TVOC

配置变量

• tvoc (必需): 总挥发性有机化合物传感器的信息。 来自 Sensor 的所有选项。

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

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

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

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

动作

ags10.set_zero_point 动作

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): 支持的模式之一：

  • FACTORY_DEFAULT - 重置为出厂零点
  • CURRENT_VALUE - 使用当前电阻设置零点校准
  • CUSTOM_VALUE - 使用 value 选项指定的电阻值设置零点校准

• value (可选, int): 指定的电阻值（单位：0.1 kΩ）。

ags10.new_i2c_address 动作

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): 新的 I2C 地址。

另见

• 传感器过滤器
• API Reference: ags10.h