Adding and removing devices¶
This page explains the process of adding Internet Protocol (IP) or Bluetooth® Low Energy (LE) devices to your nRF Cloud account.
IP devices¶
To add an IP device, associate it with your account. This happens automatically during the onboarding process only when using the ProvisionDevices
endpoint or auto-onboarding.
If you are using Just-in-Time provisioning (JITP), you must manually associate the device with your account using either the nRF Cloud portal or the AssociateDevice
endpoint.
An IP device knows whether it is associated by finding {"pairing":{"state":"paired"}}
in its device shadow. Devices using the nRF Cloud library attempt to do this automatically. See the MQTT API documentation for more information.
Bluetooth LE devices¶
You can add Bluetooth LE devices to your account using either the nRF Cloud portal or the AddPeripheral
endpoint.
Adding a Bluetooth LE device is not the same as adding an IP device, as there is no association process for a Bluetooth LE device. Instead, you are connecting the device to an associated gateway. The added device is known to nRF Cloud, and you can view its data by calling the FetchDevice
or ListDevices
endpoints.
Removing devices from your account¶
To remove a device from your account, use either the nRF Cloud portal or the DeleteDevice
endpoint.
Removing the device also removes any associated data.
Note
Deleting a device removes its association. If you have claimed a device and used provisioning commands or auto-onboarding to add it to nRF Cloud, the following steps, as well as the DeleteDevice
endpoint, do not affect the device's claim status.
Deleting devices using the nRF Cloud portal¶
To remove a device from your account:
- Log in to the nRF Cloud portal.
- Select Devices from the left navigation bar.
-
You can delete one or more devices from the Devices overview, or a single device from that device's page:
-
To delete one or more devices from the device overview:
- Select the checkbox next to one or more devices that you want to delete.
-
Click Delete.
A pop-up opens asking for confirmation.
-
Click OK.
-
To delete a single device from its own page:
- Click the device name. The device's own page opens.
-
Click Delete Device.
A pop-up opens asking for confirmation.
-
Click OK.
-
The device and its associated data are now removed.