ThingsBoard

Direction: MO

Third-Party open-source IoT platform for data collection, processing, visualization, and device management.

For more information: thingsboard.io

• Host Name - Where ThingsBoard is hosted; default: thingsboard.cloud
• Access Token - Authentication details for ThingsBoard - e.g. z3fIvHi3cudj8DHUQDAN when using Device Telemetry 4c9c76fd-b2cf-86fd-5c29-269cb3674228 when using Integrations
• Format - How Messages are sent to Thingsboard
  • Lingo - LingoMO (JSON)
  • Message - Just the transmitted message payload
• Upload Type - The method of delivering data to ThingsBoard
  • Device Telemetry - Directly assigns telemetry to the Device associated with the access token
  • Integrations - Delivers data to your configured integration, access token acts as integration ID

Process

Upon receipt of Messages, the platform will relay the message across to ThingsBoard in the format as prescribed.

Setup

ThingsBoard is available as both a cloud-hosted service; as well as an open-source application that you can install within your own environment. These are the key steps required to utilise the cloud-hosted service:

Device Telemetry Upload Type

Within ThingsBoard:

1. From the main menu: Entities > Devices
2. Add Device [ + ]
3. Select Add New Device from the sub-menu
4. Click Next Credentials
5. Copy Access Token (e.g. z3fIvHi3cudj8DHUQDAN)

Within Cloudloop:

6. Create new ThingsBoard destination
7. Host Name = e.g. thingsboard.cloud / eu.thingsboard.cloud or your own host if applicable
8. Access Token = token copied in Step 5
9. Format = Message
10. Upload Type = Device Telemetry
11. Send some data from your Device
12. See it appear in ThingsBoard like magic

Integrations Upload Type

Within ThingsBoard:

1. From the main menu: Integrations Center > Integrations
2. Add Integration [ + ]
3. Integration type HTTP
4. Create a new data converter or use existing, if using Message format then JSON will appear as {'message': <Base64>}, if using Lingo it will be a LingoMO
5. Copy the UUID from the end of the HTTP endpoint URL e.g. 4c9c76fd-b2cf-86fd-5c29-269cb3674228 this will be used as the access token. (note this is not the same as the Integration ID)

An HTTP Integration with the url UUID highlighted

Within Cloudloop:

6. Create new ThingsBoard destination
7. Host Name = e.g. thingsboard.cloud / eu.thingsboard.cloud or your own host if applicable
8. Access Token = integration ID copied in step 5
9. Choose format
10. Upload Type = Integrations