This feature allows to create multiple instances of packet forwarder (each on a different LNS).

Only UDP/GWMP packet forwarder instances can be created but they can be used in same time than a Kerlink Basic Station Packet forwarder.

Available since Keros 5.1.

Following features are available in lorafwd_instance_manager tool:

• Add a new instance of lorafwd (add <instance_name>)
• Delete an instance of lorafwd (delete <instance_name>)
• Check if an instance exists (check <instance_name>)
• List all added instances (list)

KerOS firmware contains lorafwd template files located in /etc/lorafwd/templates/. These files must not be deleted or modified.

Each time a lorafwd instance is added, these templates files are copied, modified and suffixed with new lorafwd instance name.

Following commands will create an additional lorafwd instance named “foo” targeting “foo.lns.local” on UDP port 1700:

lorafwd_instance_manager add foo
klk_apps_config -i foo --lns-server foo.lns.local --lns-dport 1700 --lns-uport 1700

It leads to the following created files:

/
|-- etc
|   |-- lorafwd_foo.toml
|   |-- default
|   |   `-- lorafwd_foo
|   |-- init.d
|   |   `-- lorafwd_foo
|   |-- monit.d
|   |   `-- lorafwd_foo
|   |-- rcK.d
|   |   `-- K52lorafwd_foo -> /etc/init.d/lorafwd_foo
|   |-- rcU.d
|   |   `-- S51lorafwd_foo -> /etc/init.d/lorafwd_foo
|   |-- rsyslog.d
|   |   `-- lorafwd_foo
|   `-- sysupgrade.d
|       `-- lorafwd_foo.conf
|-- run
|   `-- lora
|       `-- lorafwd_foo.pid # Created each time it is started
|-- tmp
|   `-- lorafwd_foo_version # Created each time it is started
|-- usr
|   `-- sbin
|       `-- lorafwd_foo -> /usr/sbin/lorafwd
`-- var
    `-- lib
        `-- lorafwd_foo
            `-- database.sqlite # Created at first start

All lorafwd instances write to the same log file /var/log/lora.log, but each lorafwd is suffixed, for example:

2021-05-20T14:17:11.588309+00:00 klk-wifc-03001D lorad[10784]: <6> Sent 1 uplink message
2021-05-20T14:17:11.631126+00:00 klk-wifc-03001D lorafwd_foo[11880]: <6> Heartbeat (F938) sent
2021-05-20T14:17:11.633762+00:00 klk-wifc-03001D lorafwd_foo[11880]: <6> Heartbeat (F938) acknowledged in 2.6289 ms
2021-05-20T14:17:13.446644+00:00 klk-wifc-03001D lorafwd[11552]: <6> Heartbeat (9FC3) sent
2021-05-20T14:17:13.449302+00:00 klk-wifc-03001D lorafwd[11552]: <6> Heartbeat (9FC3) acknowledged in 2.6239 ms
2021-05-20T14:17:14.179913+00:00 klk-wifc-03001D lorafwd[11552]: <6> Received uplink message: 
2021-05-20T14:17:14.180028+00:00 klk-wifc-03001D lorafwd[11552]: <6> | lora uplink (1F70167D), payload 25 B, channel 868.1 MHz, crc ok, bw 125 kHz, sf 7, cr 4/5
2021-05-20T14:17:14.180093+00:00 klk-wifc-03001D lorafwd[11552]: <6> | Unconfirmed Data Up, DevAddr 00430024, FCnt 467, FPort 25
2021-05-20T14:17:14.180139+00:00 klk-wifc-03001D lorafwd[11552]: <6> |  - radio (00000105)
2021-05-20T14:17:14.180233+00:00 klk-wifc-03001D lorafwd[11552]: <6> |   - demodulator counter 3502620444, UTC time 2021-05-20T14:17:14.173866Z, rssi -64 dB, snr 7.5< 10 <12.5 dB
2021-05-20T14:17:14.181910+00:00 klk-wifc-03001D lorafwd[11552]: <6> Uplink message (ABD8) sent
2021-05-20T14:17:14.183471+00:00 klk-wifc-03001D lorafwd_foo[11880]: <6> Received uplink message: 
2021-05-20T14:17:14.183584+00:00 klk-wifc-03001D lorafwd_foo[11880]: <6> | lora uplink (1F70167D), payload 25 B, channel 868.1 MHz, crc ok, bw 125 kHz, sf 7, cr 4/5
2021-05-20T14:17:14.183651+00:00 klk-wifc-03001D lorafwd_foo[11880]: <6> | Unconfirmed Data Up, DevAddr 00430024, FCnt 467, FPort 25
2021-05-20T14:17:14.183695+00:00 klk-wifc-03001D lorafwd_foo[11880]: <6> |  - radio (00000105)
2021-05-20T14:17:14.183786+00:00 klk-wifc-03001D lorafwd_foo[11880]: <6> |   - demodulator counter 3502620444, UTC time 2021-05-20T14:17:14.173866Z, rssi -64 dB, snr 7.5< 10 <12.5 dB
2021-05-20T14:17:14.185793+00:00 klk-wifc-03001D lorafwd[11552]: <6> Uplink message (ABD8) acknowledged in 3.85701 ms
2021-05-20T14:17:14.186798+00:00 klk-wifc-03001D lorafwd_foo[11880]: <6> Uplink message (FB49) sent
2021-05-20T14:17:14.187286+00:00 klk-wifc-03001D lorad[10784]: <6> Sent 1 uplink message
2021-05-20T14:17:14.189619+00:00 klk-wifc-03001D lorafwd_foo[11880]: <6> Uplink message (FB49) acknowledged in 2.80792 ms