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 ReleaseChanges:
| |
Version 3.1.9 ReleaseChanges:
| |
Version 3.1.4 ReleaseChanges:
| |
Version 3.1.3 ReleaseNew features:
| |
Version 3.1.1 ReleaseNew features:
Breaking API Change: Temperature and humidity correctionMoved 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. | |
Version 3.0.9 ReleaseNew features:
|
AirGradient ONE Firmware

Version 3.0.8 ReleaseThis firmware is compatible for AirGradient ONE 9th Generation (I-9PSL). New features:
| |
Version 3.0.7 ReleaseThis firmware is compatible for AirGradient ONE 9th Generation (I-9PSL). New features:
| |
Version 3.0.6 ReleaseThis firmware is compatible for AirGradient ONE 9th Generation (I-9PSL). New features:
| |
Version 3.0.5 BetaThis firmware is compatible for AirGradient ONE 9th Generation (I-9PSL). New features:
Details to new features see information below. | |
Version 3.0.4 BetaThis firmware is compatible for AirGradient ONE 9th Generation (I-9PSL). New features:
Details to new features see information below. | |
Version 3.0.1 BetaFirmware for AirGradient ONE (I-9PSL) Version 3.0.1 (16FEB24) | |
Version 2.4.15 OfflineFirmware for AirGradient ONE (I-9PSL) Version 2.4.15 Offline This version only works offline. |
AirGradient Open Air Firmware

Version 3.0.8 ReleaseThis firmware now works for all Open Air models (O-1PST, O-1PPT and O-1PP). New features:
| |
Version 3.0.7 ReleaseThis firmware now works for all Open Air models (O-1PST, O-1PPT and O-1PP). New features:
| |
Version 3.0.6 ReleaseThis firmware now works for all Open Air models (O-1PST, O-1PPT and O-1PP). New features:
| |
Version 3.0.5 BetaThis firmware now works for all Open Air models (O-1PST, O-1PPT and O-1PP). New features:
Details to new features see information below. | |
Version 3.0.4 BetaThis firmware now works for all Open Air models (O-1PST, O-1PPT and O-1PP). New features:
Details to new features see information below. |
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
}
The local API documentation can be found here.
mDNS
Supports mDNS. You don’t need to know the local IP address and can also poll with this URL structure:
http://airgradient_ecda3b1eaaaf.local/measures/current
“ecda3b1eaaaf” being the serial number of your monitor
TVOC Raw Signal
We are now also logging the TVOC raw signal from the SGP41 sensor. This data is currently not available on the dashboard but in the data export.
Repository & Bug Reports
The open-source code is accessible on the AirGradient GitHub Arduino. Please submit issues directly there.
Feature Discussions
For more general feature discussions, please use the AirGradient Forum.
Logging Instructions
Follow below to see debug messages and logs of the monitor:
- Plug in the USB C cable
- Press the blue button above
- Select the serial port your monitor is connected to. It is typically called “USB JTAG / Serial Debug”
- Click on “Logs & Console”
- Click on “Reset Device” to reboot the monitor
Experimental Firmware
Version 3.1.0For testing upgrade to 3.1.1 |