ESPHome yaml files for AirGradient devices to maintain the research and accuracy of AirGradient sensors, while also gaining the benefits of ESPHome/HomeAssistant for easy to use switches, buttons, configurations, and dashboards, all controlled locally. Maintains the ability to also send data to the AirGradient Dashboard, which can also be disabled/removed to keep all data local.
List of available packages to customize your device and gain additional features
- 5.0.0 is a major version upgrade as switching to esp-idf is not fully supported via OTA. Highly recommend doing one USB flash of 5.0.0 and later to the AirGradient ONE and OpenAir devices to reformat the storage to support esp-idf. Future updates can be done Over-The-Air without issue.
- If not done, the device is likely to reboot at some point and switch to the standby partition, returning to a version prior to 5.0.0
- Seeing an Old Firmware Version After Update? Here's Why & How to Fix It · Issue #1821 · Blackymas/NSPanel_HA_Blueprint
- Read/Write bootloader, partition table and any partition via OTA by angelnu · Pull Request #5535 · esphome/esphome
- Added optional substitutions to implement batch-specific PM2.5 corrections using values provided by AirGradient See details in the packages.md file under the PMS5003 section.
- Restored logging to default values as it no longer repeats messages about components taking too long to complete
- New package for upgrading DIY and Pro models to Lolin C3 Mini
Replacing the line that starts with led_co2 with led_combo: !include packages/led_combo.yaml enables combo LED bar. For more information, look at the Packages file.
Many added features can be found in HomeAssistant by going to Settings>Devices and selecting the AirGradient device. Alternatively, add web_server: to the config file to enable a built-in web server on the AirGradient device (Not recommended for devices based on the D1 Mini ESP8266)
-
Compact single page display by default with all relevant sensor readings
-
Display Contrast slider to dim the display
-
Enable different pages of information to be shown on the OLED display, or leave the default of a single page with all relevant information
-
Button to initiate a SenseAir S8 CO2 Calibration on demand
-
Switch to enable or disable SenseAir S8 CO2 sensor Automatic Baseline Calibration (ABC)
-
Button to view the current S8 ABC interval (confirm if ABC is disabled or enable, which defaults to every 7 days) View ESPHome logs to see the output of this button
-
Switch to disable LED output on AirGradient ONE model
-
Brightness slider to adjust intensity of AirGradient ONE LED
-
Switch to toggle display between Fahrenheit and Celsius and persist between reboots
-
Switch to enable or disable uploading to AirGradient Dashboard via API (Choose to keep data local or also send to AirGradient)
-
Utilize hardware configuration buttons on AirGradient Pro v3.7 and higher
- Short press (Less than 1 second) - Toggle between F and C on display
- Long press (More than 1 second, less than 5) - Trigger manual CO2 calibration
-
Leverage automation in HomeAssistant to turn on the "Blank" page to effectively disable the display output. Could also turn off the LED strip or set Brightness to 0 to eliminate output while still collecting sensor data
More features are planned to be added to this repo
- Deprecate Extended Life packages and use a substitution to allow for adjusting update_interval