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

Connection Configuration

Parameter	Description
`name`	The Connector's display name.
`type`	The string `kerlink`.
`auto_activate`	True for auto activation, false otherwise.
`config.server`	The LNS's URL (including schema).
`config.cluster_id`	The cluster's ID (will be used together with `config.server` to assemble sub-URLs).
`config.username`	The username of the user as who the Network Connector will log in at the LNS.
`config.password`	The 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:

Create Cluster in Kerlink LNS UI
Create network connector in thingsHub
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)