Hello LoRaWAN® and ThingPark®

Implementation Steps

Step 1 - Create an Account on ThingPark Community Portal (TPCP)

In order to manage your LoRaWAN® network, we are going to use the ThingPark Community Platform (TPCP), which is powered by ThingPark Enterprise running in the cloud. In Step 1, you are going to create an account on ThingPark Community Portal, which provides free access to TPCP Platform for any non-commercial use up-to 50 LoRaWAN® end-devices. You can configure one or multiple gateways to create your network: in general LoRaWAN® networks provide a better quality of service when you have macro-diversity (i.e. multiple gateways are able to receive device uplinks).

In order to create a ThinkPark Community account, please visit ThingPark Community

This portal provides information about LoRaWAN® and related IoT topics. We are going to use that page to create an account on TPCP.

  1. Select Sign Up as shown.
  2. Fill the form. Note that all fields with “*” are required.

Step 2 - WiFi Configuration of LoRaWAN® Gateway

For the MiniHub LoRaWAN® Gateway to connect to the TPCP platform via the Internet, it needs to be connected to a WiFi network. To achieve this, follow these steps:

  1. Switch MiniHub into WiFi AP mode.
  2. Access to MiniHub and enter credentials (passcode).
  3. Select the WiFi Network to use in normal operation.
 

When Mini Hub switch into AP mode, on your computer, you can see the Mini-Hub AP in available WiFi Network list. Please notice that in our case, AP name is MINIHUB_800203

* Please notice that last 6 digits of the WiFi Network name are the Serial number of your MiniHub.

When the gateway is successfully connected to the WiFi Network you selected, the following screen displays and the MiniHub gateway reboots automatically.

  • Notes :
    • You will not be able to access the gateway via web browser again.
    • Accessing the gateway is only possible on AP mode (Config mode).

Step 3 - Provisiong the LoRaWAN® Gateway on TPCP

To use your LoRaWAN® Gateway, you need to register (provision) it into your account on TPCP. If you purchase your gateway from TPCP Market, your gateway is already configured and registered into your Actility account. In this case, you can skip this step.

  1. Log into ThingPark Community Portal.
  2. On home page, go to ThingPark Platforms.
  3. Click ThingPark Admin Console (see Figure).
 

Note : ThingPark Admin Console redirects to the ThingPark Enterprise (TPE) dashboard. TPE dashboard shows Base stations, Devices, Alerts and Messages

* When you login to TPCP for the first time, there are no registered gateways, devices or connections/applications.

If you purchased the MiniHub gateway from TPCP Marketplace, and your TPC and marketplace accounts share the same email address, the gateway is already configured and registered into you Actility account.

The home page looks like this:

When selecting the gateway from the list, the gateway details are displayed, like illustrated in the Figure. If you completed the WiFi connection in Step 2, the gateway status is ONLINE (Green).

Step 4 - Creating a Backend Application

In order to process collected data from the end-device, you need to have a backend application for further processing. To keep this activity simple, we are going to use a web site (https://webhook.site/) which launches a free HTTP end-point to receive your data.

In order to create a page at webhook web site, you need to visit the site. A page will be created automatically so you can monitor the collected Device Data. See Figure.

webhook.site
** Once you have completed Step 6, you will be able to see data coming from the Device.

Step 5 - Registration of Backend Application on TPC Platform

On TPCP, a Connection is a link to an Application Server for backend processing. Connection provisioning is the definition of introducing “end point to communication”. To define Connection, only 3 information are required:

  • Connection type, type of the backend system.
  • Name, any name you wish.
  • URL copied from Step 4 – Creating a backend application, URL of the backend system.

You will create Connection definition which points to backend application. At the TPCP Admin console you can create application definition which will point to backend service which had been created at Step 5.

 

Now, you have to select the type of transport protocol that you going to use as backend service. In our example, we are going to use https:// service.

You need to fill in the required information:

Step 6 - Creating a Device

The final step of implementation is the device registration on the TPCP, which requires the following information:

  • Device Manufacturer/Type
  • DevEUI
  • Activation mode
  • JoinEUI
  • AppKeya

DevEUI and AppKey parameters are crucial to ensure the communication between the device and the ThingPark platform.

Note: For Tinovi devices, DevEUI and AppKey are written on the sticker inside the device. See Figure

* Providing the AppKey value on (inside) the device presents a practical way for a device used in R&D, but this method shall not be used with devices in production due to its obvious security weakness.

To access the device creation form:

Now, you must insert battery into your LoRaWAN® device and ensure it is sending data*

*Please notice that your device just transfers data, but it does not mean that data are received by TPE.