TheThingsIndustries

Info

In this guide we will show you how you connect the TheThingsIndustries LNS to Datacake and how you set up the configuration for both Uplinks and Downlinks.

TTIv3 / TTNv3

The following description applies to both the TTI and the "new" TTN - the TheThingsStack Community Edition network.

Create Integration on TTI

On your TTI Application select Integrations on the Side-Bar
    Navigate into the "Webhook" Section of the Integrations on your Application
    Add a new Webhook by clicking the Button "+ Add webhook"
    This will show you a list of available webhook-templates you can chose from:
    Chose the "Datacake" Webhook Template
    Your browser will show you the following page
    Now we need to create an API Key on Datacake for Webhook Authentication
    Navigate over to your Datacake Workspace and select "Members" from Sidebar:
    In the members section you select "API Users" from Tab-Bar
    After switching to the API Users Tab you click on the upper right Button "Add API User"
    This will show you the following dialog:
    First of all enter a name for your API User (like "TTI Webhook API User")
    Next select "Devices" from Workspace Permissions List
    Click on "Add Permission for all Devices in Workspace"
    The following element will be added to the modal:
    Here you select "Can record measurements"
    Press "Save" to create the Token
This API Token is now valid for all devices in your workspace. Everytime you create a new device, this Token does automatically work for that device.
If you are interested in creating a Token for selected Devices only, you can navigate into the device and select the token from there. But you have to leave out the "All devices in workspace"-Permission here.
    Next copy the Token from Datacake (click on the "Show" Button to see and copy the Token)
    Now switch back to your Application on TTI:
    Paste the copied Token into the field "Token"
    Create Datacake Webhook on TTI by clicking on the "Create datacake webhook" Button
That's it. You've now created and set up the Datacake Integration on your TheThingsIndustries Instance. If you have any questions please feel free to ask us.

Downlinks

In order to be able to queue up Downlinks on your TTI Application you need to provide additional detail on your Datacake-Device. To set the configuration please move into the LoRaWAN settings on the corresponding device:
When you scroll down a little bit you get to the following section.
As mentioned in the screenshot please click on "Change" to open up the configuration for Downlink Configuration. This will bring up the following dialog:
In this Dialog you need to fill in the 4 textboxes with Information that you find on the TheThingsStack Console.

TTI Dev-ID

This is the ID of your Device in your TTI Application. You find it here:

TTI Server URL

This is the URL of your TTI Instance as available to the public.
    For public TTNv3: eu1.cloud.thethings.network
    Example: datacake.eu1.cloud.thethings.industries (Datacake TTI URL)
Please leave out the trailing slash / and provide the URL without HTTPS:// or any other prefix.
    OK: datacake.eu1.cloud.thethings.industries
    OK: eu1.cloud.thethings.network
    Wrong: https://datacake.eu1.cloud.thethings.industries/
    Wrong: datacake.eu1.cloud.thethings.industries/

TTI Application ID

This is the ID of your Application on TTI:

TTI Api Key

Create TTI API Key

    To create a new API Key on TTI head over to the "API keys" page using the left sidebar:
    Now click on "Add API Key"
    The following dialog will appear:
    Set a custom name (like "datacake-api-key")
    And set corresponding rights to allow queuing up downlinks
    Create the API Key by clicking on "Create API key"
    After you created your API Key you will see the above notification
    Please copy your key to your clipboard as it will only be shown once!
    Paste this key into the device settings on Datacake

Final Settings

When you are done copying the dialog show look something like this:

Update and Save

Please don't forget to press the Update button when done setting the new Downlink Settings:
And please also don't forget to press "Save". (we know this is stupid that there is no autosafe and so we will bring this feature - but in the meantime please be patient - we apologize for this UX disastere here :D).
Last modified 5mo ago