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

Connection 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

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,
  • and 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. Create network connector in thingsHub
  3. Configure Kerlink LNS Cluster

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. Creating Kerlink LNS network connector in thingsHub

Kerlink LNS is regular network connector type supported by thingsHub . To create do POST http://<instance>.thingshub.smartmakers.de/index.html#/NetworkServers/CreateNetworkServerConnection following body:

{  
   "auto_activate":true,
   "config":{  
      "server":"Kerlink WMC3 server url",
      "login":"Kerlink WMC3 server authentication login or username (used for sending TX messages - downlinks)",
      "password":"Kerlink WMC3 authentication password (used for sending TX messages - downlinks)",
      "cluster_id":"Integer Kerlink cluster ID to receive RX messages from"
   },
   "name":"wmc3-test-ns",
   "type":"wmc3"
}

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.

3. 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:

  • Name: any name
  • Payload Type: select "Hexadecimal"
  • Type: select "HTTP"
  • Message detail level: select "Network"

  • Push section: Enabled
    • URL: set value of data_push_url parameter from thingsHub connector configuration
    • Username: leave blank, not used
    • Password: leave blank, not used

After editing finished press VALIDATE (4 on image)