Loriot Binary | How to Install LORIOT Binary on UG85 | Ursalink Blog

IMPORTANT: This article is no longer suitable for UG85/UG87 with firmware version 80.0.0.53 and above. Ursalink LoRaWAN gateways now support multi-destination function to work with several LoRaWAN network servers. Please read: Packet Forwarders on Ursalink LoRaWAN Gateway Work with Multiple Network Servers to Provide Secure Data Transmission

—————————————————————————————————————————————–

 

Download PDF: How to Create Loriot Binary on UG85

Before we get started to create Loriot binary on UG85, please make sure the gateway is able to visit the Internet via WAN or cellular network and you are in possession of the following file and credentials.

Requirements

  • Root Access of UG85
  • Gateway’s Password
  • A File named Loriot_ursalink_spi

Ps. You can contact Ursalink Support to acquire that information and follow this guide to complete the installation then.

Note

  • The UG85 should be able to connect to the Internet during the installation process.
  • Please make sure no other process on the gateway accesses the concentrator interface during installation. Otherwise, the Loriot binary would fail to start or only receives a subset of all the packets over the air.
  • Remember to enable SSH in “System > General Settings” and leave port 22 as default.

1. UG85 Configuration

  1.1 Configuration through WAN Connection

Step 1: Change Gateway ID

Log into UG85 Web GUI. Go to “LoRaWAN > Packet Forwarder” and alter “FFFE” in the middle of gateway ID into “FFFF” as follows.

loriot

Step 2: Configure LORIOT

Log in to your LORIOT account. Find “Network” and Click “Add a gateway”.

Step 3: Connect UG85 to LORIOT

Choose UG87 (same as UG85) as base platform and enter the gateway ID into MAC address with losing “FFFF”. In this case, it would be like 24:E1:24:F0:27:8A. Then select gateway location and register. After that, you can see a green light and the gateway is successfully connected.

1.2 Configuring through Cellular Connection

Step 1: Login as Root

Open PuTTY, fill in host name or IP address and port. Login as root.

Step 2: Check Network Interface Configuration

Run command as follows and check network interface configuration. Copy HWaddr address of cellular0.

lortio

Step 3: Fill in Gateway ID

Login UG85 Web GUI. Click “LoRaWAN > Packet Forwarder”. Remove colons from the HWaddr address of cellular0 and add “FFFF” in the middle. In this case, the gateway ID would be like EE26C7FFFF0ED829.

lortio

Step 4: Configure LORIOT

Log in to your LORIOT account. Find “Network” and Click “Add a gateway”.

Step 5: Connect UG85 to LORIOT

Choose UG87 as base platform and fill in MAC address that is equal to the HWaddr address. In this case, it would be like EE:26:C7:0E:D8:29. Then select gateway location and register. After that, you can see a green light and the gateway is successfully connected.

2.General Configuration

Step 1:

After the gateway is successfully connected, you can go to “LoRaWAN > Packet Forwarder” ,disable the packet forwarder mode, and make sure no other process accesses SX1301. Then click “Save & Apply”.

Step 2:

Login as root in WinSCP or use other software to upload “loriot_ursalink_spi” into “/tmp” folder.

ursalink-ug85-configuration

Step 3:

Open PuTTY or use other software to login as root with entering host name or IP address and SSH port. Type in command as below and make sure “loriot_ursalink_spi” was copied to “/tmp”.

loriot

As the packet forwarder has stopped, you can see the gateway is disconnected to LORIOT.

loriot-binary-6

Step 4: Run command “chmod 777 ./loriot_ursalink_spi”

loriot

Step 5: Run binary command “./loriot_ursalink_spi -f -E GE0 -s cn1.loriot.io”

loriot-binary-8

Note

  • If UG85 starts wireless connection over cellular rather than WAN, you can replace “GE0” with HWaddr address. In this case, please run “./loriot_ursalink_spi -f -E cellular0 -s cn1.loriot.io”.
  • The server address “cn1.loriot.io” may be not exactly the same in your case. You can go to Ursaink Web GUI, find the packet forwarder, and copy the server address that you used to connect to LORIOT.

3.Testing

Run LORIOT binary in PuTTY. After you ping it, you can find that the gateway has successfully connected.

binary