User Tools

Site Tools


Kerlink Wiki Home Page



General information

Wirnet™ iBTS information

Wirnet™ iFemtoCell information

Wirnet™ iFemtoCell-evolution information

Wirnet™ iStation information

System management

Network management

LoRa Features

KerOS customization

Support and resources


Frequently Asked Questions

What is default login/password?

The default root password is defined here: Credentials.

What to do in case the password has been lost?

In case the root password of the gateway has been lost, an autorun script can be used on a USB key to reset the password. Refer to the USB autorun section and to the change the passwords section for more information.

If the USB password has also been lost, the product can be restored to factory settings, please refer to How to factory reset the gateway section

Otherwise, please contact the support.

How to read software version?

Firmware version is written in the file /etc/version.

$ cat /etc/version

Firmware version is also displayed on Web Interface:

How to manually update the gateway firmware?

It can be done by IP network or USB. Please refer to Software update dedicated section.

How to factory reset the gateway?

Via physical Button

Please refer to Manual stock restore dedicated section.

Via Web interface

To factory reset the gateway, you can use the stock restore feature. A “stock restore” will factory reset the gateway. All data will be lost.


To trigger a “stock restore” execute the following commands:

# kerosd -s 
# reboot

More information about “stock restore” feature is available here.


Two SMS can be sent to the gateway to factory reset the gateway.

1st SMS to send to the gateway:

[login:password] [sms_command_id] system/restore/stock

2nd SMS to send to the gateway:

[login:password] [sms_command_id] system/reboot

More information about “SMS” feature is available here.

What is the default LEDs behavior?

The LEDs behavior is described here.

How to shutdown/restart the gateway?

Once connected:

  • To stop the gateway, use the command halt.
  • To reboot the gateway, use the command reboot.

Manually, you can also use ON/OFF button (excepting for iFemtocell).

What is the button behavior?

  • On Wirnet iFemtocell, the reset button is a hardware reset button.
  • On Wirnet iZeptoCell, the reset button behaviour is:
    • Reboot: Shortly Press the button (1 second)
    • Halt: Press the button 5 seconds to halt the gateway for 2 minutes. This action is preconized before removing power supply to avoid any risk to alter memory. The gateway is then reset after 2mn (back to normal functioning).
  • On all other products, the button is a ON/OFF button. Similarly to a computer ON/OFF button, this button is intended to perform a reboot, power down and power up of the gateway:
    • Reboot
      • Shortly Press the button (less than 1 second)
    • Power down
      • Press the button between 1 to 5 seconds to halt the gateway
      • Wait for the shutdown of the gateway i.e. until the LEDs are switched off.
      • The shutdown may take up to 30 seconds depending on the current software activity.
    • Hard Power-down
      • Press the button more than 5 seconds.
    • Power on
      • Press the button during 1 second to power the gateway on.

Where are the logs?

Most traces of the Wirnet™ i-series gateways can be found under /var/log/messages*.

Is an SDK available?

Kerlink doesn’t provide an SDK to generate KerOs firmwares, just what is necessary to build an application. Information about the Toolchain is available in the toolchain page.

How to install additional python modules?

Pip3 python package manager is available on KerOS 5.
This tool is not available on previous KerOS version. Modules without C binding can be added with the command pip3 install <module>.

root@klk-wifc-0609C9:~ # pip3 install serial

click here to see execution traces

click here to see execution traces


root@klk-wifc-0609C9:~ # pip3 install serial
Collecting serial
  Downloading serial-0.0.97-py2.py3-none-any.whl (40 kB)
     |████████████████████████████████| 40 kB 899 kB/s
Collecting future>=0.17.1
  Downloading future-0.18.3.tar.gz (840 kB)
     |████████████████████████████████| 840 kB 2.5 MB/s
Collecting pyyaml>=3.13
  Downloading PyYAML-6.0.1.tar.gz (125 kB)
     |████████████████████████████████| 125 kB 3.2 MB/s
  Installing build dependencies ... done
  Getting requirements to build wheel ... done
    Preparing wheel metadata ... done
Collecting iso8601>=0.1.12
  Downloading iso8601-2.0.0-py3-none-any.whl (7.5 kB)
Building wheels for collected packages: pyyaml
  Building wheel for pyyaml (PEP 517) ... done
  Created wheel for pyyaml: filename=PyYAML-6.0.1-cp38-cp38-linux_armv7l.whl size=45360 sha256=a9575dd7de27bf328ba068c705a2bdd402d1f3f211a840cad6538317365430f0
  Stored in directory: /home/root/.cache/pip/wheels/77/54/77/68b3079bd1d88cb070513c3935d9f7e32c70ad69368375308d
Successfully built pyyaml
Installing collected packages: future, pyyaml, iso8601, serial
    Running install for future ... done
Successfully installed future-0.18.3 iso8601-2.0.0 pyyaml-6.0.1 serial-0.0.97

  • Wirnet™ iBTS FAQ

What is default Wirnet iBTS hostname?

The default hostname of the Wirnet iBTS is “klk-lpbs-04014F” where 04014F is the end of the CPU serial number. This information is present on the sticker placed on the CPU module.

How to configure DIVERSITY on iBTS?

It's possible to install a second LoRa antenna on iBTS.

It's very important to take care of distance between antennas.

  • For Packet Forwarder configuration, you can consult iBTS Dual antenna configuration section (hidden menu), in chapter 1.1 lorad configuration: Keros 4.3.3: CPF configuration

How to read FPGA version?

FPGA versions are contained in /tmp/board_info.json file: parameter fpga_swver.
There is one FPGA per LoRaLOC board. If you have 3 LoRaLOC, there will be 3 versions in the file.

Example: On this gateway, FPGA version is v61.

# grep "fpga_swver" /tmp/board_info.json   
"fpga_swver": "61",
"fpga_swver": "61",
"fpga_swver": "61",

  • Wirnet™ iFemtoCell FAQ

What is default Wirnet iFemtoCell hostname?

The default hostname of the Wirnet iFemtoCell is “klk-wifc-020010” where 020010 is the end of the board ID. This information is present on the sticker placed on the rear side of the case.

  • Wirnet™ iStation FAQ

What is default Wirnet iStation hostname?

The default hostname of the Wirnet iStation is “klk-wiis-020011” where 020011 is the end of the board ID. This information is present on a sticker placed on the right view of the case.

What is default Wirnet iZeptoCell hostname?

The default hostname of the Wirnet iZeptoCell Ethernet is “klk-zeth-020011” where 020011 is the end of the gateway EUI.

wiki/support/faq.txt · Last modified: 2024/03/28 11:53 by ehe