Wirnet™ i-series

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Keros application configuration ======

Starting from version 4.3, KerOS firmware is delivered with Kerlink Common Packet Forwarder and WMC Embedded applications. These applications are disabled by default.

===== klk_apps_config =====

klk_apps_config is a script used to configure Kerlink Common Packet Forwarder and WMC Embedded applications. \\
Kerlink advises to reboot the gateway after using klk_apps_config to enable/disable an application.

<code>
root@klk-lpbs-04038E:~ # klk_apps_config -h
klk_apps_config [options]

options:
-h, --help               show help
--activate-wmc           activate wmc embedded (and CPF)
--deactivate-wmc         deactivate wmc embedded (and CPF)
--activate-cpf           activate lorad and lorafwd
--deactivate-cpf         deactivate lorad and lorafwd
--activate-lorad         activate lorad
--deactivate-lorad       deactivate lorad
--activate-lorafwd       activate lorafwd
--deactivate-lorafwd     deactivate lorafwd
-i, --lorafwd-instance   lorafwd instance name (system lorafwd by default)
-s, --wmc-server         WMC server (mandatory if activating WMC)
-p, --wmc-port           WMC port (default 1194)
--lns-server             LNS server (default 172.17.0.1)
--lns-dport              LNS downlink port (default 1700)
--lns-uport              LNS uplink port (default 1700)
--loradconf              lorad configuration file name/path
             Can be:
                    - a complete file path
                    - an example file name (ex:AS923-JP.json)
</code>

This script can be used to:
  * activate CPF (lorad and lorafwd)
  * deactivate CPF
  * activate lorad
  * deactivate lorad
  * activate lorafwd
  * deactivate lorafwd
  * activate WMC embedded applications (CPF + BSCC + lora_snmp)
  * deactivate WMC embedded applications

It can also be used to switch to another WMC server while WMC embedded is already activated (use --activate-wmc action with another server parameter while WMC Embedded is already activated).
 

Script parameters details:
  * One of the eight possible actions must be chosen (ex: activate-cpf) 
  * ''-////-wmc-server'': address of the WMC server to connect to (example: wmcvalidinstall.wanesy.com)
  * ''-////-wmc-port'': port of the WMC server to connect to
  * ''-////-lorafwd-instance'': lorafwd instance name (system lorafwd by default)
  * ''-////-lns-server'': address of the LNS server (lorafwd parameter)
  * ''-////-lns-dport'': LNS downlink port (lorafwd parameter)
  * ''-////-lns-uport'': LNS uplink port (lorafwd parameter)
  * ''-////-loradconf'': this can be the complete path of the Lorad configuration you want to use or the file name of the example lorad configuration delivered for your platform. If not given the platform default will be used (EU868XXX.json)


<note important>Please note that to use WMC Embedded application, you still have to install the required security certificate; 
[[https://wikikerlink.fr/wanesy-ran/doku.php?id=wiki:wiki3:quickstart|WMC quickstart]]
</note>

===== lorafwd_instance_manager =====

lorafwd_instance_manager is a script used to manage the CPF daemon lorafwd instances. The tool allows using several instances of lorafwd simultaneously.

This script can be used to:
  * Add a lorafwd instance
  * Delete a lorafwd instance
  * Check if an instance exists
  * List the additional lorafwd instances

By default there is no additional instance. Only one instance, called ''lorafwd'', is used.


<code>
Usage: lorafwd_instance_manager <command> [<args>]

Commands:
    add instance_name
        Add lorafwd instance with
    delete instance_name
        Delete additional lorafwd instance
    check instance_name
        Check if additional lorafwd instance exists
    list
        List lorafwd instances
</code>

===== Connect a Wirnet i-series gateway to The Things Network =====

Activation of the CPF on European TTN server: 
<code>
klk_apps_config --activate-cpf --lns-server eu1.cloud.thethings.network --lns-dport 1700 --lns-uport 1700
</code>

Deactivation:
<code>
klk_apps_config --deactivate-cpf
</code>

If you need to activate the WMC on your gateway, consult the WMC wiki page: [[https://wikikerlink.fr/wanesy-ran/doku.php?id=wiki:wiki3:gateway_sw_4.3.3|click here]].

Kerlink also recommends to consult the TTN page: [[https://www.thethingsindustries.com/docs/getting-started/ttn/addresses/|click here]].
===== Connect a Wirnet i-series gateway to ChirpStack =====

Download ChirpStack gateway bridge ipk file: chirpstack-gateway-bridge_3.13.1-r1_klkgw.ipk
[[https://artifacts.chirpstack.io/vendor/kerlink/keros-gws/|click here]].

Then open the Web interface of your gateway and add the ChirpStack bridge by drag & dropping it in the Administration Update menu.


Connect over SSH and activate the CPF on ChirpStack server.
<code>
klk_apps_config --activate-cpf --lns-server 127.0.0.1 --lns-dport 1700 --lns-uport 1700
</code>

In /etc/chirpstack-gateway-bridge/chirpstack-gateway-bridge.toml , add ChirpStack IP server 
<code>
# Generic MQTT authentication.
[integration.mqtt.auth.generic]
# MQTT server (e.g. scheme://host:port where scheme is tcp, ssl or ws)
server="tcp://127.0.0.1:1883"
</code>

Replace 127.0.0.1 with the address of your server

Restart chirpstak bridge
<code>
monit restart chirpstack-gateway-bridge
</code>
Wirnet™ i-series

User Tools

Site Tools

Page Tools
