We use cookies on this website to give you the best experience. To find out more, read our Privacy Policy.

Firmwares

Combined Firmwares

New firmware version that runs on both the AirGradieny ONE I-9PSL and the Open Air O-1PST models.

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}”

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.

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:

  1. Push the button on the PCB and keep it pushed
  2. Plug in the USB C cable
  3. Release the button. If you do not do this, the board will not get into the flash mode.
  4. Press the blue button above
  5. Select the serial port your monitor is connected to. It is typically called “USB JTAG / Serial Debug”
  6. Follow the instructions for flashing
  7. After the flashing is complete, restart the monitor by unplugging the USB C cable (and plugging it back in)

Logging Instructions

Follow below to see debug messages and logs of the monitor:

  1. Plug in the USB C cable
  2. Press the blue button above
  3. Select the serial port your monitor is connected to. It is typically called “USB JTAG / Serial Debug”
  4. Click on “Logs & Console”
  5. Click on “Reset Device” to reboot the monitor

Experimental Firmware

Version 3.1.1

Test version primarily for OTA update.

New features:

  • Implemented over the air (OTA) update. After flashing and getting WiFi connection, this version will automatcally update to 3.1.2. In this version, the update check will only be performed on power on of the monitor.
  • Add 'Post Data 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.
  • Added noxLearningOffset and tvocLearningOffset configuration for changing the behavior of the SGP41 sensor.
  • Added /docs folder with local API documentation
  • Added platform I/O compatability.
  • Moved all dependent libraries into project structure.
  • Various 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.10Beta 2

New features:

  • Moved temperature and humidity correction formula for Open Air to properties atmpCompensated and rhumCompensated. Atmp and rhum now contain raw values.
  • Made all properties more consistent in CamelCase.
  • The local API documentation can be found here.
 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.10Beta

New features:

  • Local Configuration
 Your browser doesn't support this. Please use Chrome or Edge on Mac or PC. You are not allowed to use this on HTTP!