About Thingsboard integrations
In order to retrieve data from outside sources and link them up to devices Thingsboard has created instances in their platform that go under the name of integrations. These integrations uses a data converter to read and format the data properly before the data is linked to a device type. When the device type is decided, the device name decides where the data will end up. Furthermore, the devices will be reachable in the dashboards to visualize data.
Configure and create integrations
Add integration
To create an integration you will need to navigate to that section of the platform. Press 
on the left hand side followed by 
in the bottom right corner. This will open a new window in the platform that should look like the image in the next section "Configure integrations".
Configure integration
NOTE: The name of the integration is denoted wrongly as "wind-buoy-converter" it should be "wind-buoy-integration".
In the image above the integration is given a name. You also specify which type of integration this is. This changes the different options for connection, on our Thinsboard-platform we have only used MQTT so far, thanks to the MQTT-broker at our disposal. Furthermore, the IP-adress and port of said broker are entered for the connection.
In the next image (above) you add the topic the integration subscribes to. It is important that this topic only receives data of the expected format for the data converter, otherwise the data will not be processed correctly and will not be saved in the database. For the wind data from buoys the correct topic would be, dataset/boye/e39/wind. This is decided by where the data-gathering scripts publishes their data. All the wind data from several devices can be published to the same topic since the devices of the same device type uses the same integrator. Hence, the data get filtered to the different devices based on device type and device name.
In the last image you enter which device types this integrator belongs to. In this instance the integrator belongs to the wind-buoy devices and as such expects data from wind buoys.
Remarks
As shown above you specify which data you expect, and which device type it belongs to. All the data of that type will be published to the same topic and then gets filtered to Thingsboard with respect to the device name. It is therefore important to name the devices in Thingsboard to the same name as it is published from the data sources. For more information about devices, look here.
Additional resources
You can read more about integrations from Thinsboards own documentation, here.
| Table of Contents |
|---|