Back to blog Back to blog

Actility Integration: Connecting LoRaWAN Device to WolkAbout IoT Platform

Actility Integration: Connecting LoRaWAN Device to WolkAbout IoT Platform

About LoRaWAN

LoRaWAN (Long Range Wide Area Network) is a Low Power, Wide Area (LPWA) networking protocol designed to wirelessly connect battery operated devices to the Internet. It targets key IoT requirements such as bi-directional communication, end-to-end security, mobility, localisation services and longer battery life.

LoRaWAN is being deployed for nationwide networks by major telecom operators, and the LoRa Alliance is standardising LoRaWAN to make sure different nationwide networks are interoperable.

Actility and WolkAbout Partnership

WolkAbout closely collaborates with leading LoRaWAN network providers to deliver an easy onboarding experience to its customers.

One of our partners is Actility, a leading LPWAN solution provider and a key contributor to the LoRaWAN specification. Their ThingPark Wireless is a connectivity platform for large scale LPWAN deployments using the LoRaWAN technology.

We have integrated with Actility’s ThingPark Wireless to enable our customers to monitor, control and capture information from their LoRa devices simply and securely. Together we simplify the adoption of IoT use cases by extending the capabilities of WolkAbout IoT Platform.

About WolkAbout IoT Platform and ThingPark Wireless Integration

WolkAbout can interface with LoRa devices through Actility’s ThingPark Wireless. As this is the first, experimental stage of the integration, currently you can provision and deprovision LoRa devices easily by using WolkAbout Device Management. No interaction in the ThingPark user interface is required.

Furthermore, you can make use of existing WolkAbout features, like device management, data semantics, rule engine, real-time data visualisation with dashboards, historical overview of the data with reports and more.

We currently support ABP (Activation by Personalization) and OTAA (Over the Air Activation) device registration for all device types that require the following parameters:

  • Device key (for both activation types)

For ABP:

  • Network address
  • Network session key
  • App session key and port

For OTAA:

  • Application EUI
  • Application Key

Your device should use the CayenneLP Protocol.

This manual is intended to guide you through the process of connecting Actility LoRaWAN device through WolkAbout IoT Platform.

It is written for ThingParkv10.14.4-0dbc4f0c3.

Note that your licence needs to include this feature. If you do not see the functionality described in this document, please contact support.

Instructions

Routing

Log in to your account on the Thing Park Device manager.

Go to the Application servers tab and click the create button.

Name your application server and select the type HTTP Application Server (LoRaWAN).

This will create an application server and redirect you to fill in more details.

From the Content Type dropdown in the Application server section, select JSON untyped.

Add a route with the following parameters:

Actility Integration Instructions 1

Next, go to the AS routing profiles tab and click the create button.

Name it and select LoRaWAN as the type.

This will create a routing profile and redirect you to fill in more details.

In the Destinations section click add. Select Local application server as Type and your previously created application server as Destination.

Actility Integration Instructions 2

Locate your routing profile on the list and remember its ID.

This is how the routing profile will be displayed on our Platform.

Generating Token

Log in to the ThinkPark DX Admin API.

Expand the ‘POST /OAuth/token’ and fill it out with the relevant data (renewToken and validityPeriod are optional).

Actility Integration Instructions 3

After clicking the Try it out button, you will get the access_token field in the Response Body.

Copy the value of that field as you will need it to complete the integration.

Actility Integration Instructions 4

Go to WolkAbout IoT Platform. Click the cog icon and go to Settings.

Actility Integration Instructions 5

In the Settings section, select the Actility Integration tab, paste the previously copied access token and click save.

Actility Integration Instructions 6

You should get a pop-up message Integration created.

This means that the integration is complete!

All you need to do now is create a device on our Platform.

Device Creation

Go to Devices and click the Device Templates tab. Click the plus sign to add a template and select From scratch.

Actility Integration Instructions 7

Choose a descriptive name for your device template.

From the Connectivity type dropdown menu, select Actility (this connectivity type will appear after you’ve created the integration).

For the protocol, select CayenneProtocol.

Actility Integration Instructions 8

In the box below you should define the sensors of your device. At the moment, Actuators, Alarms and Configurations are not supported.

Click on the plus button to start adding sensors.

Actility Integration Instructions 9

Sensor reference needs to be in the following format:

PREFIX_CHANNEL

For instance, if you are sending temperature on channel 1, the sensor reference should be T_1.

In the following table, you can see the supported data types and their respective prefixes.

Actility Integration Instructions 10

After adding all the sensors you need, click Save.

This should redirect you to the Device template details tab of your newly created template.

In the Create device with this template section click on the Create device button.

Review your device template and click the Next step button.

After naming your device, select the appropriate Activation type and fill in the necessary data.

If you would like to manage your data later, tick the Create semantic group from this device.

Actility Integration Instructions 11

Note:

The application session key for ABP should be in the following format:

APP_SESSION_KEY,PORT_NUMBER;

The PORT_NUMBER is the port you’re sending data to.

Click Save, and that’s it!

Your device should now be visible both on the ThingPark and our Platform.

Visualising Data

Here’s how to visualise the data you received after connecting your device.

First, create a new Dashboard.

After this step, add the widgets for the data you need to display.

From then on, the data on the dashboard will constantly be updated as new values arrive.

You can also create reports and rules using this data.


If you need more information on this topic, feel free to contact us.

In the meantime, start building your own solution for free at demo.wolkabout.com.

--

Follow us on social media to keep up-to-date with the latest IoT news and research highlights, and benefit from a range of useful resources: Twitter, LinkedIn, Facebook, YouTube and Instagram.