Wi-Fi setup options

This page includes information on how to set up Wi-Fi on P2, Photon 2, or Argon devices that are used by your customers who are using a product that you have created on the Particle platform.

If you are interested in setting up a single device for your own software development, see setup options.

Provisioning mode

BLE provisioning mode is an alternative to listening mode (blinking dark blue) that allows customization of the user experience. For example:

• You will typically use custom service UUIDs, so your mobile app will only see devices with your firmware, not other Particle developer kits.
• Likewise, other products' mobile apps won't see your devices.
• Customizable device names and company ID (full white-label).

Unlike listening mode (blinking dark blue), BLE provisioning mode:

• Can run concurrently with your user firmware, allowing your mobile app to communicate directly with the device over BLE without putting the device in a specific mode.
• Wi-Fi credentials can be reconfigured without requiring an external button.
• Does not interrupt the cloud connection if used after connecting to the cloud.

In order to use BLE provisioning mode, you must already have added the device to your product and flashed your user firmware to it. The onboarding process will typically be:

• Add the Device IDs you will be using to your product. When you order in tray or reel quantities from the Particle wholesale store you will be emailed this list.
• Flash your product firmware and Device OS to your devices by USB or SWD/JTAG.
• In the basic and enterprise plans, these two steps do not start billing. Billing only starts when the devices first come online.

Additionally, you will need something for your customers to configure their Wi-Fi credentials:

• React Native sample application for iOS and Android
• iOS native sample application
• Android native sample application
• From a web browser using WebUSB (does not work on iOS)

The Particle mobile apps cannot be used after BLE provisioning mode has been enabled. The older Photon device setup SDKs for iOS and Android only work with the Photon and P1 using SoftAP and do not work with BLE-based setup.

Setup protocol overview

BLE connection

The setup process is based on BLE 5 (Bluetooth LE) but does not depend on BLE pairing. It does encrypt the information, but using an application layer encryption, not BLE pairing, such as LESC pairing.

The setup process uses a BLE service that has three characteristics (tx, rx, and version). The standard listening mode setup on the Argon, P2, and Photon 2 has a set of service and characteristic UUIDs, which are all 128 bit unique IDs. This allows the BLE configuration service to be detected by your BLE client (mobile app, computer with BLE, etc.).

It is also possible to customize these UUIDs when using BLE provisioning mode. This is useful for custom products because it means your BLE client will only see your product devices, not random Particle developer kits.

In BLE terminology, the Particle device is the BLE peripheral, which accepts connections for configuration and implements a service. Your mobile app is the BLE central.

Device name

By default, the device name that appears in the BLE advertising packet is something like "P-Series-AB123X". The last 6 characters match the last 6 characters of the serial number, which is printed on the serial number sticker and also encoded in the data matrix code (looks similar to a QR code) on the label.

Imagine you are in a classroom with many people configuring their devices at the same time. This makes sure the correct device is selected when there are multiple devices in BLE range.

You can set a custom name base, such as your company or product name instead of "P-Series" by changing a setting in the DCT (configuration flash). This can be done from user firmware, or by USB in DFU mode.

You can also set the entire name to a fixed string from your product firmware, eliminating the serial number part. If you do not expect your customers to be configuring multiple devices in close proximity, this can simplify the setup experience by eliminating the need to scan the data matrix sticker if you also use a fixed mobile secret, as described in the next section.

It is also possible to use a fixed mobile secret and a custom name base, but still including the last 6 characters of the serial number. This is useful if you think your customers may be configuring multiple devices in close proximity, but you do not want to implement scanning of the data matrix code. In this scenario, the customer only needs to type a 6-character alphanumeric code (the last 6 characters of the serial number), which you could easily replicate on a sticker on the outside of your product.

Encryption

Because setup does not rely on BLE pairing it has an encryption layer using the EC (Elliptical Curve) J/PAKE algorithm. This assures that other devices in BLE range cannot sniff configuration data or spoof packets.

The encryption key includes the device mobile secret. By default, this is defined in the factory and is unique per-device. It's encoded in the data matrix code (which looks like a QR code) along with the serial number. Typically this code is scanned by the the camera in your mobile app.

It's also possible to specify a mobile secret in device firmware. This could be used to set all of your product devices to be the same mobile secret. This is less secure, but in some applications it may be desireable to trade the additional security for the simplicity of not having to scan the data matrix sticker from your mobile app.

Even with a fixed mobile secret the connection is still encrypted, it's just that it uses an encryption key that is stored in the user firmware binary, so it theoretically could be extracted. This still only affects BLE, not the cloud connection, so an attacker would also need to be within BLE range.

Control requests

Finally, the act of getting the list of Wi-Fi networks and configuring the Wi-Fi credentials is done using control requests. These are request and response binary packets that are encoded using protobufs.

On Particle devices, control requests can be made over encrypted BLE, and also can be done over USB using the same control request format. There are many control requests defined that include many features beyond Wi-Fi configuration.

There is also an application-defined control request. This allows your application to implement a custom control request handler that accepts requests either from BLE or USB. This is handy if you need to configure things beyond the Particle-defined control requests. You define your own payload; we recommend using JSON for it as it's often easier to handle than protobufs. The Tracker uses this to allow control functions like enter shipping mode to be made by USB, BLE, or by Particle.function.

Since BLE provisioning mode works even when your application firmware is running, this provides a way for your mobile app to communicate with your devices over BLE, in addition to being able to communicate over the cloud.

Additional information can be found in:

• Device OS header listing all control request types
• particle-usb library which implements control requests for node.js and browser-based WebUSB

Listening mode

You can still use listening mode (blinking dark blue) with the P2, Photon 2, and Argon, when connecting by USB, if it has not been disabled. For example, the particle serial wifi command can be used from the Particle CLI to configure Wi-Fi credentials. The newer control request method is generally preferred, however, because of the increased flexibility and robustness. Typically when BLE provisioning mode is enabled, listening mode is disabled, so you will generally want to select one or the other.

The Web Device Doctor tool will reenables listening mode, flash Device OS, and flash Tinker-compatible firmware to a device.

Previously, on the Photon and P1, setup could be done in listening mode (blinking dark blue) using USB serial (CDC) or by SoftAP, which allows setup over Wi-Fi. Setup over Wi-Fi from a mobile device is somewhat cumbersome because you need to use the mobile device Wi-Fi configuration settings to select a different Wi-Fi network. SoftAP is not available on newer devices.

Wi-Fi credentials setting vs. device setup

We highly recommend that you limit customer device setup to only setting Wi-Fi credentials.

Previously, the device setup SDK mixed in Particle account creation, device claiming, and access token management with Wi-Fi credential setting. This significantly increased the complexity of the setup process.

Likewise, the web-based Particle device setup and the old Particle mobile apps have features for upgrading Device OS. Instead, we recommend that you set up the devices ahead of time with the appropriate Device OS and firmware, which eliminates the need to include that functionality in the mobile app, and also makes the setup process significantly faster for your users and reduces the size of your mobile app.

How do I authenticate users?

The big change is that we no longer recommend making Particle REST API calls directly from your mobile app. This required creating Particle customer accounts and storing authentication tokens into your mobile app, which adds significant complexity.

Instead, we recommend that you handle authenticating your users entirely in your back-end. You might choose to implement your own, or use any number of common authentication schemes like authenticate with Facebook, Google, SMS, etc.. This also means that you no longer need to share any customer-specific information with Particle. You handle that entirely on your end, but it's a common requirement of mobile apps and mobile developers should have no difficulty doing it since it's not Particle-specific.

This also makes it significantly easier to use a combination of mobile app and web app, depending on what your customers prefer to use.

Note that these are recommendations; if you wish to use two-legged shadow customer accounts and send Particle API calls directly from your mobile app you can do so, however there is no built-in support.

BLE Provisioning settings

There are a number of configurable parameters needed for device provisioning over BLE:

• BLE service UUIDs. These are embedded in the device firmware and also in your mobile app. Changing these settings prevents other mobile apps from being able to interact with your devices.

• BLE device name or setup code. From the factory, this is a string like "P-Series-" followed by the last 6 characters of the serial number. Imagine a classroom of users who are all trying to set up their devices at the same time over BLE. The device name makes sure they set up the device in their hand instead of a different nearby device. However, you can also set this to a constant value, for example the name of your product, to simplify setup.

• Mobile secret. Every Particle device has a mobile secret written to it at the factory. It's also printed on in the data matrix code (similar to a QR code) on the serial number sticker. This is used for secure communication over BLE between your mobile app, which has presumably scanned the data matrix code, and the device, which already knows its mobile secret stored in flash memory.

You can, however, configure the mobile secret to be a single pre-shared secret across all of your product devices. This eliminates the need to scan the data matrix code. The downside is that unless you add additional safety checks in your firmware and/or mobile app, it could allow customers of your product to configure devices of different customers of your product.

If multiple users setting up your product in close proximity is unlikely, and the highest level of security is not necessary, setting both a constant device name and mobile secret eliminates the need to scan the serial number sticker or enter a 6-character code.

This is what the service UUIDs look like in the Particle device firmware:

const char* serviceUuid = "6E400021-B5A3-F393-E0A9-E50E24DCCA9E";
const char* rxUuid = "6E400022-B5A3-F393-E0A9-E50E24DCCA9E";
const char* txUuid = "6E400023-B5A3-F393-E0A9-E50E24DCCA9E";
const char* versionUuid = "6E400024-B5A3-F393-E0A9-E50E24DCCA9E";

In rn-ble-setup (React native), the UUID settings are in App.tsx:

export const SERVICE_UUID = '6e400021-b5a3-f393-e0a9-e50e24dcca9e';
export const TX_CHAR_UUID = '6e400022-b5a3-f393-e0a9-e50e24dcca9e';
export const RX_CHAR_UUID = '6e400023-b5a3-f393-e0a9-e50e24dcca9e';
export const VERSION_CHAR_UUID = '6e400024-b5a3-f393-e0a9-e50e24dcca9e';

In iOSBLEExample, the UUID settings are in ParticleBLECode/ParticleBLEInterface.swift:

let serviceUUID = CBUUID(string: "6E400021-B5A3-F393-E0A9-E50E24DCCA9E")
let rxUUID = CBUUID(string: "6E400022-B5A3-F393-E0A9-E50E24DCCA9E")
let txUUID = CBUUID(string: "6E400023-B5A3-F393-E0A9-E50E24DCCA9E")
let versionUUID = CBUUID(string: "6E400024-B5A3-F393-E0A9-E50E24DCCA9E")

In AndroidBLEExample, the UUID settings are in app/src/main/java/io/particle/bleexample/MainActivity.java:

private final UUID serviceUUID = UUID.fromString("6e400021-b5a3-f393-e0a9-e50e24dcca9e");
private final UUID txCharUUID = UUID.fromString("6e400022-b5a3-f393-e0a9-e50e24dcca9e");
private final UUID rxCharUUID = UUID.fromString("6e400023-b5a3-f393-e0a9-e50e24dcca9e");
private final UUID versionCharUUID = UUID.fromString("6e400024-b5a3-f393-e0a9-e50e24dcca9e");

Comparison

Column definitions:

• Secret: Uses unique mobile secret on device, read by scanning the data matrix code on the serial number label
• Unique ID: Requires the last 6 characters of the serial number for configuration, either by entering it, or by scanning the data matrix sticker
• Scan: Requires scanning the data matrix sticker
• Listening: Requires being in listening mode (blinking dark blue)
• Multiple: Scan set up multiple devices in close proximity, such as in a classroom, is supported

Provisioning firmware

Make sure the version of Device OS on your device matches the version you have targeted when compiling provisioning firmware. If Device OS needs an upgrade, and your device does not yet have Wi-Fi credentials, it cannot go online to upgrade Device OS OTA. In this case, the device will go into blinking dark blue (listening mode), and your provisioning firmware will not run, so you won't be able to configure credentials in BLE provisioning mode. In production, we recommend flashing Device OS, bootloader, and your product firmware at the same time over USB or SWD/JTAG to prevent this scenario.

• Device OS 5.3.1 or later is recommended on the P2 and Photon 2
• Device OS 3.3.0 or later is required on the Argon

Standard mobile secret firmware

This is the standard firmware that uses the mobile secret that is set at the factory. You would typically need to use a data matrix decoded in your mobile app to read this off the serial number sticker. This example should be used with the iOS native example, below.

• Device Name: aabbcc
• Mobile Secret: (set at factory, varies by devices and is encoded in the data matrix code on the serial number sticker)

Fixed mobile secret firmware

This example shows how to use a fixed mobile secret. In this case it's set to AAAAAAAAAAAAAAA (15 uppercase letter A). Using a fixed mobile secret is less secure, but you do not need to scan the serial number sticker, so it may be an acceptable trade-off in some cases. This example is easier to use with the React Native and Android native examples since you don't need to read the data matrix sticker to get your device's mobile secret and can just paste in that string.

• Device Name: aabbcc
• Mobile Secret: AAAAAAAAAAAAAAA (it must be 15 characters in length)

React native example

The react native example is designed to be built using Expo. Using Expo EAS is fast and easy, and eliminates the need to install the full development environments (Xcode for iOS and Android Studio for Android) because it can build in the cloud. The free tier allows 30 cloud builds per month, though iOS counts as 2 builds. You can also pay on demand, or purchase a production plan with a large number of builds. Additionally, the Expo cloud build allows you to build iOS apps from Windows, which is not normally possible.

You can, however, export a native project that can be built with native development tools, if you prefer.

• Download the react native example from Github.
• Make sure node 16 or above is installed with npm 8 or above.
• You will also need a global install of yarn.

Install the dependencies using:

cd rn-ble-setup
npm install --legacy-peer-deps

The --legacy-peer-deps is because the setup application uses react@18 and the setup library uses react@^17.0.2, but does work properly with react@18 and that option allows the peer dependency in the setup library to be ignored.

You will need to configure two settings in app.json in the project. These should be set to your domain instead of Particle:

    "ios": {
      "bundleIdentifier": "io.particle.blesetup",

    "android": {
      "package": "io.particle.blesetup",

You will also need to install the Expo eas-cli globally:

npm install --global eas-cli

If you are going to be using cloud builds, you should also install the Expo Go mobile app on your iOS and Android devices.

iOS development app - react native

Building an iOS app using Expo EAS is as easy as:

npx eas build -p ios --profile development 

This will do a cloud build of the iOS app, and eliminates the need to install a local development environment. In the Expo EAS cloud build, iOS builds are more expensive, as they count as two builds in the free plan, and are $2 instead of $1 a la carte. You may want to do initial development and testing on Android for this reason.

Follow the instructions when prompted to connect to your Apple developer account, register your device with Expo (if you have not already done so), and install and run the demo app.

Android development app - react native

npx eas build -p android --profile development 

This will do a cloud build of the Android app, and eliminates the need to install a local development environment.

Follow the instructions when prompted to register your device with Expo (if you have not already done so), and install and run the demo app.

Export native source

Instead of using the Expo EAS cloud build service you can export source to build using native tools. Using native tools you can do as many build as you want at no charge.

This will create a project that can be opened in Xcode on a Mac to build an iOS mobile app:

npx eas build -p ios --profile development --local

This will create project that can be opened in Android Studio to build an Android app:

npx eas build -p android --profile development --local

iOS native example

Building native iOS apps requires a Mac.

• Download the iOS native example from Github.
• Install XCode.
• Enable your iOS device for development mode (BLE cannot be used in the emulator).
• Flash the standard mobile secret firmware above to Particle P2, Photon 2, or Argon.
• You will need an Apple developer account in order to be able to sign the binaries, create provisioning profiles, etc.

Settings - iOS native example

• Select your team in General - Targets iOSBLEExample
• Make sure a provisioning profile and signing certificate are selected
• Build and run the example

Android native example

The Android example app is not a fully functional setup application; it just shows how to use the BLE setup protocol.

Settings

• Download the Android native example from Github.
• Tested with Android Studio Flamingo, but should work with other versions.
• Enable developer options on your Android device (the emulator cannot be used with BLE).
• Follow the instructions in the README of the AndroidBLEExample repository.
• It is OK to upgrade the Android Gradle Plug-in using the automatic tool.
• Flash the fixed mobile secret firmware above to Particle P2, Photon 2, or Argon.

The Android sample app does not handle scanning the data matrix code on the device. The fixed mobile secret firmware sets it to AAAAAAAAAAAAAAA (15 of the uppercase letter A).

Note that the setup code is the value set in the firmware using BLE.setDeviceName and is set to aabbcc. From the factory, this would be the last 6 characters of the serial number instead. You would probably set this to be your product or company name.

In app - java - io.particle.bleexample - MainActivity, update the setupCode (device name) and mobileSecret:

private final String setupCode = "aabbcc";
// Mobile secret available on the QR sticker on the device
private final String mobileSecret = "AAAAAAAAAAAAAAA";

• Run the application on your Android device.
• You will need to allow precise location, because access to local BLE devices requires this.

USB setup

A less common option is Wi-Fi setup over USB. This is typically done from a computer, Chromebook, or some Android phones and tablets. It is not possible to do this from iOS (iPhone or iPad), which is why BLE setup from a mobile app is generally preferred. This only works with Chrome, Edge, and Opera. It does not work on Safari or Firefox browsers.

To use this built-in tool, connect your P2, Photon 2, or Argon by USB and use the Connect button.

You should use https://setup.particle.io/ instead of this tool in most situations.

Connect your Particle device to your computer with a USB cable, click the Select Device button, select your device, and click Connect.

Select Device

Checking the account you have logged in with...

Your developer sandbox account has reached free plan account limits and device operation will be affected.

Continue anyway

Your account access token appears to be invalid; it has probably expired or was invalidated when logging out previously.

Log In Again

Checking the device you have connected. This normally takes a second, but it could take up to 30 seconds.

This tool cannot set up Tracker devices, including the Tracker One, Tracker SoM, and Monitor One. You should use setup.particle.io instead.

This tool cannot set up this type of device. You should use the Particle CLI or Particle mobile apps for iOS and Android.

Just a little longer while we check the SIM card in your device...

This tool will flash Device OS and doctor firmware to your device, replacing the existing Device OS and user firmware.

This tool will flash Device OS and cloud debug firmware to your device, replacing the existing Device OS and user firmware.

This tool will flash Device OS and setup firmware to your device, replacing the existing Device OS and user firmware.

This tool will flash Device OS and product firmware to your device, replacing the existing Device OS and user firmware.

This tool will flash Device OS and the specified user firmware to your device, replacing the existing Device OS and user firmware.

Upon successful completion you can to program your firmware again over-the-air (OTA) or by USB.

A backup file containing your user firmware will be saved to your Downloads folder; this can be used to restore the original firmware and a similar version of Device OS if desired.

All Tracker devices must be part of a product.
Create a new sandbox product named
Add to an existing product

Sandbox Product    Organization Product
Organization
Product

Mark as development device

Do not claim device

Proceed with flashing the device and device setup?

Proceed with flashing the device?

Flash Device

It appears that you previously flashed doctor or setup firmware to this device. You can restore the original firmware and a similar version of Device OS if you still have the backup file available. It should be in your Downloads folder as firmware_.bin

Restore firmware from backup file

Advanced Options

These options are seldom needed and may adversely affect connectivity if used incorrectly.

Specific Device OS version

Use Ethernet for connectivity

Set keep-alive to seconds

Setup Wi-Fi network credentials

Wi-Fi Antenna Leave unchanged Select Internal Select External

Advanced Setup Options

These options are seldom needed and may adversely affect connectivity if used incorrectly.

Specific Device OS version

Do not claim device

Force claim a Wi-Fi device using a claim code

Add device to a product

Sandbox Product    Organization Product
Organization
Product

Mark as development device

SIM Select: No change Internal SIM (MFF2 SMD Particle SIM) External SIM (4FF)

Use Ethernet for connectivity

Device Type	Tracker One    Monitor One
Restore Type	Tinker (Factory Default) Custom User Firmware Upload
Edge Version
Device OS Version	Select Device OS Version
Upload File	Select user binary to upload
User Firmware URL
Setup Bit	Leave value unchanged Mark setup done (run firmware normally) Mark setup not done (go into listening mode)
Flash even if system parts are already the correct version
Update NCP (network coprocessor)
Enter shipping mode when done

Flash Device

The connected device does not appear to be in a product, you are not a team member of the product it is a member of. You cannot flash product firmware at this time.

The connected device does not have a firmware version locked, or the product does not have a default firmware version. You cannot flash product firmware at this time.

Adding device to product...

This should only take a few seconds.

Checking device ownership...

This device could not be found in your account, your products, or any organization products you have access to. This is normal if you are setting up the device for the first time.

However, it can also happen if the device is really claimed to another account, or the device is part of a product you are not a team member of. This tool not recommended for use on product devices by non-developers.

Attempt to claim device when online

Continue

Checking account status...

Getting the SIM ICCID from the device...

This usually takes a few seconds but can take a minute.

Getting the SIM ICCID from the device...

The cellular modem is not responding. It will take a little longer to reset it.

Checking SIM status...

Waiting for SIM activation to complete...

This can take anywhere from several seconds to several hours. Rarely, it can take a day or more.

You can wait here for activation to complete, or close this web page and come back later to see if activation has completed so you can proceed with setup.

Your Boron is configured to use an external 4FF nano plastic SIM card, but it does not appear that one is inserted.

Click Use Internal SIM to change the SIM configuration.

Use Internal SIM

An error occurred putting your device into DFU mode (blinking yellow).

Hold down the MODE (or SETUP) button and tap the RESET button. Continue to hold down MODE while the status LED blinks magenta (red and blue at the same time) until it blinks yellow, then release.

Device is Blinking Yellow

Downloading the binaries for your device. This should only take a few seconds...

Putting device in DFU (firmware update) mode (blinking yellow). This should only take a few seconds, but can take up to 30 seconds sometimes.

Your browser requires authorization to reconnect to your device now that it is in DFU mode. This is a normal browser security precaution.

Reconnect

Connecting to the device in DFU mode...

Updating the firmware on the device...

Waiting for the device to finish updating itself and restart...

This will take several seconds, and the status LED may blink yellow, white, magenta (red and blue at the same time), blue, or green.

Failed to reconnect to the device by USB. Click the Reconnect button to try again.

Reconnect

Waiting for the device to finish updating itself and restart...

If the device is still blinking yellow, tap the reset button on the device, then click Continue.

Continue

If the status LED is solid white, not blinking, tap the reset button on the device, then Reconnect

No Wi-Fi networks were found.

Scan for Wi-Fi Networks Again

 

Use Wi-Fi Already Configured on the Device

Searching for Wi-Fi networks...

	Network Name	Secure	Signal

Use manually entered SSID:

On the Argon, a manually entered SSID can only be used to pre-configure credentials.
The Argon cannot connect to a hidden SSID.

Security Type
Security Type	Unsecured WEP WPA WPA2
EAP Type	PEAP/MSCHAPv2 EAP-TLS
Username (Inner Identity)
Password
Private Key (required)
Client Certificate (required)
Outer Identity (optional)
CA Certificate (Optional)

Select Wi-Fi Network

Use Wi-Fi Already Configured on the Device

Scan for Wi-Fi Networks Again

Edit existing Wi-Fi networks on device

Remove Selected   Remove All

	Connecting to network
	Connecting to the Particle cloud
	Claiming device

It appears that you do not have a battery connected. A battery is recommended for all non-LTE cellular devices; running without a battery may cause connection or data transmission to fail.

You can name your device to make the devices in your account easier to identify.

A random device name has been generated, or you can enter your own here:

 Set Name

Or you can skip naming. You can always rename your device later.

Congratulations, you have completed setting up your device!

• Get started with the Blink an LED tutorial.
• Learn about the Particle Workbench and Web IDE development environments.
• Learn how the Particle cloud can make Internet-connected devices easy to build.
• Get deep into device programming with the Device OS API reference.

 

Or just try changing the color of the status LED on your device over the cloud:

  Set Status LED Color

Flashing product firmware complete!

Flashing cloud debug firmware complete! Monitor the status using the USB serial debug console.

Device restore complete!

Restore another device

Device restore complete! Tracker will enter shipping mode shortly.

Restore another device

Start over

DFU flashing failed.

Start over

Congratulations, it appears that your device is online and functioning properly now!

It appears that your device connected to the cloud, then got a firmware update that erased the setup firmware. This prevents logs and other diagnostic data from being displayed, but your device should be fully functional.

Your original device firmware has been restored.

Claiming the device failed.

This typically occurs because the device is claimed to another user already, or was previously part of a product.

Activating the SIM failed

This typically occurs because the SIM card is already assigned to another user or a product.

Continue Without Activating

If you continue without activating the SIM you may not be able to get online until you manually activate the SIM.

Wi-Fi setup in progress... this can take up to 1 minute.

Wi-Fi setup compete. Your device will be reset to activate the new configuration.

Wi-Fi setup failed. This can happen if the password is invalid. It may help to reset the device and try again.

This Wi-Fi setup tool cannot be used with the Photon and P1. The Web Device Doctor can be used to set Wi-Fi credentials.

The device must be in listening mode (blinking dark blue), normal operating mode (breathing cyan), blinking green, blinking cyan or safe mode (breathing magenta) to use this tool.

The device cannot be in safe mode (blinking yellow), reset the device or use the Web Device Doctor to repair it.

This option can only be used to configure Wi-Fi devices.

Performing a scan for available towers (this takes 3 to 6 minutes)...

	Preparing the cellular modem for scanning
	Scanning for towers

Tower scan complete!

Your device can look for all compatible cellular towers near your device. This process takes 1 - 2 minutes and will interrupt the normal operation of your device. You may want to do this if your device is stuck on blinking green or you want to troubleshoot intermittent cellular connectivity.

Tower Scan

 

On the Electron and E-Series, device debugging logs will not display while the device is connecting to cellular (blinking green). If you are trying to debug connection failures, you may need to use a serial terminal program or the Particle CLI to view the logs.

 

Show device debugging logs

Download Logs

It appears that the device is not responding with log data. The best way to troubleshoot when this occurs is to use the particle serial monitor CLI command.

Tower information

MCC	MNC	CI	LAC	RSSI	Carrier	Band

Device information

Is the device claimed to my account?  

Is the device in a product I have access to?

Is the device in an organization I have access to?

Device information retrieved from the cloud:

Cellular information

Location information

	Device Value	Location Fusion

GNSS hardware location

GNSS module information

Cloud Events

Event Name	Event Data	Event Time

Device firmware information

Module	Valid	Version	Dependencies

User information

Still having trouble? You can create a support ticket for help with this issue.

Create support ticket

This tool can be used to set up Wi-Fi for Argon, P2, and Photon 2 devices connected by USB. It will only set Wi-Fi credentials and does not affect claiming or product membership and does not flash any firmware to the device.

It can only be used in Chrome, Edge, or Opera browsers on Windows, Linux, Mac, and Chromebook. It cannot be used on phones or tablets, and cannot be used with Safari or Firefox.

You can use the Particle CLI if you don't have a compatible browser or want to configure a P1 or Photon 1 device.

This tool can only be used on:

• Chrome (Windows, Mac, Linux, Chromebook, or Android, version 61 and later)
• Edge (version 79 or later
• Opera (Windows, Mac, Linux, or Android, version 48 or later
• Samsung Internet (version 8.0 or later)

If you are using an iOS device, Safari, or other unsupported browser (such as Firefox), you can use the Particle CLI for Windows, Mac, and Linux, or the Particle mobile app for iOS or Android instead.

If you'd like to implement this same technique from your own web site, there is a standalone Wi-Fi setup over USB example that can be downloaded from Github.