Kerlink WMC3 / Wanesy Management Center

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

Create Cluster in Kerlink LNS UI
Configure Kerlink LNS Cluster
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

Parameter	Description
`name`	The Connector's display name.
`type`	The string `wmc3`.
`auto_activate`	True for auto activation, false otherwise.
`config.server`	The LNS's URL (including schema and suffix _/gms).
`config.cluster_id`	The cluster's ID (will be used together with `config.server` to assemble sub-URLs).
`config.login`	The login (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://lns.smartmakers.io",
    "cluster_id": 4711,
    "login": "stanley",
    "password": "swordfish"
  },
  "name": "example",
  "type": "wmc3",
  "auto_activate": true
}

JS