The AirGradient ONE Offline Firmware for Model I-9PSL

Introduction

This is a special firmware in case you want to operate the AirGradient ONE without WiFi connection. It will then just display the air quality on the display and LED bar. The display and LED bar are configurable (see below).

In order to use the offline software, it needs to be flashed onto the device one time. Please follow the instructions below.

Flashing of the Firmware

Please follow the instructions below. Make sure you use the Chrome or Edge browsers on your computer for this to work. It does not work from mobile.

Connect the monitor to your computer through a data-capable cable (like the one that came with the device)
Press the blue button below
Select the serial port your monitor is connected to. It is typically called “USB JTAG / Serial Debug”
Press “Install AirGradient ONE …”
Check the box ‘Erase device’ and press Next and Install
Once the flashing is complete, the monitor will reboot automatically

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!

BOOT Error During Flashing

In case you get an error called “Failed to initialize. Try resetting your device or holding the BOOT button while clicking INSTALL” during the flashing, you need to put the monitor into a special boot mode. To do this please follow below steps:

Push the button labelled "BOOT SW" on the PCB and keep it pushed. This is also the button behind the small hole next to the USB connector on the enclosure. So if you don't want to open the enclosure you can also press it with a small screwdriver through the enclosure.
Plug in the USB C cable
Release the button. If you do not do this, the board will not get into the flash mode.
Press the blue button above
Select the serial port your monitor is connected to. It is typically called “USB JTAG / Serial Debug”
Follow the instructions for flashing. In case you want to delete previously saved WiFi passwords on the device, check the box 'Erase the Device'.
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:

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

Now you can see the debug messages and also identify the serial number.

Configuration

The following features of the monitor can be configured:

Unit of temperature (°C or °F)
LED bar on or off
PM2.5 in μg/m³ or US AQI
CO2 baseline calibration

These configuration parameters need to be set on the monitor itself. There is a button behind the small hole next to the USB plug. When you boot the device and see the message “Press button to configure”, press the button and it will enter a configuration menu.

Use short press until you find the configuration you like. Long press the button to save and reboot.

You can set the unit for PM2.5 (μg/m³ or US AQI) and the temperature unit (°C or °F).

In case you want to disable the RGB LED bar you can do so as well, e.g. if it disturbs in the night.

The following configurations are available:

Configuration Number	Temperature	PM Unit	RGB LED bar
1	°C	ug/m3	on
2	°C	US AQI	on
3	°F	ug/m3	on
4	°F	US AQI	on
5	°C	ug/m3	off
6	°C	US AQI	off
7	°F	ug/m3	off
8	°F	US AQI	off

Trouble Shooting

Here is a list of common issues and how to resolve them.

Behavior	Potential Reason	Fix
TVOC shows 0	Sensor module not warmed up yet.	The TVOC module needs around 1-2 minutes to warm up before it shows values.
TVOC shows 0	NOx module not very sensitive.	In most cases NOx is around 0 or 1. Only in cases of very high concentrations it will rise above that.
PM shows 0	Very good air quality.	It is not uncommon to have very good air quality and to have 0 PM. If you are unsure if your PM sensor works, create a bit of smoke e.g. with a candle and check if the PM goes up.

CC BY-SA 4.0 Attribution-ShareAlike 4.0 International

This work is licensed under CC BY-SA 4.0.

This license requires that reusers give credit to the creator. If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.