Contents
LORIOT Gateway Software download
For general setup instructions, see the Basic Setup page.
LORIOT Gateway self-extracting installer
Once connected to the gateway with an SSH console run the following commands:
cd /tmp
wget https://example.loriot.io/home/gwsw/loriot-cisco-ir910-cisco1257-USB-0-latest.sh -O loriot-install.sh
chmod +x loriot-install.sh
./loriot-install.sh -f
LORIOT Gateway binary only
Once connected to the gateway with an SSH console run the following commands:
cd /tmp
wget https://example.loriot.io/home/gwsw/loriot-cisco-ir910-cisco1257-USB-0-latest.bin -O loriot-gw
chmod +x loriot-gw
./loriot-gw -f
Please remember to replace "example.loriot.io" with the URL of the server where the gateway is registered (eu1/us1/eu4pro etc.).
Configuration
The IR910 typically does not have an eth0 interface. Our binary will pick up the first active interface with a MAC address. This can be for example br0 or ge1. Please register the gateway with the ge1 MAC address by default. You can later re-register the gateway if you see that it is picking up MAC of another interface or you can force the interface by running the gateway with -E [INTERFACE]
parameter, e.g. -E ge1
is set by default.
Installation only
You need to have download LORIOT software on the Cisco to perform the following steps.
Once downloaded run the installer to install on /opt folder. ./loriot-install.sh -n
Please make sure that no other process (such as *pkt_fwd) is accessing the SX1301, otherwise the binary might fail to start or will only receive a subset of all the packets on the air.
Make sure the time on the gateway is set up correctly (use date
or ntpdate
or ntpd
).
Go to the /opt/lrt directory cd/opt/lrt
Run the loriot_cisco_usb binary ./loriot_cisco_usb -f -E ge1
Upon a successful startup, all log are printed on the screen. To stop the binary ctrl + c
Install and run at startup
You need to have download LORIOT software on the Cisco to perform the following steps:
Make sure that no other process accessing the SX1301 (such as *pkt_fwd) is executed upon startup.
Make sure the time on the gateway is set up correctly (use date
or ntpdate
or ntpd
).
Once downloaded run the installer to install on /opt folder ./loriot-install.sh
The binary will be started, and will automatically start after next reboot. You can delete the installer afterwards
You can use the uninstall.sh
script from the install folder to completely remove the LORIOT gateway software.
You can use the parameters specified in Basic Gateway Setup.
Runtime notes
The gateway binary is designed to be completely self contained, and not to modify your gateway image / environment.
It doesn't write any files, and after a successful start, the gateway process will demonize and run in background.
A LORIOT log file should be present on the /tmp folder