AirGradient Monitor Firmware Updates
AirGradient Monitor Firmware Updates
AirGradient ONE - Firmware Update
This page provides everything you need to manually update the firmware on your AirGradient ONE (I-9PSL-DE, I-9PSL-DE-CE)
Video Guide: AirGradient ONE - How to Flash Firmware
Before you begin, you need:
- A computer (Windows, macOS, Linux) with a supported browser.
Firmware flashing requires a Chromium-based browser. One of the following browsers will work:
- Google Chrome
- Microsoft Edge
- Chromium (Linux)
Note: The Flash button will NOT appear on Safari, Firefox, or any non-Chromium browser.
- A USB-C cable that supports data transfer (not charge-only). The cable that comes with the monitor will work.
- A tool (paperclip, toothpick, small screwdriver) that fits through the pin hole on the back of the device to reach the BOOT button. This is because the BOOT button is on the mainboard inside the enclosure.
Follow the steps below carefully to ensure a successful update.
Step 1: Enter Flash Mode
- Press and HOLD the BOOT button on the back of the AirGradient ONE:
- While holding the BOOT button, plug in the USB-C cable:
- Release the BOOT button AFTER the USB-C cable is plugged in.
Note: Ensure the correct sequence is followed:
Press and hold BOOT button → plug USB cable → release BOOT button.If done correctly, the device will appear off (no screen, no LEDs). This is normal.
Step 2: Start the Flashing Tool
Click the button below:
If the blue “FLASH NOW” button above is not visible, this usually either means you’re accessing the webpage using a non-Chromium browser or the browser is blocking WebSerial. Try the following:
- Use Google Chrome, Microsoft Edge or any other Chromium- based browser.
(Safari and Firefox do not support WebSerial)
- Disable any script-blocking extensions (uBlock Origin, NoScript, etc.)
Step 3: Select Your Device Port
Choose the option named: USB JTAG / Serial Debug (or similar depending on your OS)
Click Connect.
Step 4: Flash the Firmware
The flashing sequence will begin:
Do not disconnect the cable during this process.
Once completed, the tool will show a success message.
Step 5: Restart the ONE
- Unplug the USB-C cable
- Wait 2–3 seconds
- Plug it back in normally
The device will now boot with the updated firmware.
AirGradient Open Air - Firmware Update
Everything you need to manually update the firmware on your AirGradient Open Air (O-1PST, O-1PST-CE, O-1PP, O-1PPT)
Video Guide: AirGradient Open Air - How to Flash Firmware
Before you begin, you need:
- A computer (Windows, macOS, Linux) with a supported browser.
Firmware flashing requires a Chromium-based browser. One of the following browsers will work:
- Google Chrome
- Microsoft Edge
- Chromium (Linux)
Note: The Flash button will NOT appear on Safari, Firefox, or any non-Chromium browser.
- A USB-C cable that supports data transfer (not charge-only). The cable that comes with the monitor will work.
- A tool (paperclip, toothpick, small screwdriver) that fits through the pin hole on the underside of the device to press the BOOT button.
Follow the steps below carefully to ensure a successful update.
Step 1: Enter Flash Mode
- Press and HOLD the BOOT button on the underside of the AirGradient Open Air:
- While holding the BOOT button, plug in the USB-C cable:
- Release the BOOT button AFTER the USB-C cable is plugged in.
Note: Ensure the correct sequence is followed:
Press and hold BOOT button → plug USB cable → release BOOT button.
If done correctly, the device will appear off (no LED indication).
Step 2: Start the Flashing Tool
Click the button below:
A pop-up window will appear asking you to select the device.
If the blue “FLASH NOW” button above is not visible, this usually either means you’re accessing the webpage using a non-Chromium browser or the browser is blocking WebSerial. Try the following:
- Use Google Chrome, Microsoft Edge or any other Chromium- based browser.
(Safari and Firefox do not support WebSerial)
- Disable any script-blocking extensions (uBlock Origin, NoScript, etc.)
Step 3: Select Your Device Port
Choose the option named: USB JTAG / Serial Debug (or similar depending on your OS)
Click Connect.
Step 4: Flash the Firmware
The flashing sequence will begin:
Do not disconnect the cable during this process.
Once completed, the tool will show a success message.
Step 5: Restart the device
- Unplug the USB-C cable
- Wait 2–3 seconds
- Plug it back in normally
The device will now boot with the updated firmware.
AirGradient Open Air Max - Firmware Update
Everything you need to manually update the firmware on your AirGradient Open Air Max (O-M-1PPST, O-M-1PPSTON).
Video Guide: AirGradient Open Air Max - How to Flash Firmware
- BOOT Button, 2. Status LED, 3. USB-C, 4. Battery Power Switch, 5. Solar Input
Before you begin, you need:
- A computer (Windows, macOS, Linux) with a supported browser.
Firmware flashing requires a Chromium-based browser. One of the following browsers will work:
- Google Chrome
- Microsoft Edge
- Chromium (Linux)
Note: The Flash button will NOT appear on Safari, Firefox, or any non-Chromium browser.
- A USB-C cable that supports data transfer (not charge-only). The cable that comes with the monitor will work.
- A tool (paperclip, toothpick, small screwdriver) that fits through the pin hole on the underside of the device to press the BOOT button.
Follow the steps below carefully to ensure a successful update.
Step 1: Connect the monitor to a computer
- Turn the Open Air Max ON by making sure the battery power switch is in the ON position (pushed in). If the monitor was already ON, turn it off first then turn it back ON.
- Connect the Open Air Max to your computer.
Step 2: Start the Flashing Tool
Click the button below:
|
|
A pop-up window will appear asking you to select the device.
If the blue “FLASH NOW” button above is not visible, this usually either means you’re accessing the webpage using a non-Chromium browser or the browser is blocking WebSerial. Try the following:
- Use Google Chrome, Microsoft Edge or any other Chromium- based browser.
(Safari and Firefox do not support WebSerial)
- Disable any script-blocking extensions (uBlock Origin, NoScript, etc.)
Step 3: Select Your Device Port
Choose the option named: USB JTAG / Serial Debug (or similar depending on your OS)
Click Connect.
Step 4: Flash the Firmware
The flashing sequence will begin:
Do not disconnect the cable during this process.
Once completed, the tool will show a success message.
The device firmware has now been updated.
Troubleshooting
Port Not Visible
If the USB JTAG / Serial Debug serial port does not show up in the flashing pop-up, try the following:
- Replace the USB-C cable. Charge-only cables will not work.
- Try a different USB port
- Close any other serial applications such as Arduino IDE, PlatformIO, Terminal sessions, etc. that may be using ports.
- Repeat the flashing sequence.
- Restart your computer. This resets all USB/serial bindings and can resolve rare driver lockups.
“Failed to execute 'open' on 'SerialPort'”
If you see this error while flashing, the browser cannot open a connection to the device. Try the following:
- Replace the USB-C cable: Charge-only cables will not work - use a data-capable cable.
- Try a different USB port: Prefer ports directly on your computer (avoid hubs if possible).
- Close other serial applications: Ensure tools like Arduino IDE, PlatformIO, or any serial monitor are not using the port.
- Reconnect the device: Unplug and plug it back in, then reselect the correct port.
- Use a supported browser: Use Google Chrome or Microsoft Edge (Safari and Firefox are not supported).
- Check drivers (Windows only): Install USB-to-serial drivers (e.g., CP210x or CH340), then reconnect the device.
- Retry the flashing process: Refresh the page and repeat the steps.
If the issue persists, try a different computer to rule out hardware or driver issues.
Logging
If you just need a debug log from the monitor, follow the instructions here: Online Debug
Resources
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.