IoT - Tektelic + TagoIO - Integration
As discussed in posts before, the data coming from the sensors is only beneficial to us when it is displayed in a usable manner. The application server being used here is TagoIO, we could easily use Azure IOT Hub, or Things Network, etc. So our setup looks like something below allowing us to take the data from Tektelic Kona Network Core Server and push it to TagoIO.
In this guide, we will integrate the Tektelic Server with TagoIO and build a dashboard similar to the one below. (Note, TagoIO has recently updated their Dashboard, image below is of the old version)
Step 1.
Before we start making our Integration, we need to create a Data Converter to allow for the data from Tektelic server to be legible by TagoIO.
Select Data Converter management and click on the + icon to create a new converter.
Choose an appropriate name, in our case we chose TagoIO.
For the converter type, we can use Tektelic Home Sensor or Custom. We chose Custom as we do have other sensors we would like to add.
Next go to Applications tab on the side menu and select the Manage Integrations (Puzzle Icon) in the Application you want to Integrate.
Add a new Integration and name it appropriately, next select TagoIO as the type and for the converter, choose the data converter we created in the previous steps.
Step 2.
To get the Authorization, we need to go to TagoIO platform and grab it from there. Make sure you have made an account and verified it before proceeding.
From the main menu on TagoIO select Devices and on the top right you will see Authorization.
Click on it and then create a new Authorization by entering an appropriate name and then just select Generate.
Next, click on copy to copy the authorization and paste it back into Tektelic Integration.
Copy the HTTP URL PATH and then click on Add to finish the integration.
Paste the HTTP URL PATH on Notepad as we need it for the next step.
Step 3.
In this last part we need to edit the Authorization on TagoIO end with the copied HTTP URL PATH from Tektelic Integration.
Copy the web address of the Tektelic server, in our instance it is “ https://lorawan-ns-na.tektelic.com/” we don’t need the rest of the path from here.
Paste it on the notepad followed by the HTTP URL PATH from the Integration in the previous step.
| Tektelic Server Address | + | URL Path - Tektelic Integration |
|---|---|---|
| https://lorawan-ns-na.tektelic.com | + | /api/v1/integration/7b3706bb2d9b3a3e0abd2bb3dcf3530c |
Make sure to delete the additional “/” so it looks like “https://lorawan-ns-na.tektelic.com//api/v1/integration/http/076253122d1c5a47860e48a86f3886a5”
Copy this complete path and head back to TagoIO to the Authorization Page and select Edit Parameter (Pencil Icon) and paste it and Confirm Change to finalize it.
Step 4.
Next we add a device and check if the integration is working as intended or not.
Select Devices from the TagoIO menu and click on Add Device.
On the left side in Networks selection, choose Tektelic Server and search for your device.
Next rename the device and add the DEV UI (Can be copied from Tektelic Server) and click Create my Device.
From the Devices menu, select the newly created device and click on the Live Inspector tab and leave it open. After an hour or so, you should see payloads come through to confirm the Integration is working.
If there are any issues, double check the integration settings and reach out to Tektelic/TagoIO Support.
Step 5.
Finally, we can play with the dashboard and make sure our data is easily legible.
From the menu on the left in TagoIO, create a new Dashboard and name it appropriately.
Next click on Add Widget and choose the widget that you would like to use.
In the Device section of the widget configuration, click on the drop down menu and select your device.
Next select a variable you would like to display in the widget and click create. (Note there are lots of configurations available, e.g. conditional coloring, formulas, units and embedding)
To check out a full suite of solutions available in New Zealand, check out the
TagoIO also offers Actions, offering a very powerful feature that gives you total control over your devices based on events determined by you.
With Actions you can:
Send a SMS based on certain conditions;
Send an Email based on certain conditions;
Run scripts using Analysis;
Make HTTP Post requests;
Send notifications to your account or the account of your Run Users;
Publish to a MQTT topic based on certain conditions;
