Kerlink Wirnet Station

    Updated Edit on GitHub
    Copy page

    Warning:

    Kerlink announced the Product End of Life in January 2020 for Wirnet Station, so using Kerlink Wirnet iStation is highly recommended.
    Kerlink Wirnet Station

    The Kerlink Wirnet Station is a robust and highly reliable outdoor LoRaWAN gateway. It was the first commercially available LoRaWAN® gateway on the global market. It offers Ethernet and cellular (3G/2G) backhauls.

    This page guides you to connect Kerlink Wirnet Station to The Things Stack.

    Prerequisites

    1. User account on The Things Stack with rights to create Gateways.
    2. Kerlink Wirnet Station gateway connected to the Internet via Ethernet or cellular network.

    Note:

    Wirnet Station should be running firmware v3.0 or higher.

    Registration

    Create a gateway by following the instructions for Adding Gateways. Choose a Gateway ID, and fill in the Gateway EUI field with value 7276FF0000XXXXXXX. XXXXXXX represents the last 7 characters of the gateway’s serial number For example, the Gateway EUI could be 7276ff00080E0000.

    Create an API Key with View gateway information rights for this gateway using the same instructions. Copy the API key and save it for later use.

    Configuration

    All further steps assume the gateway is available at <gateway-ip>, The Things Stack is available at <server-address>, gateway ID is <gateway-id> and gateway API key is <gateway-api-key>. For Wirnet Station, the <gateway-model> has value 'wirnet-station'. Make sure to replace these with the values appropriate for your setup.

    Provisioning

    In order to ease the process of connecting Wirnet Station to The Things Stack, we provide the provisioning script provision.sh you can configure your gateway with. This script is compatible with Wirnet Station gateways running firmware v3.0 and above.

    In case the CPF (Common Packet Forwarder) is not installed on the Wirnet Station, this script will try to install it. If the gateway is running an outdated firmware version, the script will attempt to update the firmware first and install the CPF after.

    To provision the Wirnet Station gateway at <gateway-ip> to use the configuration of <gateway-id> provided by The Things Stack deployed at <server-address>, execute:

    curl -sL 'https://raw.githubusercontent.com/TheThingsNetwork/kerlink-wirnet-firmware/v0.0.3/provision.sh' | bash -s -- <gateway-model> <gateway-ip> <server-address> <gateway-id> <gateway-api-key>

    To avoid being prompted for root user password several times, you may add your SSH public key as authorized for root user on the gateway, for example, by ssh-copy-id root@192.168.4.155.

    Please refer to Kerlink Wirnet Firmware provisioning documentation for more detailed information on provisioning the Wirnet Station.

    Troubleshooting

    CPF logs are located at /mnt/fsuser-1/lora/var/log/lora.log. You can access them by e.g.:

    ssh root@192.168.4.155 'tail -f /mnt/fsuser-1/lora/var/log/lora.log'