Skip to main content

CREATING A THINGSBOARD CONNECTION

Collecting Expected Information

Parameters required
UI FieldDescription
Domain NameThe domain name of your Thingsboard account. Example: myhostname.com:8883.
UsernameThe email of your Thingsboard account.
PasswordThe password used to connect to your Thingsboard account.

Domain name

  1. Connect to the Thingsboard platform.

  2. In the Home page, click on the Domain section.

img

  1. If you don't have one already, click on Register domain

img

  1. Enter your domain name and click on Register.
  • Your domain name should appear here.

img

Creating a Connection With API

The creation of a connection establishes a bidirectional messaging transport link between ThingPark X IoT Flow and the cloud provider. Events and commands from multiple Devices will be multiplexed over this messaging transport link.

To do this, you need to use the Connections group resource:

  • POST/connections to create a new Connection instance
  • PUT/connections to update a Connection instance
  • DELETE/connections to delete a Connection instance
Note

We follow the REST-full API pattern, when updating configuration properties for a connection resource. Thus, you must also provide the whole configuration again.

Example for creation of a new connection instance :

POST /connections
{
"connectorId": "actility-thingsboard-iot",
"name": "Actility ThingsBoard (TCP) Connection",
"configuration": {
"hostName" : "thingsboard.cloud:443",
"username" : "tpx-iot-flow@actility.com",
"password" : "HelloWorld"
}
}

The following table lists the properties applicable to a connection instance.

JSON FieldDescription
connectorIdMust be set to actility-thingsboard-iot for THINGSBOARD platform.
hostNameThe domain name of your thingsboard account. Example: cloud.thingsboard.io:1883
usernameThe email of your Thingsboard account.
passwordThe password used to connect to your Thingsboard account.
Important note

All properties are not present in this example. You can check the rest of these properties in the common parameters section.

Creating a Connection From UI

You must have an active THINGSBOARD account prior to creating a THINGSBOARD connection in ThingPark.

You also need to know the parameters that are required to perform this task. To learn more, check Parameters required for connecting to a THINGSBOARD platform.

  1. Click Connections -> Create -> ThingPark X Iot Flow.

img

Then, a new page will open. Select the connection type : THINGSBOARD.

img

  1. Fill in the form as in the example below and click on Create.

img

Note

Parameters marked with * are mandatory.

  • A notification appears on the upper right side of your screen to confirm that the application has been created.
  1. After creating the application, you will be redirected to the application details.

img

Changing the Settings after Creation

You can change the settings parameters such as the domain name, username or password after the creation of the THINGSBOARD application.

To do this, proceed as follows:

  1. Select the THINGSBOARD application for which you want to change one or several parameters.

  2. In the application information dashboard, click on the Edit button corresponding to the parameter you want to change.

img

  1. Enter the new value, and click on the Confirm icon.

img

  • The Confirmation window displays,

img

  • A notification will inform you that the parameter is updated.

img

Limitations

There are currently no known limitations to the THINGSBOARD connector.

Displaying information to know if it worked

  1. Connect to the Thingsboard platform.

  2. In the Home page, select the Dashboard section.

  3. Customize your dashboard to display the correct device's informations.

Troubleshooting

As for now, there are no detected bugs.