Connecting your Device over USB

The easiest way to connect your device to Wi-Fi network is using the mobile app as described in the previous lesson. But in case that's not working for you, there are other methods as well.

For all of the following methods, the device must be in Listening Mode, where the RGB LED is blinking blue.

Particle devices boot into listening mode by default, so if your device is brand new, it should go straight into listening mode. If your device is not blinking blue, hold down the MODE button.

Install the Particle CLI

Next we're going to install the Particle CLI on your computer.

Using macOS or Linux

Open Terminal, or preferred terminal program and paste this command to install the Particle CLI:

bash <( curl -sL )

You may need to open a new terminal after the install completes to use the particle command.

If you get a message about installing dfu-util for your OS, make sure you have homebrew installed and run the command above again.

Using Windows

Download the Windows CLI Installer and run it to install the Particle CLI, the device drivers and the dependencies that the CLI needs.

You'll need to open the command prompt for this next part. You can also use Powershell or a similar command line tool if that is what you are used to.

To open the command prompt: 1) Mouse over the upper right hand corner of the screen and select "Search" 2) Search for cmd in the search box 3) Click on Command Prompt

Now your Command Prompt, is open for use.

Connecting Your Device

Make sure your device is plugged in via USB and in Listening Mode (blinking blue). Open the terminal and type: particle setup

Log in with your Particle account and follow the prompts to set up your device.

If you have already claimed your device and you want to connect it to Wi-Fi, type particle serial wifi instead of particle setup. This will set up your device on the current Wi-Fi.

Wait! What is an SSID? What kind of security does my Wi-Fi have?

  • The SSID is the name of your network. When you connect on your computer, it is the name that you select when you connect your computer to Wi-Fi.
  • The Security of your Wi-Fi is often set up by the administrator. Typically this is WPA2 if a password is needed, or unsecured if no password is needed. Contact your network administrator if you can't get this step to work, and find out exactly what kind of Wi-Fi you have.

If your device is not connecting, try troubleshooting here.

More info on the CLI and steps to install it manually are available.

Once you've finished connecting your device, head over to the next section to learn about the different modes for your device.