air-Q

The air-Q integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows integrating the sensors, provided by your air-Q device, into Home Assistant.

Configuration

To add the air-Q hub to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

During the initial configuration, the user is prompted for the IP address of the deviceA device is a model representing a physical or logical unit that contains entities. or the first 5 characters of the serial number, as well as the device password.

For this integration to communicate with the device, both must be connected to the same Wi-Fi network.

After the setup, separate entitiesAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more] will be created for each of the sensorsSensors return information about a thing, for instance the level of water in a tank. [Learn more], found in your deviceA device is a model representing a physical or logical unit that contains entities..

Sensors

Currently, the integration supports the following sensors:

Sensor name Unit of measurement
Acetaldehyde µg/m³
Ammonia µg/m³
Arsine µg/m³
Bromine µg/m³
CH4S µg/m³
Chlorine µg/m³
ClO2 µg/m³
CO mg/m³
CO2 ppm
CS2 µg/m³
Dew Point °C
Ethanol µg/m³
Ethylene µg/m³
Formaldehyde µg/m³
F2 µg/m³
H2S µg/m³
HCl µg/m³
HCN µg/m³
HF µg/m³
Health Index %
Humidity (relative) %
Absolute Humidity g/m³
Hydrogen µg/m³
Hydrogen Peroxide µg/m³
Methane %
N2O µg/m³
NO µg/m³
NO2 µg/m³
Organic Acid ppb
Oxygen µg/m³
Ozone µg/m³
Performance Index %
PH3 µg/m³
PM1, PM25, PM10 µg/m³
Pressure hPa
Relative Pressure hPa
Propane %
Refrigerant µg/m³
SiH4 µg/m³
SO2 µg/m³
Noise dBa
Noise (Maximum) dBa
Radon Bq/m³
Temperature °C
Virus Index %
VOC ppb
VOC (Industrial) ppb

PM1, PM25, and PM10 correspond to concentrations of particulates with diameter less than 1µm, 2.5µm, and 10µm respectively

Virus Index uses CO2 as a proxy for potential aerosol load and can be seen as an indicator of ventilation sufficiency (0 %: insufficient ventilation, 100 %: all fine).

Virtual sensors “Relative Pressure” and “Virus Index” are introduced in firmware v1.80.0 but deactivated by default. You can activate them in the air-Q mobile application under “Advanced settings”.

Additional configuration

After the integration has been initialized, the user can configure any of the following two parameters:

  • Show values averaged by the device. Default: on. In its default configuration, air-Q averages the stream of sensor values. The strength of this averaging can be configured on the device side (not exposed through the HA). However, this integration allows to switch between polling the averaged and the raw data from the device. To poll noisy sensor readings from the device, set Show values averaged by the device to off.

  • Clip negative values. Default: on. For baseline calibration purposes, certain sensor values may briefly become negative. The default behavior is to clip such values to 0.