There are several ways to find the device ID of your Boron, but the best method depends on whether or not your Boron has already been claimed to your account. We'll cover both scenarios in the section below.
Note: You do not need to know your Boron device ID to complete setup using the Particle smartphone app or over USB! The Boron device ID is most useful for debugging with the technical support team and building interactions with your Boron through the Particle API.
1. I haven't claimed my Boron yet!
If you haven't claimed your Boron yet, there are two ways for you to figure out your Boron device ID:
1a. Get your Boron 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 Boron is in Listening Mode (flashing blue), and type
particle serial identify.
Your Boron should respond with it's Boron device ID!
1b. Get your Boron device ID using CoolTerm, PuTTY, or screen CoolTerm and PuTTY are programs for Mac and Windows, respectively, that allow you to communicate with your Boron using the exposed serial lines. You can find the download links for CoolTerm and PuTTY at the links attached-- CoolTerm & PuTTy.
Plug your Boron into your computer over USB. When the Boron 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 Boron device ID
2. I've already claimed my Boron!
If you've already claimed your Boron, finding your Boron 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 Boron device ID in the Particle Build IDE.
Follow these simple steps:
- Navigate your web browser to the Particle Build IDE.
- Click on the "Boron" icon in the bottom of the navigation pane
- Find the Boron whose device ID you'd like to know, and click on the dropdown arrow on it's right
- The Boron ID will be displayed in a box that reads, "device ID"
Great! Go forth with your Boron device ID and prosper.
1. Remove the Boron.
Remove the Boron from the account it was previously registered to, using the Particle Build IDE or Particle CLI.
2. Connect the Boron
Make sure that the Boron is connected to the Particle Device Cloud (breathing or pulsing cyan).
Note that a Boron cannot be claimed unless it is connected to the Particle Device Cloud, and is breathing/pulsing cyan.
3. Claim the Boron
Claim the Boron 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 Borons and Particle Accounts. As a security feature for all of our customers, we require that requests to add, remove, rename, or reconfigure Borons be submitted directly by the users to whom they are registered.
If you really are the owner of your Boron, and are having trouble logging into your Particle account or configuring your Boron, send us an email at [hello @ particle dot io], and our Troubleshooting staff would be happy to help you resolve the issue.
There are two primary ways to remove a Boron 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 Boron 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 Boron. In your terminal, type
particle device remove <name>
particle device remove 0123456789ABCDEFGHI
particle device remove pinky_panda
4. Confirm Removal. Confirm that you really want to remove the Boron from your account by entering "yes" when prompted by the CLI.
That's it! The Boron has now been disassociated with your account, and is once again available to be claimed.