The Kerlink Wanesy Management Center is a LoRa Network Server implementation wich is developed and provided by the French company Kerlink.

Setting up a Kerlink Network Connection

This setup guide assumes that the following preconditions are satisfied:

  • a Kerlink LNS organization has been created,
  • a user account in this organization has been created with Clusters, Endpoints and Gateways management privileges and its credentials are known,
  • a gateway is currently connected to the LNS,
  • Optional: an Endpoint (IoT device) is created, has joined the network, and is sending data regularly.

Steps to setup working Kerlink LNS connector in thingsHub

  1. Create Cluster in Kerlink LNS UI
  2. Configure Kerlink LNS Cluster
  3. Create network connector in thingsHub

1. Create Cluster in Kerlink WMC3 LNS UI

In Kerlink LNS UI go to Administration → Clusters → Add Cluster (big plus button on bottom right corner). Set new cluster name and press VALIDATE.

2. Configuring Kerlink LNS cluster

After connector successfully created user need to configure Cluster in Kerlink LNS UI:

Go to Administration (1 on image) → Clusters (2) → Press on Pencil icon (3).

Required configuration:

  • Customer: any

  • Name: any

  • Payload Type: select "Hexadecimal"

  • Push Section

    • select "Enable"

    • Type: select "HTTP"

    • Message Detail Level: select "Network"

    • URL: set value to "data_up_url" from thingsHub connector configuration (for example 

    • Username: leave blank, not used

    • Password: leave blank, not used

After editing finished press VALIDATE (4 on image).

Tipp

The correct setting for the URL parameter can be found in your newly created thingsHub Network Connector as "data_up_url" attribute:


3. Creating Kerlink LNS network connector in thingsHub

In the thingsHub Web-UI select "Network Connections" and click the button "Connect IoT Network".

Config parameters:

  • server - Kerlink LNS instance URL (usually, https://lns.smartmakers.io)
  • login - account name to be used
  • password - account password, used for authorization
  • cluster_id - ID of cluster (concept similar to Device Group in thingsOS) to receive receive data from. See image below to retrieve value:

         
 

                Go to Kerlink LNS UI → Administration (1 on image) → Clusters (2) → Copy Cluster ID value (3)

When connector object is created thingsHub will attach data_push_url read-only parameter to config section.


REST-API Network Connector Configuration

ParameterDescription
nameThe Connector's display name. 
typeThe string wmc3.
auto_activateTrue for auto activation, false otherwise.
config.serverThe LNS's URL (including schema and suffix /gms).
config.cluster_idThe cluster's ID (will be used together with config.server to assemble sub-URLs).
config.loginThe login (username) of the user as who the Network Connector will log in at the LNS.
config.passwordThe password of the user as who the Network Connector will log in at the LNS.

Kerlink connector example

{
  "config": {
    "server": "https://lns.smartmakers.io",
    "cluster_id": 4711,
    "login": "stanley",
    "password": "swordfish"
  },
  "name": "example",
  "type": "wmc3",
  "auto_activate": true
}
JS