Stand with Ukraine flag
Try it now Pricing
Edge
Community Edition Professional Edition Cloud Edge PE Edge IoT Gateway License Server Trendz Analytics Mobile Application PE Mobile Application MQTT Broker
Documentation > Configuration Guides > Device Creation and Cloud Provisioning
Getting Started
Devices Library Installation Architecture API FAQ
On this page

Edge Device Creation and Cloud Provisioning

Overview

The Edge Devices are basic IoT entities that can generate telemetry data and process RPC commands. They are physical objects, such as sensors, actuators, switches, etc. that can collect, process and transmit data locally or to a nearby network, rather than relying solely on a centralised Cloud system.

To better understand Devices as entities in the context of the ThingsBoard platform, please refer to this documentation.

Device Management on Edge Instance

A Device entity can be created directly on the Edge instance and automatically pushed to the Cloud (Server) once a connection is established. Any changes made to the Device entity are seamlessly provisioned to the Cloud (Server) without requiring additional action, ensuring that updates are synchronized across all Edge instances.

Once the Device is created on the Edge instance, it is also pushed for creation on the Cloud (Server), ensuring consistency and efficient management of the entire system.

Creating Device on Edge Instance

Doc info icon

Before you create a Device, make sure to create and configure a Device Profile.

You can create and provision Device manually, deploy multiple devices from a CSV file with a Bulk Provisioning option, or use the REST API for programmatic deployment. To create the Device manually, follow these instructions:

  • Any Tenant administrator user is able to create Device entities on the Edge instance. Go to the Entities > Devices section and click the "Add new device" button.
  • In the pop-up window, fill in the required Device details fields, such as "Name" and "Device profile". Confirm the action by clicking the "Add" button.
  • To check connectivity, send telemetry on behalf of the Device using shell by following the on-screen instructions.
  • To check if the new Device has been deployed to the Cloud (Server), log in to your Cloud (Server) and navigate to the Entities > Devices section: the newly created Device will be automatically assigned to the Cloud (Server).
Any <b>Tenant administrator</b> user is able to create <b>Device</b> entities on the <b>Edge instance</b>. Go to the <b>Entities > Devices</b> section and click the <b>"Add new device"</b> button.
Any Tenant administrator user is able to create Device entities on the Edge instance. Go to the Entities > Devices section and click the "Add new device" button.
In the pop-up window, fill in the required <b>Device details</b> fields, such as <b>"Name"</b> and <b>"Device profile"</b>. Confirm the action by clicking the <b>"Add"</b> button.
In the pop-up window, fill in the required Device details fields, such as "Name" and "Device profile". Confirm the action by clicking the "Add" button.
To check connectivity, send telemetry on behalf of the <b>Device</b> using shell by following the on-screen instructions.
To check connectivity, send telemetry on behalf of the Device using shell by following the on-screen instructions.
To check if the new <b>Device</b> has been deployed to the <b>Cloud (Server)</b>, log in to your <b>Cloud (Server)</b> and navigate to the <b>Entities > Devices</b> section: the newly created <b>Device</b> will be automatically assigned to the <b>Cloud (Server)</b>.
To check if the new Device has been deployed to the Cloud (Server), log in to your Cloud (Server) and navigate to the Entities > Devices section: the newly created Device will be automatically assigned to the Cloud (Server).

Assigning Devices from Cloud to Edge

Devices can be created on Cloud (Server) and then provisioned to the Edge instance. Log in to your Server (Cloud) and go to the Edge management > Instances section.

  • The variety of buttons on the "Instances" page will help you to manage different entities, and assign them accordingly to the Edge instance. To assign a Device, click the "Manage devices" button.
  • On the "Edge devices" page, click the "+" icon and then select the Device(s) from the drop-down list in the pop-up window. Confirm the action by clicking the "Assign" button.
  • To confirm that the Device has been assigned to the Edge instance, log in to your Edge instance and go to the Entities > Devices section.
The variety of buttons on the <b>"Instances"</b> page will help you to manage different <a href="/docs/user-guide/entities-and-relations/" target="_blank">entities</a>, and assign them accordingly to the <b>Edge instance</b>. To assign a <b>Device</b>, click the <b>"Manage devices"</b> button.
The variety of buttons on the "Instances" page will help you to manage different entities, and assign them accordingly to the Edge instance. To assign a Device, click the "Manage devices" button.
On the <b>"Edge devices"</b> page, click the <b>"+"</b> icon and then select the <b>Device(s)</b> from the drop-down list in the pop-up window. Confirm the action by clicking the <b>"Assign"</b> button.
On the "Edge devices" page, click the "+" icon and then select the Device(s) from the drop-down list in the pop-up window. Confirm the action by clicking the "Assign" button.
To confirm that the <b>Device</b> has been assigned to the <b>Edge instance</b>, log in to your <b>Edge instance</b> and go to the <b>Entities > Devices</b> section.
To confirm that the Device has been assigned to the Edge instance, log in to your Edge instance and go to the Entities > Devices section.

Next Steps