Common Issues

This section will help walk you through the diagnosis and resolution of the most common roadblocks that our users run into. Some of these roadblocks are caused by issues or bugs in the platform, but many are more innocuous than that, and few are permanent. We'll help you identify exactly why your device is insert_issue_here and help you get it back to happily connected.

Device Doctor

If your Photon used to work but is not connecting to the cloud anymore, the easiest way to get it back to health is to use the Device Doctor.

Breathing Magenta

Photons that have been interrupted mid-firmware update often breathe magenta (defaulting to Safe Mode) to avoid running faulty firmware. To solve this issue, you can update your firmware manually.

Manual Firmware Update

If you do not have a Mac/Apple computer then you should not read the instructions below for a firmware upgrade. These are specifically for users who have Mac OS/OS X machines.

For Windows If you have a Windows machine, please follow these instructions.

Since your device is offline, I recommend using our dfu-util method. If you want more info on this, the local DFU-UTIL method is roughly explained here.

To upgrade your Photon, follow the instructions below:

  • Download the latest system Part-1 and Part-2 firmware binaries for the Photon linked here: latest release

  • Install dfu-util on your Mac using: brew install dfu-util If you don't have brew or homebrew installed, install it here: http://brew.sh/

  • Put photon into DFU MODE, instructions here.

  • Flash part1: dfu-util -d 2b04:d006 -a 0 -s 0x8020000 -D system-part1-x.x.x-photon.bin (replace x.x.x with actual version number)

  • Flash part2, unit should still be blinking yellow: dfu-util -d 2b04:d006 -a 0 -s 0x8060000:leave -D system-part2-x.x.x-photon.bin (replace x.x.x with actual version number)

  • Wait... Your device should eventually restart and start blinking blue, breathing cyan, or flashing green -- all dependent on if you've setup the device before.

Blinking Cyan

If your Photon is blinking cyan and sometimes orange/red without connecting, it is helpful to first try to manually update your firmware, in the same way as listed as above. If this does not work, then move on to a key reset.

Public Key Reset

Sometimes, a firmware upgrade will not be enough to solve your Photon's problem. If your are still having an issue, and particularly if your Photon is blinking cyan and sometimes orange/red without connecting, It's time to try resetting the public key.

  • If you haven't ever claimed the device before: You will need dfu-util. Install it, then download the this file. Use the command line to navigate to that file. Run the following command: dfu-util -d 2b04:d006 -a 1 -s 2082 -D cloud_public.der This should reset your public key.

  • If you claimed the device previously: You need the CLI. Once it is installed, run: particle keys server cloud_public.der particle keys new photon particle keys load photon.der particle keys send photon.pub.pem This should reset your public key.

Blinking Green

If your device is blinking green without connecting, there are a few things to check immediately.

Wi-Fi network requirements

Your device works best with a traditional home network: simple networks with WPA/WPA2 or WEP security (or unsecured), with a single router from a reputable company (Apple, Netgear, Linksys, D-Link, etc.) without any fancy settings. The more your network diverges from the norm, there more likely you might encounter issues.

There are known issues with the following types of networks:

  • 802.11n-only networks. The Core is 802.11b/g. Most 802.11n networks are backwards compatible with 802.11b/g, but if yours is not, the device will not connect.
  • Networks with "captive portal" security. A captive portal is the little website that comes up to ask you to sign in to a network or sign an agreement, like at a Starbucks. The device can't navigate these portals.
  • Enterprise networks. We have had mixed results connecting the devices to enterprise networks, although we don't yet have a great understanding of what's causing the issue. This is something that we are working to improve.
  • Complex Networks. Networks with multiple routers, with non-standard firewalls, and with non-standard settings.
  • Channels above 11. This is in particular an international issue; if you are outside the U.S., your Wi-Fi router might run at channels 12, 13, or 14, which the CC3000 does not support. Please use channels numbered 11 or lower.

Prerequisites for Setup

  • Software
    • Particle Mobile App - iPhone | Android | Windows
    • Note: We highly recommend using the mobile app for first time setup.
  • Hardware
    • Your Particle device, brand new and out of the box!
    • USB to micro USB cable (included with Photon Kit and Maker Kit)
    • Power source for USB cable (such as your computer, USB battery, or power brick)
    • Your iPhone, Windows, or Android smartphone
  • Wi-Fi Settings
    • 2.4GHz capable router
    • Channels 1-11
    • WPA/WPA2 encryption
    • On a broadcast SSID network
    • Not behind a hard firewall or Enterprise network
    • Note: We do not recommend using WEP Wi-Fi settings, for security reasons.
  • Experience
    • None! This is your first project.

Still Having Problems?

Check out connection help for more info.

For more help join our community forums and post in the troubleshooting section.