Device Management & Ownership
How do I find my device ID?
There are several ways to **find the device ID of your **, but the best method depends on whether or not your has already been claimed to your account. We'll cover both scenarios in the section below.
Note: You do not need to know your device ID to complete setup using the Particle smartphone app or over USB! The device ID is most useful for debugging with the technical support team and building interactions with your through the Particle API.
1. I haven't claimed my yet!
If you haven't claimed your yet, there are two ways for you to figure out your device ID:
1a. Get your ID using the Particle CLI Make sure that you've got the Particle Command Line Interface (CLI) installed by typing
into your terminal.
You should see a help message that displays the various commands available to you. Please make sure your is in Listening Mode (flashing blue), and type
particle serial identify.
Your should respond with it's device ID!
1b. Get your device ID using CoolTerm, PuTTY, or screen CoolTerm and PuTTY are programs for Mac and Windows, respectively, that allow you to communicate with your using the exposed serial lines. You can find the download links for CoolTerm and PuTTY at the links attached-- CoolTerm & PuTTy.
Plug your into your computer over USB. When the is in Listening Mode (flashing blue), open a serial port over USB using the standard settings, which should be:
- Baud rate: 9600
- Data Bits: 8
- Parity: none
- Stop Bits: 1
Once you've successfully opened a serial connection, you have two commands at your disposal by hitting either w or i on the keyboard. Here's what they do:
- w: Set up your Wi-Fi SSID and password
- i: ("i" as in identify) Read out the device ID
2. I've already claimed my !
If you've already claimed your , finding your device ID is a super simple process. You can still use either of the methods described above, but the easiest method is to look up your device ID in the Particle Build IDE.
Follow these simple steps:
- Navigate your web browser to the Particle Build IDE.
- Click on the "" icon in the bottom of the navigation pane
- Find the whose device ID you'd like to know, and click on the dropdown arrow on it's right
- The ID will be displayed in a box that reads, "device ID"
Great! Go forth with your ** device ID** and prosper.
How do I transfer my ?
1. Remove the .
Remove the from the account it was previously registered to, using the Particle Build IDE or Particle CLI.
**2. Connect the **
Make sure that the is connected to the Particle Device Cloud (breathing or pulsing cyan).
Note that cannot be claimed unless it is connected to the Particle Device Cloud, and is breathing/pulsing cyan.
**3. Claim the **
Claim the using the Particle smartphone app, Particle Build IDE, or Particle CLI.
"Can Particle do this for me?"
Excellent question! No.
We take security extremely seriously at Particle, and that means being very sensitive to attempts to steal, hack, takeover, or misuse s and Particle Accounts. As a security feature for all of our customers, we require that requests to add, remove, rename, or reconfigure s be submitted directly by the users to whom they are registered.
If you really are the owner of your , and are having trouble logging into your Particle account or configuring your , send us an email at [hello @ particle dot io], and our Troubleshooting staff would be happy to help you resolve the issue.
How do I unclaim ?
There are two primary ways to remove from your account--using the Particle Build Web IDE, or using the Particle Command Line Interface (CLI).
Using Particle Build
Login to your Particle account at the Particle Build IDE home page
Click on the "Devices" icon in the bottom left-hand panel
Identify the that you'd like to remove from your account, either by the familiar name you gave it when you added it to your account, or it's device ID.
Click on the arrow next to the device you'd like to remove, and click the blue "REMOVE DEVICE" button
Using the Particle CLI
1. Install CLI. Make sure you've got the CLI installed by typing
into your terminal. If you're presented with a list of commands, the CLI is installed correctly. If not, please see the following article:
2. Login. Make sure you're logged into your Particle account by typing
and successfully completing the command line prompts.
**3. Remove **. In your terminal, type
particle device remove <name>
where is either the familiar name or device ID of the you'd like to remove from your account. Here's an example:
particle device remove 0123456789ABCDEFGHI
particle device remove pinky_panda
4. Confirm Removal. Confirm that you really want to remove the from your account by entering "yes" when prompted by the CLI.
That's it! The has now been disassociated with your account, and is once again available to be claimed.