Awair Air Quality Monitor


The awair sensor platform will fetch data from your Awair device(s).

You will need to request access to the Awair API and obtain an access token from the Awair Developer Console.

Configuring the Platform

To enable these sensors, add the following lines to your configuration.yaml file:

sensor:
  - platform: awair
    access_token: ACCESS_TOKEN

The Awair API has stringent usage quotas. The API method to discover devices in your account is limited to only 6 calls per 24 hours. If you find that you’ve exceeded this quota, you may optionally append device information to your configuration to bypass this call:

sensor:
  - platform: awair
    access_token: ACCESS_TOKEN
    devices:
      - uuid: UUID

Configuration Variables

access_token

(string)(Required)

The access token for the Awair API.

devices

(list)(Optional)

An optional list to manually configure devices rather than relying upon API discovery.

uuid

(string)(Required)

UUID of the Awair sensor to monitor.

Available Sensors

The platform will fetch all available sensors from each Awair device linked to your account. Supported sensors:

  • Temperature
  • Humidity
  • CO2
  • VOC
  • Dust, PM2.5, PM10: varies according to Awair model

This platform refreshes at an interval based on a 300 API call per-day quota, and the number of devices you have configured.