AirGradient API Binding

logo

AirGradient provide open source and open hardware air quality monitors.

This binding reads air quality data from the the AirGradient (https://www.airgradient.com/) API.

This API is documented at Swagger UI

Please check out the README file for documentation on how to use the add-on.

Tested on OpenHAB v4.1.1

Changelog

Version 1.1 (2024-05-19)

  • Support local configuration for firmware version 3.1.1

Version 0.12 (2024-05-17)

  • The version that went into the official repository

Version 0.11 (2024-05-08)

  • Discover model
  • Discover local devices without the need for a bridge (less things)

Version 0.10 (2024-04-29)

  • Background (automatic) detection of sensors
  • Improved efficiency after heavy reviews

Version 0.9 (2024-04-27)

  • Added a “boot” channel which shows number of uploads since last reboot. Strange name, but kept in line with name used in AirGradient as it is often used for troubleshooting.

Version 0.8 (2024-04-27)

  • Changed to system types for temperature and humidity

Version 0.7 (2024-03-09)

  • Supports mDNS autodiscovery on beta devices(*)
  • Support reading and setting LED mode for cloud devices
  • Support triggering CO2 calibration for cloud devices

(*) If firmware is changed to only publish _airgradient service on port 80

Version 0.6

  • Bugfixes for local connections
  • Tested against I-9PSL running beta firmware v3.0.6
  • Updated documentation

Version 0.5

Version 0.4

  • Supports Prometheus format for locally access to air gradients

Version 0.3

  • Supports location discovery
  • Tested with O-1PST
  • Tested with I-9PSL

Version 0.2

  • Tested with many more devices
  • Support rco2
  • Support tvoc
  • Support reading single values (e.g. directly from sensors with firmware with a local web server)

Version 0.1

  • initial release
  • supports the most used data from the AirGradient API
  • tested with O-1PP

Resources

Binaries:
https://github.com/austvik/openhab-addons/releases/download/1.1/org.openhab.binding.airgradient-4.2.0-SNAPSHOT.jar

Source code:

4 Likes

How can I change the firmware to publish the _airgradient service?

To answer my own question, this is default with firmware 3.0.9 (and probably 3.0.8). :slight_smile: