# LORIX One - Legacy Image

This is the instructions for the legacy version of the LORIX One firmware. We strongly recommend that you upgrade to LORIX OS.

Read more on the LORIX One product page (opens new window).

# Background

The LORIX One is a LoRaWan Gateway. It listens for LoRa radio traffic and forwards it to a LoRa Server. It works very well with the IoT Open LoRaWan integration.

This is a quick installation guide. The full documentation can be found here (opens new window).

# Prerequisites

A LORIX One gateway from IoT Open or partner
A computer connected to the same network as the gateway
An SSH client (Windows users might use PuTTY)
Some very basic knowledge on Linux/UNIX command line

# Connect the gateway

Please see the instructions that came with the gateway. Do not power up the gateway without antenna. Use the 24 VDC PoE injector included in the package, NOT a standard IEEE 802.3af PoE supply.

# Access the gateway

The gateway comes configured with a static IP 192.168.1.50, make sure you have a computer on the same network in order to access it. Verify with ping that you can reach it.

$ ping 192.168.1.50
PING 192.168.1.50 (192.168.1.50) 56(84) bytes of data.
64 bytes from 192.168.1.50: icmp_seq=1 ttl=64 time=0.578 ms
64 bytes from 192.168.1.50: icmp_seq=2 ttl=64 time=0.286 ms
64 bytes from 192.168.1.50: icmp_seq=3 ttl=64 time=0.319 ms
--- 192.168.1.50 ping statistics ---
3 packets transmitted, 3 received, 0% packet loss, time 2048ms
rtt min/avg/max/mdev = 0.286/0.394/0.578/0.130 ms

Username: admin
Password: lorix4u

$ ssh admin@192.168.1.50
The authenticity of host '192.168.1.50 (192.168.1.50)' can't be established.
ECDSA key fingerprint is SHA256:aC0IR9SEVSbBYih0PBrH1OTLskVHMsr4DJ7caVWxwNE.
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
Warning: Permanently added '192.168.1.50' (ECDSA) to the list of known hosts.
admin@192.168.1.50's password: 
  _      ____  _____  _______   __   ____
 | |    / __ \|  __ \|_   _\ \ / /  / __ \
 | |   | |  | | |__) | | |  \ V /  | |  | |_ __   ___
 | |   | |  | |  _  /  | |   > <   | |  | | '_ \ / _ \
 | |___| |__| | | \ \ _| |_ / . \  | |__| | | | |  __/
 |______\____/|_|  \_\_____/_/ \_\  \____/|_| |_|\___|
-------------------------------------------------------
 LoRa gateway     www.lorixone.io
 Wiki             www.lorixone.io/wiki
  Quick start     www.lorixone.io/wiki/quickstart
  Troubleshooting www.lorixone.io/wiki/troubleshooting
  Changelog       www.lorixone.io/wiki/changelog
  Versions        www.lorixone.io/wiki/versions
-------------------------------------------------------

sama5d4-lorix-one-512:~$

# Configuration of gateway

# Change the password

Please change the default password. Don't lose the one you choose.

admin@sama5d4-lorix-one:~$ passwd
Changing password for admin
Old password:
Enter the new password (minimum of 5 characters)
Please use a combination of upper and lower case letters and numbers.
New password:
Re-enter new password:
passwd: password changed.
admin@sama5d4-lorix-one:~$

# Network connection

The network configuration is in the file /etc/network/interfaces. Change it to suit your needs.

Example using static IP.

# /etc/network/interfaces -- configuration file for ifup(8), ifdown(8)

# The loopback interface
auto lo
iface lo inet loopback

# Main wired interface
auto eth0
iface eth0 inet static
    address 192.168.1.50
    netmask 255.255.255.0
    gateway 192.168.1.1
    dns-nameservers 192.168.1.1

Example using DHCP

# /etc/network/interfaces -- configuration file for ifup(8), ifdown(8)

# The loopback interface
auto lo
iface lo inet loopback

# Main wired interface
auto eth0
iface eth0 inet dhcp

After this reboot your gateway and after a short while you should be able to access the gateway on you new ip-address with your new password.

sudo reboot; exit

# LoRa Package forwarder

Start by stopping the default configuration:

sama5d4-lorix-one-512:~$ sudo /etc/init.d/clouds-manager.sh stop     
Stopping cloud loriot... done.

Edit the package forwarder config file

sama5d4-lorix-one-512:~$ sudo vi /opt/lorix/clouds/packet-forwarder/local_conf.json

Do not change the gateway_ID but make a note of it since it will be needed later.

Add lines for server_address, serv_port_up and serv_port_down. The settings for the IoT Open standard LoRaWan server is provided here, but they may be different if you have an on-premise installation of the LoRaWan server.

It should look like this:

{
/* Settings defined in global_conf will be overwritten by those in local_conf */
    "gateway_conf": {
        "gateway_ID": "XXXXXXXXXXXXXXXX",
        "server_address": "lorawan.iotopen.se",
        "serv_port_up": 1700,  
        "serv_port_down": 1700 
    }
}

Please note that it needs to be well formatted json. Don't forget to add a comma after the gateway_ID. Then configure the gateway to use the packet forwarder.

sama5d4-lorix-one-512:~$ sudo /etc/init.d/clouds-manager.sh configure
==========================================
| LORIX One clouds manager configuration |
==========================================

Actual configuration:
  autostart=true
      cloud=loriot

Do you want to enable autostart at boot time?
[Yes|No]
 > Yes

Which cloud app. do you want to use ?
[loriot|packet-forwarder|ttn|manual]
 > packet-forwarder

New configuration:
  autostart=true
      cloud=packet-forwarder

sama5d4-lorix-one-512:~$

Finally, start the packet forwarder,

sama5d4-lorix-one-512:~$ sudo /etc/init.d/clouds-manager.sh start
Starting cloud packet-forwarder... done.
sama5d4-lorix-one-512:~$

And you are good to go.

# What next

To be accepted the gateway must be added in the LoRaWan server. Do this yourself or contact your IoT Open representative. Now you need the gateway_ID you did make a note of earlier.

← LORIX One - LORIX OS Mielesight LoRa gateway with Semtech Packet Forwarder →