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 kerlink.
auto_activateTrue for auto activation, false otherwise.
config.serverThe LNS's URL (including schema).
config.cluster_idThe cluster's ID (will be used together with config.server to assemble sub-URLs).
config.usernameThe 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://ranpreprodmutocea.wanesy.fr",
    "cluster_id": 4711,
    "username": "stanley",
    "password": "swordfish"
  },
  "name": "example",
  "type": "kerlink",
  "auto_activate": true
}
JS

Setting up a Kerlink Network Connection

This setup guide assumes that the following preconditions are satisfied:

  • a Kerlink LNS organisation has been created,
  • a user account in this organisation 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 LNS UI

In Kerlink LNS UI go to Administration → Clusters → Add Cluster. Set new cluster name and press Add Cluster.

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 server url",
      "username":"Kerlink server authentication username (used for sending TX messages - downlinks)",
      "password":"Kerlink authentication password (used for sending TX messages - downlinks)",
      "cluster_id":"Integer Kerlink cluster ID to receive RX messages from"
   },
   "name":"kerlink-test-ns",
   "type":"kerlink"
}

Config parameters:

  • server - Kerlink LNS instance URL (usually, https://ranpreprodmutocea.wanesy.fr)
  • username - 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 rx_messages_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
  • Access Type: select "REST"
  • Message detail level: select "Network"

  • Decrypt Payload: check box
  • Payload Type: select "Hexadecimal"
  • Trust Key Management: leave empty
  • Push section:
    • URL: set value of rx_messages_url parameter from thingsHub connector configuration
    • Username: leave blank, not used
    • Password: leave blank, not used
    • Content Type: leave default value ("application/vnd.kerlink.iot-v1+json")

After editing finished press EDIT CLUSTER (4 on image)