The aim of this page is to guide users on how to connect their Wirnet™ Gateway to existing remote LoRaWAN Network Servers (LNS).
Examples given in this page are running with the Basic Station forwarder which is based on LoRa Basics™ Station protocol.
¶ Connect your gateway to Chirpstack LNS
¶ Installation
The Basic station package is not installed by default. Execute the following command to install it on your gateway : sudo apt update && sudo apt install basicstation
¶ Configuration
Once installed, Kerlink Basic Station Packet Forwarder is disabled by default. It should first be configured with the server (CUPS and/or LNS)
With Chirpstack, the example demonstrates the case where there is no authentication.
Please refer to Chirpstack documentation to get more details about this LNS.
The URI of the LNS must be written in /etc/station/tc.uri config file.
To configure basic station, use the klk_bs_config tool. This tool allows to start the basic station service with the configured options.
Example with a Chirpstack-based LNS server named "lns.local"
sudo klk_bs_config --enable --lns-uri "ws://lns.local:3001"
Please note that “simple” websocket is used in this case. URI MUST start with “ws:” (and not “wss:”)
¶ Connect your gateway to The Things Network LNS
¶ Installation
The Basic station package is not installed by default. The following command allows to install it on your gateway : sudo apt update && sudo apt install basicstation-ttn
¶ Configuration
To ease declaration of a gateway on the TTN (thethings.network), TTI (thethings.industries) or TTS (The Things Stack Enterprise / Open Source) LNS, use the klk_ttn_config tool.
Please refer to The Things Stack documentation to get more details about this LNS.
This tool adds the gateway on the server and creates its associated CUPS and LNS keys.
To use this tool, you need:
- an API token
- the API server URL (described for Cloud and Server)
- the chosen frequency plan (list available in this page, take the
IDof the wanted frequency plan)
How to generate an TTI API key?
**Prerequisite**: You have to create a TTI account To automatically connect Kerlink Gateways to TTI LNS, you have to delegate some rights to Kerlink thanks to an “API key”. Please follow those steps:Step 1 - Connect to your TTI user account
Step 2 - Go to Personal API keys OR TTI organization API key
Step 3 - Add a new API key
Step 4 - Create the API key with rights limited to GW creation and edition
Step 5 - Save API key
On TTN
klk_ttn_configcan only be used one time per gateway due to certain TTN constraints (even after removing the gateway from TTN)
On TTI the gateway needs to be removed and purged in order to reuseklk_ttn_config
Take care to the URL format, it will not work if there is a trailing slash at the end
Use TTN configuration tool for TTN LNS
sudo klk_ttn_config -u https://eu1.cloud.thethings.network -t NNSXS.R6D3ABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHI.ABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIABCDEFGHIJKLMNOPQ -f EU_863_870
sudo klk_bs_config --enable
Use TTN configuration tool for TTI LNS where "tenant" is your Tenant ID
sudo klk_ttn_config -u https://tenant.eu1.cloud.thethings.industries -t NNSXS.R6D3ABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHI.ABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIABCDEFGHIJKLMNOPQ -f EU_863_870
sudo klk_bs_config --enable
¶ Connect your gateway to Loriot LNS
¶ Installation
The Basic station package is not installed by default. The following command allows to install it on your gateway : sudo apt update && sudo apt install basicstation-loriot
¶ Configuration
To ease declaration of a gateway on the Loriot LNS, use the klk_loriot_config tool. This tool creates the gateway on the server and installs the resulting LNS credentials on the gateway.
Please refer to LORIOT documentation to get more details about this LNS.
To use this tool, you need:
- an API key
- the API server URL
- a network ID
- LoRaWAN region
List of region available
AU915-928
AS923
CN470-510
CN779-787
EU433
EU863-870
IN865-867
KR920-923
RU864-870
US902-928
- Channel plans (1 to 8) comma separated (optional)
Use Loriot configuration tool
# Use Loriot configuration tool in region US902 with 3 channel plans (US915_CH16_23, US915_CH40_47 and US915_CH56_63)
sudo klk_loriot_config -k ABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJK-321abcdefgh -u https://eu1.loriot.io/1/nwk -n ABCD1234 -r US902-928 -p 3,6,8
# Disable websocket pings
sudo klk_bs_config --enable --ping_interval None
The Loriot Basic Station server does not respond to websocket pings. It is therefore advised to disable this functionality when connecting to such a server.
¶ Connect your gateway to AWS IoT Core LNS
¶ Installation
The Basic station package is not installed by default. The following command allows to install it on your gateway : sudo apt update && sudo apt install basicstation-aws
¶ Configuration
To ease declaration of a gateway on the AWS LNS, use the klk_aws_config tool. This tool creates the gateway on the server and installs the resulting LNS credentials on the gateway.
Please refer to AWS IoT Core documentation to get more details about this LNS.
To use this tool, you need:
- an API user ID
- an API key ID
- an API key secret
- the region of the AWS server the gateway will be declared on
- the LoRaWan region of the gateway
- the Frequency Sub Band(s) to use (required for US915 and AU915)
Use AWS configuration tool
sudo klk_aws_config -u some_user -k ABCDEFGHIJKLMNOPQRST -s ABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMN -r eu-west-1 -l US915 -f 1 -b
sudo klk_bs_config --enable