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
Adding Awair to your Home Assistant instance can be done via the user interface, by using this My button:
Awair can be auto-discovered by Home Assistant. If an instance was found, it will be shown as “Discovered”, which you can select to set it up right away.
If there wasn’t any discovered automatically, don’t worry! You can set up a manual integration entry:
-
Browse to your Home Assistant instance.
-
In the sidebar click on Settings.
-
From the configuration menu select: Devices & Services.
-
In the bottom right, click on the Add Integration button.
-
From the list, search and select “Awair”.
-
Follow the instruction on screen to complete the set up.
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).