PurpleAir for Home Assistant (built-in integration)

About

PurpleAir is a built-in integration that tracks air quality readings from PurpleAir sensors in Home Assistant. It adds sensors for particle count concentrations at several sizes, a volatile organic compounds air quality index, signal strength and uptime. Sensors are found by searching within a radius around a latitude and longitude, then picking the ones to track. Setup is done in the UI with a PurpleAir API key, and the read key should be used if both read and write keys exist. Afterwards, the options let sensors be added or removed, and configured sensor locations can be shown on the map. Data comes through the vendor's cloud, and a diagnostics file can be downloaded for bug reports.

Automatic summary of Home Assistant's source code. Something wrong? Get in touch

Supports

Uses the vendor's cloud Needs an internet connection and an account with the vendor.
Set up in the UI Add it in Settings, Devices and services. Nothing to download.
Updated with Home Assistant Ships and updates with every Home Assistant release.

Provides

Sensors

Setting it up

It is added under Settings, Devices and services, with Add integration.

Connect

API keyYour PurpleAir API key (if you have both read and write keys, use the read key)

Also asked when signing in again.

By coordinates

Search radiusThe radius (in kilometers) of the circle to search within
LatitudeThe latitude around which to search for sensors
LongitudeThe longitude around which to search for sensors

Choose sensor

SensorThe sensor to track

After setup

Search radiusThe radius (in kilometers) of the circle to search within
LatitudeThe latitude around which to search for sensors
LongitudeThe longitude around which to search for sensors
SensorThe sensor to track
Sensor nameThe sensor to remove
Show configured sensor locations on the map

Texts from Home Assistant's source code, Apache License 2.0.

Entities

SensorsPM0.3 count concentration, PM0.5 count concentration, PM10.0 count concentration, PM1.0 count concentration, PM2.5 count concentration, PM5.0 count concentration, RSSI, Uptime, Volatile organic compounds air quality index