4.0.7

What's Changed

• fix algorithm to reference raw humidity value by @MallocArray in #93

Full Changelog: 4.0.6...4.0.7

4.0.6

What's Changed

• Increase bit depth on largest font for anti-aliasing by @MallocArray in #89
• Update version number by @MallocArray in #90
• Update full configs by @MallocArray in #91

Full Changelog: 4.0.5...4.0.6

4.0.5

What's Changed

• fix sensor_pms5003t_2_extended_life.yaml by @danielgivelify in #82
• Removing "AQI" unit for PM 2.5 AQI sensor by @Qhilm in #77
• Removing "AQI" unit for extended life PM 2.5 AQI sensor by @Qhilm in #78
• Remove unit_of_measurement: "AQI" by @MallocArray in #85
• Add insecure API package by @MallocArray in #86

New Contributors

• @danielgivelify made their first contribution in #82
• @Qhilm made their first contribution in #77

Full Changelog: 4.0.4...4.0.5

4.0.4

What's Changed

• Switch API calls to use https by @MallocArray in #75
• Update AQI breakpoints by @MallocArray in #76
• Rename watchdog ID to external_watchdog to avoid conflict in ESPHome 2024.8.0

Full Changelog: 4.0.1...4.0.4

4.0.1

Prevent PM 2.5 values from going negative in some situations with correction algorithm

4.0.0

• Support for ESPHome 2024.6 and later
• Added extended timeout for API upload on ONE and OpenAir models to reduce reboots
• Applied correction algorithms for PM2.5 provided by AirGradient
  • https://www.airgradient.com/documentation/correction-algorithms/
• Updated API upload to follow current structure including both raw and corrected values
• Moved config_version substitution into the board package so it can be updated without manual change to main config file. Please remove the line starting with config_version: from your personal files
• Split captive portal config to a separate package. Can be removed if not using the portal or if defining wifi networks in your config file, which results in a small memory savings
• Removed safe_mode package by default. Very few use cases for it
• Added commented out packages for extended_life configs to make it easier to enable if desired
• Added commented out package for SHT30 temp sensor in AG Pro file to make it easier to switch to if desired
• Added new sensor options for raw values for PM2.5, temp, and humidity in some device configurations, and added AirGradient provided correction algorithms to the standard sensors
• AG DIY Basic display config changed to same font as other models, downloading from gfonts instead of using local file

2.0.5

• Added page that describes all optional packages (packages.md)
• LED combo package. Left 5 LEDs reflect CO2 levels, middle 5 LEDs reflect PM2.5 levels, far right indicates VOC. (Same as display)
• LED bar configs feature a "LED Fade" parameter that controls the percentage that the LED bar dims out from the center
• Blank Page switch now disables the display, regardless of other pages still enabled.
• CO2 package supports optional substitution co2_offset to offset reported readings by a set amount. Useful if sensor is known to be off by a certain amount, or if wanting to override default calibration of 400 ppm
• Capped Outdoor models Humidity percentage to 100, as correction algorithm can exceed these in some circumstances
• Add optional package to calculate Nowcast and AQI values on device
• Update API values sent to AirGradient to match current firmware 3.1.1
• Added extended life package for second PM2.5 sensor in Outdoor O-1PPT models (Caution, this may impact accuracy of temperature and humidity, as the internal fan is not running continuously)

Full Changelog: 2.0.1...2.0.5

2.0.1

• Add config file for Outdoor Open Air model O-PPT1 with dual PMS5003T sensors with AirGradient researched temperature and humidity compensation for these sensors in the Outdoor enclosure.

Can change the package for pm_2_5 to sensor_pms5003t_uncorrected.yaml to continue using the uncorrected values

• Fix AQI sensor not reporting for 50 minutes after a reboot. Will now be 5 minutes after boot

2.0.0

Breaking Changes

In the 2.x release of these configurations, some breaking changes are introduced

• See previous 1.x release breaking changes if coming from earlier versions
• Changed name_add_mac_suffix to false by default. This will no longer add the MAC address to the end of the device name. Assists ESPHome in properly detecting new device as Online without a static IP. Can be changed to true if desired. Ensure all devices have unique name: fields if false.
• Changed the variable names in the substitutions: section to have them match the ESPHome parameters they are used with.
• Changed to config_version: substitution name for a shorter name
• Disabled Upload to AirGradient Dashboard by default, but able to flip the switch in HomeAssistant to enable if desired

Changes

• Added Display Contrast slider to dim the display
• Added device_class to the PMSx005 sensors to have them properly reflect in the HomeKit integration if supported (Forum Link)
• Added optional Factory Reset switch that is disabled by default. Can be enabled in HomeAssistant and used if desired
• Added optional diagnostic.yaml package with extra sensors about the ESP device itself, including temperature and free
• Added optional sensor_bme680.yaml package to support the BME680 module if desired
• Added dashboard_import to assist discovery of new devices installed with the pre-compiled .bin files

1.0.0

Splits up configuration into individual files in the 'packages' directory and are referenced through their GitHub address by default. See the README.md file for more information in the Configuration section.

Features

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 (No recommended for devices based on the D1 Mini ESP8266)

• Compact single page display by default with all relevant sensor readings

• 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 automations in HomeAssistant to turn on the "Blank" page and turn off all other pages 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

Breaking Changes

• The devicename has been shortened from "airgradient-*" to "ag-". This matches the Friendly Name convention and results in a shorter overall devicename. You may keep yours at the longer full name if desired, but for the Open Air, the name became longer than allowed
• Substitution entry for "friendly_devicename" has been renamed to "friendly_devicename" to better match it's use case instead of the legacy use
• The name of the CO2 sensor has been changed to just "CO2" from the previous "Senseair S8 CO2" to shorten overall sensor name length and match other sensors that are named for what they are measuring and not the name of the sensor itself. This will result in a new sensor registered to your device in HomeAssistant and the previous one will be "Unavailable". You may need to update any graphs or other dashboard entries with the new CO2 entry
• New switch added to enable/disable Automatic Background Calibration of the Senseair S8 CO2 sensor. If previously disabled, on the first install of the 1.x config, it will be enabled again. Disable after installation if desired.