AirGradient ONE (I-9PSL) and Open Air (O-1PST) Firmware Versions
Please note that these firmware versions do not support the D1 mini (ESP8266) based models DIY Pro or Basic kit but we currently work on an update that will bring as many as possible of the new features to the D1 mini.
Flashing Instructions
Important. Please follow these steps for flashing only. If you only want to see debug messages and logs of the monitor see the instructions for
logging.
Push the button on the PCB and keep it pushed
Plug in the USB C cable
Release the button. If you do not do this, the board will not get into the flash mode.
Click the blue Flash Now button next to the firmware version you want to install
Select the serial port your monitor is connected to. It is typically called “USB JTAG / Serial Debug”
Follow the instructions for flashing
After the flashing is complete, restart the monitor by unplugging the USB C cable (and plugging it back in)
Combined Firmwares
New firmware version that runs on both the AirGradient ONE I-9PSL and the Open Air O-1PST and O-1PP(T) models.
Version 3.1.13 Release
Changes:
Shows compensated PM values on display
Updated AQI breakpoints
Various smaller improvements
Your browser doesn't support this. Please use Chrome or Edge on Mac or PC.You are not allowed to use this on HTTP!
Version 3.1.9 Release
Changes:
Fixed PMS read errors in low concentrations
Fixed reboots when monitor not setup on AirGradient dashboard
Update hardware watchdog reset
Added configuration "monitorDisplayCompensatedValues" for future display of compensated values
Your browser doesn't support this. Please use Chrome or Edge on Mac or PC.You are not allowed to use this on HTTP!
Version 3.1.4 Release
Changes:
Reconnect to WiFi automatically after power / internet outages
Fixed error message when changing configuration source from Home Assistant
Fixed rawVOC and rawNOx on local server
Improved log messages
Your browser doesn't support this. Please use Chrome or Edge on Mac or PC.You are not allowed to use this on HTTP!
Version 3.1.3 Release
New features:
Fixed LED Brightness for low settings
Removed server and WiFi errors in offline mode
Added periodic check for new OTA update
Fixed CO2 color code to match dashboard
Fixed firmware version reporting to server
After 180s not connected, device reboots
Improved log messages
Your browser doesn't support this. Please use Chrome or Edge on Mac or PC.You are not allowed to use this on HTTP!
Version 3.1.1 Release
New features:
Over the air (OTA) updates. New versions of the firmware will be automatically downloaded and installed.
Added noxLearningOffset and tvocLearningOffset configuration for changing the behavior of the SGP41 sensor.
Added brightness settings for day/night for LED bar and display. In case display is off after flashing, please adjust it on our dashboard Place Settings.
Moved all dependent libraries into project structure.
Add 'Prevent Connection to AirGradient Server' checkbox to WiFi Manager to not allow any connection with the AirGradient cloud. Only use if you do not want to access the AirGradient dashboard and if you do not want to share your outdoor data with OpenAQ. All local configurations are still possible even with using the AirGradient cloud.
Many bug fixes.
Breaking API Change: Temperature and humidity correction
Moved temperature and humidity correction to separate properties called atmp_compensated and rhum_compensated. As a result atmp and rhum properties do not contain compensated values anymore but the raw values measured. This only affects AirGradient Open Air outdoor models. 3rd party integrations like ESPHome or openHAB need to be updated. Sorry for the inconvenience!
The reason for this change was that we had a mix of raw values from the sensor modules and corrected values. We foresee that we need to develop a number of additional correction values e.g. for PM and probably also regularly adjust and improve these algorithms. So having them in the firmware makes this very difficult and handling it server side much easier.
Your browser doesn't support this. Please use Chrome or Edge on Mac or PC.You are not allowed to use this on HTTP!
Version 3.0.9 Release
New features:
Combined firmware for AirGradient ONE and Open Air
Fixed LED mode in offline mode
Changed Partition size to prepare for OTA
Your browser doesn't support this. Please use Chrome or Edge on Mac or PC.You are not allowed to use this on HTTP!
AirGradient ONE Firmware
Version 3.0.8 Release
This firmware is compatible for AirGradient ONE 9th Generation (I-9PSL).
New features:
Fixed -1 readings on PM module
Disabled reboots in offline mode
Fixed mDNS double broadcast
Various small bug fixes
Your browser doesn't support this. Please use Chrome or Edge on Mac or PC.You are not allowed to use this on HTTP!
Version 3.0.7 Release
This firmware is compatible for AirGradient ONE 9th Generation (I-9PSL).
New features:
Added mDNS AirGradient broadcast
Display serial number if not added to dashboard
Improved texts on display and logs
Your browser doesn't support this. Please use Chrome or Edge on Mac or PC.You are not allowed to use this on HTTP!
Version 3.0.6 Release
This firmware is compatible for AirGradient ONE 9th Generation (I-9PSL).
New features:
Fixed SHT not always updating
Changed mDNS board to model
Faster display update
Your browser doesn't support this. Please use Chrome or Edge on Mac or PC.You are not allowed to use this on HTTP!
Version 3.0.5 Beta
This firmware is compatible for AirGradient ONE 9th Generation (I-9PSL).
New features:
Fixed NOx not sent to server
Factory Reset (long press button)
Improved PM polling
Additional mDNS attributes
Added support for OpenMetrics
Details to new features see information below.
Your browser doesn't support this. Please use Chrome or Edge on Mac or PC.You are not allowed to use this on HTTP!
Version 3.0.4 Beta
This firmware is compatible for AirGradient ONE 9th Generation (I-9PSL).
New features:
MQTT Support
ABC period for SenseAir S8
Local polling support
TVOC raw
Display warns of unrecognized sensor modules
Details to new features see information below.
Your browser doesn't support this. Please use Chrome or Edge on Mac or PC.You are not allowed to use this on HTTP!
Version 3.0.1 Beta
Firmware for AirGradient ONE (I-9PSL) Version 3.0.1 (16FEB24)
Your browser doesn't support this. Please use Chrome or Edge on Mac or PC.You are not allowed to use this on HTTP!
Version 2.4.15 Offline
Firmware for AirGradient ONE (I-9PSL) Version 2.4.15 Offline
This version only works offline.
Your browser doesn't support this. Please use Chrome or Edge on Mac or PC.You are not allowed to use this on HTTP!
AirGradient Open Air Firmware
Version 3.0.8 Release
This firmware now works for all Open Air models (O-1PST, O-1PPT and O-1PP).
New features:
Fixed -1 readings on PM module
Fixed mDNS double broadcast
Various small bug fixes
Your browser doesn't support this. Please use Chrome or Edge on Mac or PC.You are not allowed to use this on HTTP!
Version 3.0.7 Release
This firmware now works for all Open Air models (O-1PST, O-1PPT and O-1PP).
New features:
Added mDNS AirGradient broadcast
Fixed bug for O-1PS model
Improved texts in logs
Your browser doesn't support this. Please use Chrome or Edge on Mac or PC.You are not allowed to use this on HTTP!
Version 3.0.6 Release
This firmware now works for all Open Air models (O-1PST, O-1PPT and O-1PP).
New features:
Changed mDNS board to model
Your browser doesn't support this. Please use Chrome or Edge on Mac or PC.You are not allowed to use this on HTTP!
Version 3.0.5 Beta
This firmware now works for all Open Air models (O-1PST, O-1PPT and O-1PP).
New features:
Factory Reset (long press button)
Improved PM polling
Added humidity compensation formula for PMS5003T
Additional mDNS attributes
Details to new features see information below.
Your browser doesn't support this. Please use Chrome or Edge on Mac or PC.You are not allowed to use this on HTTP!
Version 3.0.4 Beta
This firmware now works for all Open Air models (O-1PST, O-1PPT and O-1PP).
New features:
MQTT Support
ABC period for SenseAir S8
Local polling support
TVOC raw
Details to new features see information below.
Your browser doesn't support this. Please use Chrome or Edge on Mac or PC.You are not allowed to use this on HTTP!
New Features in 3.0.x
MQTT
To use MQTT, you need to set the broker address on the AirGradient dashboard under Place Administration, Connectivity. You can use basic authentication with this format: “mqtt://username:password@my.broker.com:4711”
The MQTT address is then persistently saved on the monitor and thus should continue working even if the AirGradient servers are not available.
ABC period for SenseAir S8
By default the SenseAir S8 CO2 sensor does an automatic calibration every 7 days. In some cases, e.g. when you have a very air tight house, it is recommended to increase the ABC period. This can also be done on the AirGradient dashboard here in section “Set automatic baseline calibration”.
Local Polling
You can now poll air quality data within your local network by making a request in the form of "http://192.168.1.21/measures/current" and you will get the following json object as response "{"wifi":-48,"boot":0,"serialno":"dc5475b2xxx0","rco2":422,"pm01":9, "pm02":15,"pm10":16,"pm003_count":1560, "atmp":24.65,"rhum":47,"tvoc_raw":33025}"