IMPORTANT: This article is no longer suitable for UG85/UG87 with firmware version 80.0.0.53 and above. Milesight LoRaWAN gateways now support multi-destination function to work with several LoRaWAN network servers. Please read: How to connect Milesight Gateway to Loriot 


Before we get started to create Loriot binary on UG85/87, 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 Milesight 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. 


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.


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.


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.


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”.

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

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


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


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.