[Updated 3/21/19] Gen 3 known issues

Updating to the most recent release (v0.9.0)

The most recent release for Particle Mesh is v0.9.0. To update your device to this version of firmware, use the following instructions:

If you previously tried to set up your device using the Android mobile app and got a Bluetooth (BLE) pairing error (Nexus 6) or an error during device firmware upgrade, you should first manually update the device firmware to 0.9.0 using the Using the Particle CLI instructions below. The BLE fix requires a Particle Device OS fix, which for obvious reasons can’t be delivered by BLE during the normal mobile app setup process if BLE is not working, so you’ll need to do the manual upgrade process once by USB to get the device to 0.9.0 or later which contains the fix.

Using the Particle CLI

  • Install the Particle CLI on your computer if you have not already done so.
  • Go to the mesh firmware releases page.
  • Download the hybrid .bin file for your device. For example: hybrid-0.9.0-argon.bin
  • Put your device into DFU mode (blinking yellow), instructions here.
  • Flash the code from a command prompt or terminal window:
cd Downloads
particle flash --usb hybrid-0.9.0-argon.bin

For the Argon, if you are upgrading a factory unit without using the mobile app, you must manually apply the NCP (network coprocessor) update as well. Upgrade your device OS to 0.9.0 first, then go to the Argon NCP Release Page and download argon-ncp-firmware-0.0.5-ota.bin. With the Argon in blinking blue (listening mode):

particle flash --serial argon-ncp-firmware-0.0.5-ota.bin

You may get the error "Error writing firmware: TimeoutError: timed out after 10000ms" but this is normal if the Argon is still blinking magenta rapidly. Let it sit for a minute and then it should reboot and be updated.

Note that this must be done in --serial mode not --dfu. The mobile app does this automatically, so this step isn't required in normal circumstances. Also, the NCP binary does not need to be updated for every system firmware version. At this time, only factory new devices need an update.

Using the Particle app

  • If you have not configured your Particle device
    Complete the setup process using your iOS or Android mobile device. Your devices should automatically be upgraded to the most recent release.

  • If you have already configured your Particle device
    Your devices should already be running Device OS v0.9.0. You can confirm this by:

    • Putting your device into listening mode and typing particle serial identify into the CLI
    • Inspecting your device in the Particle Console (http://console.particle.io) under the Devices tab.

Using the Particle Web IDE (for devices already connected to the Cloud)

If your device is online and breathing cyan, you can upgrade the Device OS by flashing firmware targeting the newer version. Click on the Devices icon (circle with 4 lines on the left side), make sure the device has a gold star before its name, click on the >, then select the version you want to upgrade to, and compile and flash firmware to your device.


This will only upgrade, it will not downgrade to an earlier device OS version.

The first time you flash code from the Web IDE to a device running 0.8.0-rc.25 that targets 0.8.0-rc.26 or later (including 0.9.0), the first flash operation will fail but it will start a mandatory Device OS upgrade. You can then flash your user code again. This will only happen on the first flash from 0.8.0-rc.25 to 0.8.0-rc.26 or later from the Web IDE.

This upgrade can take several minutes of blinking magenta, and the LED may turn off entirely for periods of 30 seconds or longer. If it takes longer then 4 or 5 minutes, you may want to try upgrading by USB using the CLI instead.