AGS10 Volatile Organic Compound (VOC) Sensor

The ags10 sensor platform VOC sensor allows you to use your ASAIR AGS10 (datasheet, ASAIR_ ) sensors with ESPHome. The I²C Bus is required to be set up in your configuration for this sensor to work.

ℹ️ Note
The sensor supports up to 15kHz operation, so you should specify up to frequency: 15kHz in your i2c configuration.

# Example configuration entry
sensor:
  - platform: ags10
    tvoc:
      name: TVOC

Configuration variables

tvoc (Required): The information for the total Volatile Organic Compounds sensor. All options from Sensor.
address (Optional, int): Manually specify the I²C address of the sensor. Defaults to 0x1A.
update_interval (Optional, Time): The interval to check the sensor. Defaults to 60s.
version (Optional): The firmware version of the sensor. All options from Sensor.
resistance (Optional): The initial value of the sensor resistance. All options from Sensor.

Actions

`ags10.set_zero_point` Action

Zero-point of AGS10 has been calibrated before leaving factory. User can re-calibrate the zero-point as needed.

# Example configuration entry
sensor:
  - platform: ags10
    id: ags10_1_id
    # ...

# in some trigger
on_...:
  - ags10.set_zero_point:
      id: ags10_1_id
      mode: CURRENT_VALUE

Configuration option:

id (Required, ID): The ID of the AGS10 sensor.
mode (Required, enum): One of supported modes:
- FACTORY_DEFAULT - reset to the factory zero-point
- CURRENT_VALUE - set zero-point calibration with current resistance
- CUSTOM_VALUE - set zero-point calibration with resistance pointed with value option
value (Optional, int): nominated resistance value to set (unit: 0.1 kΩ).

`ags10.new_i2c_address` Action

I2C address of AGS10 can be modified, and it is possible to use multiple AGS10 sensors on one bus. After sending the command for address changing, the new address is saved and takes effect immediately even after power-off.

# Example configuration entry
sensor:
  - platform: ags10
    id: ags10_1_id
    # ...

# in some trigger
on_...:
  - ags10.new_i2c_address:
      id: ags10_1_id
      address: 0x1E

Configuration options:

id (Required, ID): The ID of the AGS10 sensor.
address (Required, int): New I2C address.