2024.12.5
Home ▸ Integrations ▸

Awair

The Awair integration will fetch data from your Awair devices.

Prerequisites

Connect locally (preferred)

When connecting locally, the integration will poll the device every 30 seconds. Awair provides a list of devices that support the Local API. This API must be enabled via the Awair app via these steps. If you add new Awair devices to your home, you must follow these steps again.

Connect via the cloud

When connecting via the cloud, data is summarized over 5-minute intervals. All devices are supported. You will need to request access to the Awair API and obtain an access token from the Awair Developer Console. It is free, but getting a token can take up to 24 hours.

This integration refreshes once every 5 minutes, based on the default per-device quota of 300 API calls per day.

Configuration

To add the Awair integration to your Home Assistant instance, use this My button:

Awair can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Manual configuration steps

If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:

Available sensors

The integration will fetch data from each device. The following sensors are supported:

  • Temperature
  • Humidity
  • Carbon dioxide
  • Total volatile organic compounds
  • PM2.5 density
  • PM10 density
  • Sound level
  • Luminescence

Not all devices support all sensors; consult Awair’s documentation to find out what sensors are present on your device. For first-generation Awair devices with a “dust” sensor, the integration will create identical PM2.5 and PM10 sensors (which reflects the capabilities of the sensor - it can detect dust between PM2.5 and PM10 but cannot differentiate between them).