Integrate with The Things Network (TTN) - KOLIBRI Cloud Sending Technology

Warning: Upcoming ‘The Things Network’ V2 to V3 migration

The Things Network is changing from V2 to V3 stack. This means:

From April 2021 on, no new devices can be added to the old V2 stack at https://console.thethingsnetwork.org/. V3 is available on https://eu1.cloud.thethings.network/console/
The devices working with TTN and the KOLIBRI Cloud will still work.
TTN plans to shut down all V2 servers in September 2021. From then on all devices and gateways needs to be migrated.
The KOLIBRI Support team updated its backend: V2 and V3 work in parallel.
There might be a point where all LoRaWAN devices and Gateways working over TTN will have to be updated.
For this scenario we will implement, test and inform all customers as soon as possible.

An account on ‘The Things Network’. If you do not have one than please sign up on https://www.thethingsnetwork.org/
A KELLER LoRa device (ADT1 LoRa or ARC1 LoRa)
GSM setup tool and a USB connector cable (ARC1: K114 interface converter / ADT1: Micro USB cable)
The Device EUI number of the device (Use the GSM setup tool to extract the EUI)
The Application EUI number of the device (Use the GSM setup tool to extract the EUI)
The KOLIBRI Endpoint URL which is: https://devspakellercloudfunctionapp.azurewebsites.net/api/HttpTriggerCSharp_PascalTTN?code=eQxVYd76shpatS8av6lzsn3XxNEbtCiE9psrJaasyeMk/fudmQQ5uw==

During the order of the device ask your sales person to let the device pre-configure by the KOLIBRI support team. This helps to speed up and simplify your configuration work. Technical documentation for the configuration of a KELLER LoRa-device can be found here.

Go to https://eu1.cloud.thethings.network/console/ and +Add Application if you do not have one. Set a Application ID and the Owner.

In the application (eg https://eu1.cloud.thethings.network/console/applications/app-for-my-company) +Add end device with
- Activation mode: OTAA
- LoRaWAN version: MAC V1.0.2

Set the Basic settings by
- Choosing an End device ID name
- Entering the AppEUI from the device (See How to configuring a LoRaWAN device)
- Entering the DevEUI from the device (See How to configuring a LoRaWAN device)

Set the Network layer settings by
- Choosing an frequency plan. In Europe choose “Europe 863-870 MHz (SF9 for RX2 - recommended)"
- Choosing Regional Parameter version: PHY V1.0.2 REV B

Set the Join settings by
- Generate an AppKey and store the key. This key is needed to assign, verify and program the device.

If you forgot to store the key. It is also possible to copy the key after adding the device:

Connect your PC using the GSM setup tool and
- Check if you used the same Application EUI
- Enter the generated App Key from Step 6
- Program your device (See How to configuring a LoRaWAN device)

If you have a TTN gateway in reach you should now be able to communicate with the TTN server.
When you want to register a new TTN gateway into TTN V3 then go to https://eu1.cloud.thethings.network/console/gateways/add
- Enter the Gateway EUI from the Gateway and choose a Gateway ID
- Use the same frequency plan and set the Gateway Status to Public

This step is optional. You can add the KELLER Payload Decoder to decode the payload string into readable Measurements/Information visible in the Live-Editor.
- The most recent KELLER Payload Decoder code is on Github
- Got to Payload formatters in your application and paste the decoder code into Uplink using Javascript formatter type.

To make your device visible on www.kolibricloud.ch it is needed to add it
- In the Account Settings on https://www.kolibricloud.ch enter the Device EUI of the LoRa device and press Add Device
- The device should now be visible in the device list. If adding is not possible and a red popup is shown, please contact the KOLIBRI Support Team kolibri@keller-druck.com

wait until the KOLIBRI Cloud support assigned the device to your group. otototototottotoot

Access to the TTN portal https://www.thethingsnetwork.org/. An account is free and the entry page is https://console.thethingsnetwork.org/
A KELLER LoRa device
The EUI number of the device (Use the GSMSetup-tool to extract the EUI)
The App key (Use the GSMSetup-tool to write the key)
The KOLIBRI Endpoint URL which is: https://devspakellercloudfunctionapp.azurewebsites.net/api/HttpTriggerCSharp_PascalTTN?code=eQxVYd76shpatS8av6lzsn3XxNEbtCiE9psrJaasyeMk/fudmQQ5uw==

A KELLER LoRa device can be added to the KOLIBRI Cloud using the following steps:

During the order of the device ask your sales person to let the device pre-configure by the KOLIBRI support team. This helps to speed up and simplify your configuration work. Technical documentation for the configuration of a KELLER LoRa-device can be found here.

Go to https://console.thethingsnetwork.org/ and Create a application server. Use the given app key and program it into the LoRa device using the GSM setup tool and program the device with the application key.

Verify your connection with your gateway by seeing a transmission with a payload in the TTN console. You may optionally use the KELLER LoRa Payload Decoder code to decrypt the real channel values and visualize them in the TTN console.

Choose HTTP integration and enter a POST method to forward the URL to
https://devspakellercloudfunctionapp.azurewebsites.net/api/HttpTriggerCSharp_PascalTTN?code=eQxVYd76shpatS8av6lzsn3XxNEbtCiE9psrJaasyeMk/fudmQQ5uw==
This will forward a transmission to the KOLIBRI Cloud.
Process ID : Enter the name of the integration which doesn’t have an effect
Other fields are empty:
- Authorization: Leave empty
- Custom Header Name: Leave empty
- Custom Header Value: Leave empty

If the device is already in a accessible KOLIBRI Cloud group it should be possible to see new measurement data from the device. With the connected GSMSetup-tool it is possible to manually execute the sending of measurement data or device information. If the device is not visible on www.kolibricloud.ch then please wait until the KOLIBRI Cloud support assigned the device to your group.