Troubleshooting Tools

Here are some tools to help you as you troubleshoot your Electron.

Listening Mode Commands

It is possible to put your Electron in Listening Mode to get some information about its system, version, and MAC address, and Device ID.

Setup

For Windows

For Windows users, we recommend downloading PuTTY.

Plug your device into your computer over USB. When the Electron is in Listening Mode, open a serial port over USB using the standard settings, which should be:

  • Baud rate: 9600
  • Data Bits: 8
  • Parity: none
  • Stop Bits: 1

For macOS or Linux

On macOS (OS X) and Linux systems, you can access the serial monitor through the terminal.

For macOS, open the terminal and type:

screen /dev/tty.u

and pressing tab to autocomplete.

On Linux, you can accomplish the same thing by using:

screen /dev/ttyACM

and pressing tab to autocomplete.

Now you are ready to type some commands to get info about your device.

Get Device ID [deviceID] CLI method

Using the Particle CLI

  • Put your device into Listening Mode mode while being plugged into a computer via USB
  • Issue particle serial identify from the Particle CLI and it should return the deviceID.

Get Device ID

To display the device ID of your Electron, type i

This will give an output that looks like:

Your device id is 1a2345678912345678901234

The IMEI of the cellular modem will also be printed.

Display Device OS Version

To get the Device OS (previously called system firmware) version of your device, type v

This will give you an output indicating the firmware that your device is using.

Sample output:

system firmware version: 0.4.6

Display System Information

For debugging purposes, sometimes it helps to get a dump of all the system information. For this, you can press s

The output will be a big confusing mess, which is why most of the time you won't need to use it. Occasionally, though, Particle Support might ask you for it. It looks something like this:

{"p":6,"m":[{"s":16384,"l":"m","vc":30,"vv":30,"f":"b","n":"0","v":4,"d":[]},{"s":262144,"l":"m","vc":30,"vv":30,"f":"s","n":"1","v":7,"d":[]},{"s":262144,"l":"m","vc":30,"vv":30,"f":"s","n":"2","v":7,"d":[{"f":"s","n":"1","v":7,"_":""}]},{"s":131072,"l":"m","vc":30,"vv":30,"u":"5CC350CE567187492F6FA800655CECF42DCFE1236EC7E23CDB17ECBC1774EDAF","f":"u","n":"1","v":3,"d":[{"f":"s","n":"2","v":7,"_":""}]},{"s":131072,"l":"f","vc":30,"vv":0,"d":[]}]}

DFU Commands

There are a number of low-level commands that can be used in DFU mode

Electron DFU commands:

System Part 1

dfu-util -d 2b04:d00a -a 0 -s 0x8060000 -D system-part1.bin

System Part-2

dfu-util -d 2b04:d00a -a 0 -s 0x8020000 -D system-part2.bin

System Part-3

dfu-util -d 2b04:d00a -a 0 -s 0x8040000 -D system-part3.bin

User firmware

dfu-util -d 2b04:d00a -a 0 -s 0x8080000 -D user-firmware.bin

Factory reset firmware

dfu-util -d 2b04:d00a -a 0 -s 0x80A0000 -D factory-firmware.bin

Particle cloud public key

dfu-util -d 2b04:d00a -a 1 -s 3298 -D cloud_public.der

Device private key

dfu-util -d 2b04:d00a -a 1 -s 3106 -D device-private.der