https://github.com/hypfer/airgradient-cloud-free

Airgradient air quality sensor cloud replacement and firmware modifications
https://github.com/hypfer/airgradient-cloud-free

Last synced: 4 months ago
JSON representation

Airgradient air quality sensor cloud replacement and firmware modifications

• Host: GitHub
• URL: https://github.com/hypfer/airgradient-cloud-free
• Owner: Hypfer
• Created: 2024-01-02T20:30:10.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2024-01-03T12:15:17.000Z (over 2 years ago)
• Last Synced: 2025-07-09T12:52:53.588Z (11 months ago)
• Language: C++
• Homepage:
• Size: 135 KB
• Stars: 10
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# airgradient - cloud-free

This repository contains a drop-in cloud replacement for airgradient sensors that takes the data and publishes it to MQTT

providing Home Assistant autodiscovery metadata. The only to-do being to redirect the DNS.

It provides the experience I _thought_ I would be getting when I bought these sensors that were marketed to me as being

"the open solution" that you'd want to get because things just work ootb cloud-free. Well, that wasn't the case. But now it is.

It further contains custom firmwares that implement additional functionality in combination with this mock cloud.


That functionality being:

- The ability to reset wifi credentials (at all)

- The ability to change the brightness of the V9 LED Bar and OLED Display (for not using it as a night light)

Conceivably, additional functionality such as e.g. triggering the manual CO2 Sensor calibration could be added in the future.

## airgradient2mqtt

![hass_demo.png](./img/hass_demo.png)

A simple mock cloud implementation that takes the data and pushes it to mqtt.

Provides Home Assistant Autodiscovery. 

It should work with the stock firmware, but if you want to send commands to the sensor, you need these customized ones.

See [./airgradient2mqtt/Readme.md](./airgradient2mqtt/Readme.md) for more information

## Firmware

based on https://github.com/airgradienthq/arduino with input from https://github.com/lschloetterer/airgradient-one-v9

Changes:

- The cloud can send commands to the sensor on each data push

  - Reboot

  - Reset WiFi

  - Set RGB Strip brightness (for the V9)

  - Set OLED brightness (for the V9)

- APIROOT URL set to `airgradient.internal`

- (V9 Only) RGB strip shows gradual changes in CO2 value by calculating hue dynamically