Electron Troubleshooting App

Overview

When having connectivity issues, one diagnostic tool you can use is the Electron Troubleshooting app. You can flash this to your Electron and run through the suggested workflow. Please let us know what steps fail (if any) and what the responses are.

Note: It is important that your Electron be running v0.4.6-rc.8 system firmware or newer for this. FYI: All factory fresh Electrons are running this version.

Note: If you are running v0.5.1 system firmware, make sure to use the electron-troubleshooting-v0.5.1.bin

Install (for v0.4.8-rc.6 system firmware)

Download the electron-troubleshooting binary here:

https://github.com/spark/firmware/releases/download/v0.4.8-rc.6/electron-troubleshooting-v0.4.8-rc.6.bin

Then you can flash this troubleshooting app to your Electron with the Particle CLI with your electron in DFU mode:

particle flash --usb electron-troubleshooting-v0.4.8-rc.6.bin

Install (for v0.5.1 system firmware)

Download the electron-troubleshooting binary here:

https://github.com/spark/firmware/releases/download/v0.5.1/electron-troubleshooting-v0.5.1.bin

Then you can flash this troubleshooting app to your Electron with the Particle CLI with your electron in DFU mode:

particle flash --usb electron-troubleshooting-v0.5.1.bin

How to Use

Be ready to open a serial terminal on your computer. Note: particle serial monitor will not work for this as it's read only, and we need to be able to send characters as well. You can use screen /dev/cu.usbmodemXXXX on Mac, or Putty and TeraTerm on Windows.

Now completely disconnect power and reapply it (or Soft Power Down the Electron by double tapping the MODE button, and RESET to power back up). This will ensure a full connection to the tower and ensure your cellular modem is in a reset state.

Next open the serial terminal just after the Electron boots.

A sample output and running the suggested workflow looks like this:

Press ENTER

Running in SEMI_AUTOMATIC mode, cellular modem is OFF at boot,
not connected to the cellular network or cloud.
System RGB LED will typically stay White, until connecting to cloud.
Connect a serial to USB adapter on the TX pin to see debugging output.
Suggested workflow: o, d, r, p, P, p, C, s, s, z

Press a key to run a command:
[o] turn the cellular modem ON
[d|D] cellular data connection (Particle SIM|3rd Party SIM)
[n] scan the cellular network for operators
[r] get the RSSI and QUAL values
[P|p] send ping to www.bing.com|Google DNS 8.8.8.8
[C|c] to connect|disconnect the cloud
[s] publish a "b" event name and "count++" data
[i] read the SIM ICCID
[z] turn off the cellular modem, and go to deep sleep
[K|k] enable|disable Serial1 debugging loopback
[h] show this help menu

Turning on the modem: OK!
Connecting to the cellular network: OK!
Getting signal strength: RSSI: -95dBm, QUAL: 25dB
Pinging Google DNS 8.8.8.8 (Consumes 240 bytes per ping): OK!
4 bytes from google-public-dns-a.google.com IP:8.8.8.8 TTL:54 RTT:324 ms
Pinging www.bing.com (Consumes 64 bytes per ping): OK!
4 bytes from any.edge.bing.com IP:204.79.197.200 TTL:116 RTT:345 ms
Pinging Google DNS 8.8.8.8 (Consumes 240 bytes per ping): OK!
4 bytes from google-public-dns-a.google.com IP:8.8.8.8 TTL:54 RTT:330 ms
Connecting to the cloud: OK!
Publishing the "b" event name with count "1" data. Look in your dashboard.particle.io logs: OK!
Publishing the "b" event name with count "2" data. Look in your dashboard.particle.io logs: OK!

Battery will still charge in this mode. Press RESET to wake the system back up.
Turning off the cellular modem, and putting processor in deep sleep: OK!

If you cannot connect to the cellular network using a Particle SIM, try this workflow:

o, r, i, n, o, r, i, d, n

Note: it will take about 3-4 minutes to run the n command.

Try using the SIM card from your cell phone, you must know your APN details:

You can also easily try a 3rd-party SIM with this test app... just press D instead of d and enter your credentials. Then you may get better results with the n command. The AT+COPS=5 command (which is part of the n test) doesn't always work with the Particle SIM... but usually will work after one or more tries with a 3rd Party SIM.

After trying one or more of the above scenarios, capture your logs:

Copy and paste the log output over the course of your testing. Please put this in a TXT file and attach it to an email reply or Community PM to a Particle employee.

Note: Please do not post logs on the forum as they contain ID numbers that are sensitive for your Electron.

Thanks!

After you are done using this Troubleshooting app, you can restore Tinker with this CLI command (device in DFU mode):

particle flash --usb tinker