RAK LoRaWAN
Industrial Gateway
WisDevice Series
RAK7249/RAK7258
Version 1.5 | July, 2019
www.RAKwireless.com
Visit our website for the latest copy of this manual.
31 PAGES
Configuration Guide for
Table of Contents
RAK7249/58
2
RAK LoRaWAN Industrial Gateway Configuration Guide
Table of Contents
1 Overview
2 Gateway Start-up...................................................................................................................................... 3
3 Web Management Platform................................................................................................................... 4
3.1 Status
3.2 Network
3.3 LoRa Gateway................................................................................................................................. 11
3.4 LoRa Network Server
3.5 Services............................................................................................................................................ 25
3.6 System.............................................................................................................................................. 26
3.7 SD card Backup and packet recovery
.....................................................................................................................................................
...................................................................................................................................................
3.1.1 Overview
3.1.2 LoRaWAN Packet Logger.................................................................................................... 5
3.1.3 System Log.............................................................................................................................6
3.1.4 Firewall
...............................................................................................................................................
3.2.1 WAN Interface........................................................................................................................7
3.2.2 Cellular Interface................................................................................................................... 7
3.2.3 Wi-Fi........................................................................................................................................ 8
3.2.4 Firewall....................................................................................................................................8
3.2.5 Diagnostics
3.2.6 Ping Watchdog
3.3.1 LoRa Packet Forwarder..................................................................................................... 11
3.4.1 General
3.4.2 Gateway................................................................................................................................17
3.4.3 Applications.......................................................................................................................... 19
3.4.4 Global Integration................................................................................................................23
3.5.1 System
3.5.2 Administration
3.5.3 Backup / Flash Firmware................................................................................................... 27
3.5.4 Reboot...................................................................................................................................28
3.5.1 File Browser
.................................................................................................................................
....................................................................................................................................
.............................................................................................................................
.......................................................................................................................
......................................................................................................................
.................................................................................................................................
..................................................................................................................................
......................................................................................................................
.........................................................................................................................
..........................................................................................
16
16
26
27
28
29
3
4
4
6
7
9
9
4 Contact Information...............................................................................................................................30
5 Revision History..................................................................................................................................... 31
6 Document Summary
..............................................................................................................................
31
RAK7249/58
3
RAK LoRaWAN Industrial Gateway Configuration Guide
1 Overview
This document describes in detail the functionality of the Web Management UI. The interface
builds on top of OpenWRT and all gateway products of the RAK72xx line share it.
The document gives instructions on configuring WAN, the LoRa Packet Forwarder and Gateway
MQTT Bridge. It explains how to do system-monitoring, update of the firmware and reset the
device. Last, but not least in provides information on using the built-in LoRa Server.
This guide functions as reference for several products with similar functionality. Thus, some
sections will apply to certain products and not others.
2 Gateway Start-up
Make sure all the antennas are connected before powering the Gateway.
For RAK7258 use the included adapter. RAK7249 comes with a PoE injector, which you
need to connect to the grid on one side and to the Gateway on the other (Ethernet cable not
included).
The Gateway comes configured in such a way that you can use either the Ethernet port or
the Wi-Fi in AP mode to connect to the Management platform.
In both modes you can access the Management UI via a web browser pointing to the IP
address of the Gateway (check your router DHCP list). Alternately, the IP Address
(192.168.230.1) is preconfigured as the one to use for access to the device provided you are
directly connected to it.
WiFi AP mode
By default the Gateway is configure to work in Access Point (AP) mode. It has the following
parameters:
Wi-Fi
SSID: RAK72XX_xxxx (no password is required to connect via Wi-Fi)
Web UI
Connect via a browser to the IP address assigned to the gateway, which is 192.168.230.1
by default. You should see the login window in Figure 1. Use the credentials below:
UI user: root
UI password: root
RAK7249/58
4
RAK LoRaWAN Industrial Gateway Configuration Guide
Figure 1 | Login window
WAN port (DHCP IP) mode
Connect the Ethernet cable to the port marked “ETH” and the other end to your Router. Use
the same credentials for the Web UI as for AP mode.
3 Web Management Platform
After you have entered the correct credentials, you can start exploring the configuration and
monitoring interface of the RAK LoRa Gateway.
Status
3.1
This is where statistics about the Gateway behavior can be monitored in real time.
3.1.1 Overview
Upon logging in the browser displays the page in Figure 2.
The following are the parts of the Overview window:
Received:
Shows the total number of uplink LoRa messages received by the gateway.
Transmitted:
Shows the total number of downlink LoRa message sent by the gateway.
RAK7249/58
5
RAK LoRaWAN Industrial Gateway Configuration Guide
Figure 1 | Status Overview page
Active Nodes:
Shows the number of active LoRa nodes within the LoRa gateway coverage (those that
have sent no data for more than 10 min are discarded from the count).
Busy Nodes:
Shows the number of busy nodes within the LoRa gateway coverage (nodes with an
average message spacing of less than 60s).
Duty Cycle of the LoRa Channel
The graph represents the Duty Cycle load by frequency channel (Data is kept for the last 12
hours). The minimum resolution along the time axis is 60s. Each value is an average over
60s. The values are color code – green to red, low to high.
LoRa Traffic:
The graph shows the packet per minute rate as a function of time. Above the image, one
can see the color-coding of the different Spreading Factors, where the actual height of the
values is a sum of all the packets over all spreading factors for the time sample.
Additionally you have sub-windows displaying the System, Memory, LoRa Netowrk Server,
Network (WAN). Cellular, and Wi-Fi information. Those have their separate sections and will
be discussed in detail further down.
LoRaWAN Packet Logger
3.1.2
This is where a log of the LoRa messages is shown in real time. There are several options
for filtering as well as the possibility to download the statistics in a file. Additionally there is a
summary (Total, Uplink, and Downlink), below the filter fields.
RAK7249/58
6
RAK LoRaWAN Industrial Gateway Configuration Guide
Figure 2 | LoRa Packet Logger page
The user can choose to filter the packets by one of the following:
Type:
Filter by message type. By default ALL messages are displayed, where possible options are:
Join Request/Accept, Unconfirmed Data Up/Down, and Confirmed Data Up/Down
DevAddr:
Filter messages based on the Device Address in order to single out a node.
Hide CRC_ERR packet:
This check box hides messages that are corrupted in some way and will not be forwarded.
The buttons for Pause/Play, Clear and Download of the data are in the top right over the list.
If the user clicks on a given packet the window is expanded detailed information about the
contents of the message is displayed
3.1.3 System Log
The complete system log. It is useful mainly for debugging purposes.
3.1.4 Firewall
Statistics for the Gateway Firewall
RAK7249/58
7
RAK LoRaWAN Industrial Gateway Configuration Guide
3.2 Network
3.2.1 WAN Interface
Figure 3 | WAN Interface
The user can check the Status (Uptime, IPv4 Address, etc.), or configure the protocol to be
used for connecting to your provider’s network.
The following options are available: DHCP/PPPoE/Static address.
Cellular Interface
3.2.2
Figure 4 | Cellular Interface
RAK7249/58
8
RAK LoRaWAN Industrial Gateway Configuration Guide
The same statistics as with the WAN Interface are available. It is here that you set
the APN, User, and Password. The gateway metric determines the priority of this interface,
compared with the other connectivity options. The lower the value the higher the priority.
Wi-Fi
3.2.3
Figure 5 | Wi-Fi Interface
Enabling/Disabling the Wi-Fi is done from this page via the blue button at the top.
Additionally you can pick a radio channel or leave it on Auto configuration. The Wi-Fi can
work in one of two modes:
Access Point:
By default, there is no password. One can access the Web UI via the IP address:
192.168.230.1 once connected to the AP. The SSID is RAK72xx_xxxx by default.
Client:
Choose this option to use Wi-Fi as a backhaul for the Gateway. You need to manually enter
the SSID, Encryption method and the Key itself.
Note: Make sure to click the “Switch mode” button first in order to input the corresponding
parameters, before saving and applying the changes.
Firewall
3.2.4
You can configure a number of settings including, but not limited to: Zones, Port Forwarding,
NAT, etc.
RAK7249/58
9
RAK LoRaWAN Industrial Gateway Configuration Guide
Figure 6 | Firewall Settings
3.2.5 Diagnostics
Figure 7 | Diagnostics
This is where you can perform checks via the built-in tools: Ping, Traceroute, Nslookup.
You can enter either an URL or an IP Address in the text box and execute the command
with the button. Both IPv4 and IPv6 are supported. The results are conveniently displayed in
a CLI box.
3.2.6 Ping Watchdog
Ping Watchdog monitors the quality of network links by constantly pinging the specified IP
Address or Domain name on the specified uplink network interface. When network link
failures are detected, scheduled measures are taken automatically. Those include: Interface
restart, Interface priority reduction, Device restart, etc.
Note: Reducing the priority of an uplink interface only works when the LoRa Gateway uses
both Ethernet and Cellular as uplink methods at the same time.
RAK7249/58
10
RAK LoRaWAN Industrial Gateway Configuration Guide
WAN interface represents the Ethernet uplink interface and WWAN represents the LTE
cellular network uplink interface.
For example if Ping Watchdog is enabled for both uplink interfaces at the same time and the
response to degradation of the link quality is set as Increase Gateway Metric the two uplink
interfaces work as backups for each other. In the event of significant degradation on one,
the Gateway switches to the other.
The Gateway Metric determines the priority of interfaces. The default value can be adjusted
in the Network menu for the corresponding interface. The lower the Gateway metric, the
higher the priority of the link.
Figure 8 | Ping Watchdog Interface Configuration
Loading...