This article explains how Tenant Owners can connect the thingsHub to a Kerlink Wanesy Management Center server.
The Kerlink Wanesy Management Center (WMC3) is a LoRa Network Server implementation which is developed and provided by the French company Kerlink.
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 Gateway management privileges and its credentials are known
A gateway is currently connected to the LNS
Endpoint(IoT device) is created, has joined the network, and is sending data regularly.
The server connection process
Create a Cluster in the Kerlink LNS UI
Begin the Kerlink LNS Cluster configuration
Create network connector in thingsHub
Complete the Kerlink LNS Cluster configuration
Setting up a Kerlink WMC3 network connection
Step 1) Create a Cluster in the Kerlink WMC3 LNS UI
1) In the Kerlink LNS UI, go to Administration > Clusters and press the Add Cluster button (the big plus button located in the bottom right corner).
2) Enter the new cluster name and press VALIDATE.
Step 2) Configuring a Kerlink LNS cluster
1) Go to Administration > Clusters and press the Pencil icon to open the configuration form.
2) Complete the form per the below requirements and then press the Validate button.
Payload Type: select "Hexadecimal"
Type: select "HTTP"
Message Detail Level: select "Network"
Username: leave blank, not used
Password: leave blank, not used
URL: set value to "data_up_url" from thingsHub connector configuration.
The correct setting for the URL parameter can be found in your newly created thingsHub Network Connector as "data_up_url" attribute:
Step 3) Creating a Kerlink LNS network connector in thingsHub
1) Open your thingsHub tenant, go to Tenant Settings > IoT Network Connections, and then select the Connect IoT Network button.
2) In the Connect to IoT Network dialog, enter information in the fields as described in the parameters table below. Then press the Connect button.
The display name of this Network Connection.
Choose Kerlink WMC3
Kerlink LNS instance URL (typically, https://lns.smartmakers.io)
ID of cluster (concept similar to Device Group in thingsOS) to receive data from. See image below to retrieve value:
The username of the user as whom the thingsHub will use to manage the SPN.
The password of the user as whom the thingsHub will use to manage the SPN.
Auto Register New Devices From Network (Server)
Set this toggle switch to false if you want to manage the device on your network server via the thingsHub. Set this to true, if there are already devices registered in this application or if you want to manage the application manually.
If this is set to true, any device that’s already registered in the application will show up in the thingsHub automatically, when it sends data for the first time since creation of the Network Connection.
Step 4) Complete the Kerlink Cluster configuration
1) In the Kerlink LNS UI, go to Administration >Clusters and select Copy Cluster ID value.
Results: When the connector object is created, thingsHub will attach a data_push_url read-only parameter to config section.
You can now connect your devices via this network connection with the thingsHub. You can either add a new device now and connect it during this process, or connect an existing device on the device’s Network tab.