WisGateOS2 User Manual
WisGateOS2 2.2 comes with significant updates that affect all extensions, downgrade flow, and others. Read the following critical points carefully:
- Downgrading Restrictions: Once you upgrade to WisGateOS2 2.2.x, you will not be able to revert to version 2.1.x using the standard downgrade (WebUI). Make sure to back up and secure all critical data before proceeding with the upgrade. Only through a recovery procedure will a downgrade be possible. The steps for the recovery procedure can be found here: OpenWRT Recovery Procedure.
- Extension Signature Requirement: All extensions for WisGateOS2 2.2.x will now require a signature for increased security and compatibility. Extensions that lack this signature (such as those for WisGateOS2 2.0.x/2.1.x) will not be installable on 2.2.x. This ensures that you are running the new firmware with verified and trusted extensions. On WisGateOS2 2.2.x, the Extension Gallery will automatically update installed Extensions. Some extensions, such as WireGuard, require manual installation after upgrading to WisGateOS2 2.2.x.
- Internet Connection: Because the new firmware and Extension gallery require a signature check, an Internet connection is required during the update.
- Dual Firmware: Some customers may still be using firmware version 2.1.x. Both versions will be supported, but it is critical to use the correct and corresponding extensions for each version to avoid compatibility issues. We strongly recommend upgrading to the new WisGateOS2 2.2.x version to be able to use the latest features, security, and services.
The following table lists the WisGate Edge Gateway models supported by different versions of WisGateOS:
WisGateOS1 1.x | WisGateOS2 2.x |
---|---|
WisGate Edge Lite (RAK7258 / RAK7258C) | WisGate Edge Lite 2 V2 (RAK7268V2 / RAK7268CV2) |
WisGate Edge Lite 2 (RAK7268 / RAK7268C) | WisGate Edge Pro V2 (RAK7289V2 / RAK7289CV2) |
WisGate Edge Pro (RAK7289 / RAK7289C) | WisGate Edge Prime V2 (RAK7240V2 / RAK7240CV2) |
WisGate Edge Prime (RAK7240 / RAK7240C) | WisGate Edge Ultra (RAK7285 / RAK7285C) |
WisGate Soho Pro (RAK7267) |
The hardware in V1 and V2 gateways are different. WisGateOS2 can be used only with V2 gateways.
Feature | WisGateOS1 1.x | WisGateOS2 2.x |
---|---|---|
UDP PF | ✔ | ✔ |
Basics Station | ✔ | ✔ |
Built-in LNS | ✔ | ✔ |
MQTT integrations | ✔ | ✔ |
HTTP integrations | ✔ | ✔ |
MultiWAN | ✔ | ✔ |
WisDM integration | ✔ | ✔ |
Latest OpenWrt security | X | ✔ |
Secure activation from WisDM | X | ✔ |
OpenSSL1.1 | X | ✔ |
OpenVPN | X | ✔ |
WireGuard | X | ✔ |
Extensions | X | ✔ |
LBT | X | ✔ |
LBT is available for certain gateway models since they are related to a specific hardware functionality.
Overview
This document describes the functionality of the WisGateOS2 in detail. The system builds on top of OpenWrt and runs on all RAK WisGate Edge V2 gateways. The guide presents general overview and provides guides and detailed configuration of the gateway. It functions as reference for several products with similar functionality. Thus, some sections will apply to certain products and not others.
Gateway Start-up
For information on the installation and power-up of the gateway, check the Quick Start Guide of the respective device.
Access the WisGateOS2 Web UI
In this section, two ways of accessing the gateway are provided to have different alternatives for you to choose from depending on the availability of the requirements needed.
Wi-Fi AP Mode
By default, the gateway will work in Wi-Fi AP Mode, which means that you can find an SSID named RAK72XXXX_YYYY on your PC's Wi-Fi Network List. RAK72XXXX is the model of the gateway, and YYYY is the last two bytes of the gateway's MAC address. For example, RAK7268CV2_8F61.
- Connect to the gateway's Wi-Fi. No password is required to connect via Wi-Fi.
- To access the Web UI, input the IP Address: 192.168.230.1 in your Web browser.
- For security reasons, upon first login, you must set the login password. This is done by filling in the desired password and confirming it in the provided fields. The password needs to comply with the following rules:
- Should be at least 12 characters long.
- Has at least one special character (
!“#$%&\‘()*+,-./:;<=>?@[\]^_{|}~
). - Has at least one number.
- Has at least one standard Latin letter (used in the English alphabet).
- When the fields are filled in, click the Set password button to apply it. The Web UI is now accessible and it will load the LoRaWAN Statistics page.
- On the next login, use the set password for access. The default login username is root.
WAN Port (Ethernet)
Only gateways with an ETH(PoE) can be accessed through the WAN port.
- Connect the Ethernet cable to the gateway port marked ETH(PoE) and the other end to your PC.
- The default IP is 169.254.X.X. The last two segments (X.X) are mapped from the last four bits of the MAC address of your gateway. For example, the last four bits of the MAC address are 0F:01, and the IP address is
169.254.15.1
. Make sure to manually set the address of your PC to one in the same network (for example,169.254.15.100
). - To do this, open the head to the Ethernet Properties and click the Internet Protocol Version 4 (TCP/IPv4).
- Select Use the following IP address and set the IP address (for this example to
169.254.15.100
).
-
To access the Web UI, input the IP Address: 169.254.15.1 in your Web browser.
-
For security reasons, upon first login, you must set the login password. This is done by filling in the desired password and confirming it in the provided fields. The password needs to comply with the following rules:
- Should be at least 12 characters long.
- Has at least one special character (
!“#$%&\‘()*+,-./:;<=>?@[\]^_{|}~
). - Has at least one number.
- Has at least one standard Latin letter (used in the English alphabet).
-
When the fields are filled in, click the Set password button to apply it. The Web UI is now accessible and it will load the LoRaWAN Statistics page.
-
On the next login, use the set password for access. The default login username is root.
Web Management Platform
After logging in to the gateway using your credentials, start exploring the configuration and monitoring interface of the device starting with the LoRaWAN Statistics page that opens automatically.
- In WisGateOS2, only icons are visible for aesthetics reasons, hiding the menu names.
- You can click the WisGate logo () to expand the menu on the left and see the full names of the tabs. Click anywhere else on the page to hide the menu names again.
Dashboard
This is where statistics about the gateway behavior can be monitored in real time.
LoRa Statistics
The page consists of several blocks where you can see the overview of some metrics and basic information about the traffic of messages.
- Packets: Shows the total number of received and transmitted packets by the gateway (uplinks and downlinks). Here are displayed not only messages from devices connected to the gateway directly but from any device that is within the coverage of the gateway and transmitting LoRa messages.
- End devices: Shows the number of end devices within the gateway's coverage that sent data:
- Active: The number of the end devices that have sent data in the past hour.
- Busy: The number of the end devices that have sent an average of 1 uplink packet every minute in the past 10 minutes.
- Channel Usage: Shows the frequency channel load. Тhe green color indicates low load and the red color indicates high load. To show the channel usage in the graph in a specific time span and range, you may set the Timespan and Range from the dropdown menu.
- SNR & RSSI: These graphs show the total number of packets with RSSI/SNR value within a specific range. This is also shown in a pie chart to the side of the graphs.
- Uplink Traffic: Shows the packet-per-minute rate as a function of time and airtime (sec) per minute. Above the graphs, you can see the color-coding of the different Data Rates, where the actual height of the values is a sum of all the packets overall data rates for the time sample. To show the the uplink traffic in a specific time span, you may set the Timespan from the dropdown menu.
- Downlink Traffic: Shows the packet-per-minute rate as a function of time and airtime (sec) per minute. Above the graphs, you can see the color-coding of the different Data Rates, where the actual height of the values is a sum of all the packets overall data rates for the time sample. To show the the downlink traffic in a specific time span, you may set the Timespan from the dropdown menu.
Overview
The page consists of several blocks where you can see information about the gateway model, firmware, WAN and LAN interfaces. In addition, you can monitor the performance of the gateway or its packet traffic.
-
In the first block, you can visualize the general information about the gateway:
- MODEL: The model of the gateway.
- SERIAL NUMBER: Тhe serial number of the gateway.
- EUI: Тhe Extended Unique Identifier of the gateway. It is used to register the gateway in LoRaWAN Network servers.
- REPORTED COORDINATES: Coordinates of the gateway.
- MAC ADDRESS: The Media Access Control address of the gateway.
- FREQUENCY BAND: The frequency band set on the gateway.
- NUMBER OF CHANNELS: The number of the channels of the gateway (8-channel/16-channel).
- UPTIME: The time the gateway has been working for.
- LOCAL TIME: The local time set to the gateway.
- FIRMWARE: The details about the firmware version. The Firmware details button will redirect you to the Settings > Firmware. Firmware details will be explained in the Firmware section of this document.
-
Packet capture: This is the feature that records data packets transmitted in the network. By clicking the arrow (), you will be redirected to the Gateway Packet Capture menu.
Figure 1: Gateway Packet Capture page-
Pause/Restart session: Тhe button pauses or restarts the session.
- Download session: Тhe button downloads a
.json
file with packets data in it. - Filter: The button drops-down a filter menu.
- Type: Тype of the packet.
- Frequency: The frequency on which the packet is received/sent.
- RSSI: Range of the RSSI.
- SNR: Range of the SNR.
- Device address: In the Search Device address field, manually type a device address and the packets sent by that devices will be filtered.
- Hide CRC_ERR Packets: When enabled, the filter will hide all packets with CRC Error.
- Reset filter: Reset the filter to default.
-
-
Performance: This block shows the CPU load and memory used by the gateway in real time.
-
WAN Interfaces: Shows the available and active interfaces. Clicking the arrow (), will redirect you to the Network > WAN menu that is explained in detail further down this document.
-
LAN Interfaces: Shows the available and LAN interfaces and the active one. Clicking the arrow (), will redirect you to the Network > LAN menu that is explained in detail further down this document.
LoRa®
Configuration
In the Configuration tab, configure the working mode of the gateway. In the Work mode setting, set the mode to Packet forwarder, Basics station or Built-in network server.
Depending on the chosen mode, the other available settings and tabs change. By default, the gateway is configured to work in Built-in network server.
Packet Forwarder Mode Settings
When you choose Packet forwarder work mode, the settings will change to the corresponding ones for this mode. Set a packet forwarder and point to a chosen third-party LoRaWAN Network Server.
- Log Level: Set the log level.
- Error: Shows only error logs
- Warning: Shows warnings logs
- Notice: Shows notice logs
- Info: Shows all notice, error, and warning logs
- Debug: This is full log, it shows all types of logs, it is used for debugging.
-
Frequency Plan: Here, you can select your country and change the frequency plan of the gateway.
-
Select your country: (Optional) Selecting the correct country will assure you are operating under the local law requirements. The transmit power of your gateway will be set to the local regulation maximum and the LBT feature will be turned on if required.
Figure 1: Select your country -
Regin: Set the Region here. You can switch the frequency plan in the following regions:
- US915, AS923, KR920, AS923
- EU868, RU864, IN865
- EU433
- CN470
NOTE- If you have already selected a frequency band in Select your country, it cannot be set here again.
- Different hardware supports different LoRaWAN regions.
- If your Region is set to AS923, you need to configure the Variation option, such as AS923-1/AS923-2/AS923-3/AS923-4.
-
Click on View detailed regional parameters of the frequency plan to expand the options.
-
Conform to LoRaWAN: When enabled (by default), the gateway will comply to the LoRaWAN protocol. You may disable it and set their own channels.
When Conform to LoRaWAN is disabled, you can either Choose a template or manually Edit the LoRa channels for each concentrator.
Figure 1: Confirm to LoRaWAN is disabledChoose a template: You have a list of templates for frequency plans to choose from depending on the LoRaWAN region that the gateway supports.
Edit: Clicking the button will redirect you to the LoRa Concentrator settings, where custom channels can be set.
Figure 1: LoRa Concentrator settings- Radio 0 Center Frequency (Mhz): The center frequency for radio 0.
- Radio 1 Center Frequency (Mhz): The center frequency for radio 1.
- Minimum TX frequency (Mhz): The minimum frequency for transmission.
- Maximum TX frequency (Mhz): The maximum TX frequency for transmission.
- Channels: Enable/disable channels with the corresponding switch. In the Radio field, select which radio the channel must use. In the IF field, the difference of the frequency of the selected radio center frequency in kHz is written.
-
LoRaWAN Public: When enabled (by default), the gateway will process data from all end devices. If you want to create a private network, you can to turn it off. The gateway will process the data only from the end devices, which sync word is changed to private.
For different frequency bands, there are differences in the frequency sub-bands section.
NOTEIf you disable Conform to LoRaWAN for configuring the LoRa concentrator, the frequency sub-bands section will not be displayed.
For gateways that support the EU433, RU864, IN865, EU868, KR920, and AS923 LoRaWAN regions, the frequency sub-bands section is as follows.
Figure 1: Frequency plan settings for different LoRaWAN regions- Multi-SF LoRa Channel Frequency (MHz): Set the frequency for the Multi-SF LoRa channel. It can be removed by clicking on the X next to it. When adding a new frequency, enter the frequency in the text box and click Add.
- Standard LoRa Channel Frequency (MHz): Set the frequency for the standard LoRa channel.
- FSK Channel Frequency (MHz): Set the frequency for the FSK channel.
For gateways that support the CN470, US915, and AU915 LoRaWAN regions, the frequency sub-bands section is as follows. From the dropdown menu, choose sub-bands to use for the uplink traffic.
Figure 1: Frequency plan settings for different LoRaWAN regions -
-
-
Protocol: Click on Choose from the available protocols and expand the options.
- Protocol
- Semtech UDP GWMP Protocol: Choosing this option allows you the ability to set UDP Protocol Parameters.
- LoRa Gateway MQTT Bridge: Choosing this option allows you to set LoRa Gateway MQTT Bridge Parameters.
- Static Interval (s): The time interval of how often statistics are pushed to the server.
- Protocol
-
UDP Protocol Parameters
Figure 1: UDP Protocol Parameters- Server address: The address of the LoRa Network Server (LNS).
- Server port up/down: The ports of the LoRa Server that are going to be used for inbound and outbound traffic.
- Push timeout (ms): The time delay for the server response after sending uplink data.
- Keepalive interval (s): The interval of which the gateway sends data to make sure that the server is aware that the gateway is online.
- Automatic Data Recovery: A feature that allows LoRa frames to be stored on the SD card (provided there is one in the slot). If the gateway loses connection to the LoRa Network Server, upon restoring the connection, the buffered messages will be forwarded, so no data is lost. This is done in blocks of 8 (FIFO) until all are cleared from the buffer.
- DGRAM MTU: The size of the maximum transmission unit. Default is 1400.
- Auto-restart threshold: This variable defines how many times the Keepalive Interval can expire before the Packet Forwarder restarts.
-
LoRa Gateway MQTT Bridge: Choosing this option allows you to set LoRa Gateway MQTT Bridge Parameters.
Figure 1: LoRa Gateway MQTT Bridge Parameters- MQTT Protocol: From the dropdown menu, choose the MQTT protocol of the MQTT bridge. Note that the MQTT topics change depending on the chosen protocol.
- MQTT for Built-in LoRa Network Server
- MQTT for ChirpStack 2.x
- MQTT for ChirpStack 3.x (JSON)
- MQTT for ChirpStack 3.x (Protobuf)
- MQTT for ChirpStack 4.x (Protobuf)
- MQTT Broker Address: The IP address of the gateway where the MQTT Broker is hosted.
- MQTT Broker Port: The corresponding port (default port is 1883).
- MQTT Version: Choose between V3.1 and V3.1.1. There is very little difference between them, more information can be found here.
- QoS: Set the desired Quality of Service level.
- 0 - At Most Once
- 1 - At Least Once
- 2 - Exactly Once
- Keepalive interval (s): The keepalive interval in seconds (10 default).
- Clean Session: When this function is enabled, the Broker will not store any subscription information or undelivered messages.
- Retain: When this function is enabled, the last message published will be retained.
- Enable User Authentication: This function enables user authentication via username and password.
- SSL/TLS Mode
- None: disable SSL/TLS
- CA signed server certification
- Self-signed server certification
- Self-signed server & client certification
- TLS Version: When enabling SSL/TLS, you need to configure the TLS protocol version, supporting TLS v1.1 / TLS v1.2.
- Uplink Topic/Downlink Topic/Downlink Acknowledge Topic/Gateway Statistic Topic: MQTT template topics. These topics cannot be changed.
- MQTT Protocol: From the dropdown menu, choose the MQTT protocol of the MQTT bridge. Note that the MQTT topics change depending on the chosen protocol.
-
Class B Settings: Enable/disable the class B beaconing. Click on Configure the beacon period and ping slots of class B devices to use time-sync beacons sent by the gateways to expand class B settings.
Figure 1: Class B Settings- Enable Beacon: Enables the class B beacon.
- Enable Hopping: Enables/disables Class B hopping as the class B beacon is transmitted following a frequency hopping pattern.
- Beacon Frequency (MHz): The frequency of the beacon. If frequency hopping is enabled, this option does not appear.
- Beacon Tx Power: The power for transmitting the beacon ping.
-
GPS Information: Set fake GPS coordinates (disabled by default). Click on Add your GPS info manually to expand the GPS settings and enable Fake GPS with the switch.
Figure 1: GPS Information -
Fine Timestamp: Enable timestamp (disabled by default). Click on Include fine timestamp in uplink packet for TDoA positioning to expand the fine timestamp setting.
Figure 1: Fine Timestamp -
Packet Filter: Set a filter for the packets from chosen devices (disabled by default). Click on Allows to optimize bandwidth by filtering and forwarding packets from chosen end devices to expand packet filter settings. If White List Mode and Auto Filter are enabled, these are the following options:
Figure 1: Packet Filter- OUI: This is white list filtering option to filter by Organizationally Unique Identifier of the end device.
- Network ID: This is a white list filtering option to filter by Network ID.
- Discard Period (s): This is a period threshold of discard time for nodes (in seconds).
- Join Period (s): This is a period threshold of Statistics on the latest join request (in seconds).
- Join Interval (s): This is a time interval threshold of the same device EUI twice-consecutive join request (in seconds).
- Join Count 1: This is the maximum count of join requests allowed during Join Interval.
- Join Count 2: This is the maximum count of join requests allowed during the Join Period.
Basics Station Mode Settings
When the Basics station work mode is chosen, the corresponding settings pop up replacing the ones for other work modes.
- Log Level: Set the log level.
- Error: Shows only error logs
- Warning: Shows warnings logs
- Notice: Shows notice logs
- Info: Shows all notice, error, and warning logs
- Debug: This is full log, it shows all types of logs, it is used for debugging.
- Basics station server setup: Click on Configure Basics Station server setup to expand the Basics station server setup menu.
- Basics Station Server Type
- CUPS-BOOT Server
- CUPS Server
- LNS Server
- Server URL: The address of the server to which the gateway is going to connect.
- Server Port: This is the corresponding port of the server.
- Authentication Mode: Choose between four options with their corresponding fields.
- No Authentication: The server requires no authentication.
- TLS Server Authentication: The server requires a trust file for authentication.
- TLS Server and Client Authentication: The server requires trust, certificate, and key files for authentication.
- TLS Server Authentication and Client Token: The server requires a trust file and a client token.
Built-in Network Server Mode Settings
When the Built-in network server work mode is chosen, the corresponding settings pop up replacing the ones for other work modes.
-
Log Level: Set the log level.
- Error: Shows only error logs.
- Warning: Shows warnings logs.
- Notice: Shows notice logs.
- Info: Shows all notice, error, and warning logs.
- Debug: This is full log, it shows all types of logs, it is used for debugging.
-
Frequency Plan: Here, you can select your country and change the frequency plan of the gateway.
-
Select your country: (Optional) Selecting the correct country will assure you are operating under the local law requirements. The transmit power of your gateway will be set to the local regulation maximum and the LBT feature will be turned on if required.
Figure 1: Select your country -
Regin: Set the Region here. You can switch the frequency plan in the following regions:
- US915, AS923, KR920, AS923
- EU868, RU864, IN865
- EU433
- CN470
NOTE- If you have already selected a frequency band in Select your country, it cannot be set here again.
- Different hardware supports different LoRaWAN regions.
- If your Region is set to AS923, you need to configure the Variation option, such as AS923-1/AS923-2/AS923-3/AS923-4.
-
Click on View detailed regional parameters of the frequency plan to expand the options.
- LoRaWAN Public: When enabled (by default), the gateway will process data from all end devices. If you want to create a private network, you can to turn it off. The gateway will process the data only from the end devices, which sync word is changed to private.
For different frequency bands, there are differences in the frequency sub-bands section.
For gateways that support the EU433, RU864, IN865, EU868, KR920, and AS923 LoRaWAN regions, the frequency sub-bands section is as follows.
Figure 1: Frequency plan settings for different LoRaWAN regions- Multi-SF LoRa Channel Frequency (MHz): Set the frequency for the Multi-SF LoRa channel. It can be removed by clicking on the X next to it. When adding a new frequency, enter the frequency in the text box and click Add.
- Standard LoRa Channel Frequency (MHz): Set the frequency for the standard LoRa channel.
- FSK Channel Frequency (MHz): Set the frequency for the FSK channel.
For gateways that support the CN470, US915, and AU915 LoRaWAN regions, the frequency sub-bands section is as follows. From the dropdown menu, choose sub-bands to use for the uplink traffic.
Figure 1: Frequency plan settings for different LoRaWAN regions
-
-
Network Server Parameters: Click on Network server parameters are used to configure general setup for your LoRa built-in server. This section is required for filling-in. to expand the settings menu.
Figure 1: Network Server Parameters- Network ID: This is a decimal number to distinguish between networks if deploying multiple ones.
- Enable ADR: The switch enables/disables Adaptive Data Rate. The built-in server will optimize the data rates, airtime, and energy consumption in the network depending upon the prevailing channel conditions.
- Min /Max Allowed TX Data-Rate: DR0 to DR7 can be selected to limit the ADR possible values range. Depends on the Region.
- ADR Margin (dB): This is visible only when ADR is enabled. It is a value to keep in dB to make sure that the data rate is not overestimated resulting in poor performance (error rate and range).
- Rx1 Delay (s): This is the delay of the first receive window in seconds.
- RX1 Data Rate Offset: This determines the data rate of the downlink frames originating from the Gateway for the Rx1 window. By default, it is 0 – identical to the uplink.
- RX2 Frequency (MHz): This is the frequency of the second receive window.
- RX2 Data Rate: The Data Rate of the frames to be sent in the second receive window.
- Uplink / Downlink Dwell Time Limit: Set the uplink / downlink Dwell Time limit. Note that these two configuration options are only valid for specific regions.
- Downlink Tx Power (dBm): It is useful, if you want to use a larger antenna with more gain. Values from -6 to 20 are permissible.
- Disable Frame-counter Validate: This function turns on/off the Frame counter validation.
- End device-status request interval (s): This shows how often should the end-devices be polled for their status log level.
- Statistic interval (s): This shows how often the statistics will be gathered.
-
Packet Filter: Set a filter for the packets from chosen devices (disabled by default). Click on Allows to optimize bandwidth by filtering and forwarding packets from chosen end devices to expand packet filter settings. If White List Mode and Auto Filter are enabled, these are the following options:
Figure 1: Packet Filter- OUI: This is white list filtering option to filter by Organizationally Unique Identifier of the end device.
- Network ID: This is a white list filtering option to filter by Network ID.
- Discard Period (s): This is a period threshold of discard time for nodes (in seconds).
- Join Period (s): This is a period threshold of Statistics on the latest join request (in seconds).
- Join Interval (s): This is a time interval threshold of the same device EUI twice-consecutive join request (in seconds).
- Join Count 1: This is the maximum count of join requests allowed during Join Interval.
- Join Count 2: This is the maximum count of join requests allowed during the Join Period.
-
Gateway backend: To extend the settings field, click on Configure the Gateway Backend to allow the central gateway and extenders to communicate via MQTT.
Figure 1: Gateway backend- MQTT Broker Address: The IP address of the machine where the MQTT Broker is hosted (default is 127.0.0.1 for the built-in one).
- MQTT Broker Port: The corresponding port (default port is 1883).
- MQTT Version: Choose between V3.1 and V3.1.1. There is very little difference between them, more information can be found here.
- QoS: Set the desired Quality of Service level. More information about QoS can be found here.
- 0 - At Most Once
- 1 - At Least Once
- 2 - Exactly Once
- Keepalive interval (s): The keepalive interval in seconds (10 default).
- Clean session: When this function is enabled (disabled by default), the Broker will not store any subscription information or undelivered messages.
- Retain: When this function is enabled (disabled by default), the last message published will be retained.
- Enable User Authentication: This function enables Encryption of the transmitted data (disabled by default). You to configure the credentials (username and password) used to encrypt the data to secure authentication being performed.
- SSL/TLS Mode
- None: disable SSL/TLS
- CA signed server certification
- Self-signed server certification
- Self-signed server & client certification
- TLS Version: When enabling SSL/TLS, you need to configure the TLS protocol version, supporting TLS v1.1 / TLS v1.2.
- Uplink Topic/Downlink Topic/Downlink Acknowledge Topic/Gateway Statistic Topic: MQTT template topics. These topics cannot be changed.
-
Class B Settings: Enable/disable the class B beaconing. To expand the menu, click on Configure the beacon period and ping slots of class B devices to use time-sync beacons sent by the gateways.
Figure 1: Class B Settings- Enable Beacon: The switch enables/disables Class B beaconing.
- PingSlot Channel Frequency: The frequency used for the beacon ping.
- PingSlot Datarate: The minimum duration of each beacon ping slot.
- Enable Hopping: Enables/disables Class B hopping as the class B beacon is transmitted following a frequency hopping pattern.
- Beacon Frequency (MHz): The frequency of the beacon. If frequency hopping is enabled, this option does not appear.
- Beacon TX Power: This is the transmit power of the beacon ping.
-
Integration Interface Parameters: Configure an integration to an external server. To expand the menu, click on Configure the Integration Interface to forward all received data to an external network server. The settings change depending on the chosen Integration mode.
Figure 1: Integration Interface Parameters- Enable Integration Interface: Enables the integration interface.
- Generic MQTT integration mode:
- MQTT Broker Address: The IP address of the machine where the MQTT Broker is hosted (default is 127.0.0.1 for the built-in one).
- MQTT Broker Port: The corresponding port (default port is 1883).
- MQTT Version: Choose between V3.1 and V3.1.1. There is very little difference between them, more information can be found here.
- QoS: Set the desired Quality of Service level. More information about the QoS can be found here.
- Keepalive interval (s): The keepalive interval in seconds (10 default).
- Clean session: When this function is enabled, the Broker will not store any subscription information or undelivered messages.
- Retain: When this function is enabled, the last message published will be retained.
- Client ID: An ID that is used to associate with the topic. If the field is left empty, a random one will be generated.
- Enable User Authentication: This function enables user authentication via username and password.
- SSL/TLS Mode: When this mode is enabled (disabled by default), choose between three modes CA signed server certificate, Self-signed server certificate, Self-signed server & client certificate, with their corresponding options.
- TLS Version: When enabling SSL/TLS, you need to configure the TLS protocol version, supporting TLS v1.1 / TLS v1.2.
- Join Topic / Uplink Topic / Downlink Topic / Downlink Acknowledge Topic / Status Topic: MQTT template topics. These topics cannot be changed.
- AWS IoT Core integration mode:
- AWS IoT Core endpoint URL: This is the address of the AWS.
- AWS IoT Core endpoint Port: The corresponding port of the server.
- Root CA: CA certificate provided by the AWS IoT Core.
- Certificate: Certificate for the gateway, generated by AWS IoT Core.
- Key: Private key for the gateway, generated by AWS IoT Core.
Applications
This tab is available only when the gateway is in Built-in Network Server working mode. In this tab, you can create an application and register end devices in the Built-in Network Server.
Create an Application
-
Navigate to LoRa® > Applications tab.
-
To add a new application, click the Add application button or the add one now link.
-
In the new window, configure the following information.
-
Application name: name of the application
-
Application description: (optional) description of the application
-
Application Type
-
Unified Application key: All devices will use the same application key. Select this option and the corresponding settings will pop up.
Figure 1: Configure unified application key
-
Auto Add Device: This option is available when Unified Application Key is selected. Enabling the Auto Add Device, the device will be automatically registered with the adding request.
Figure 1: Enable auto add device
- Application Key: This option is available when Unified Application Key is selected. You can type in an application key or click the Autogenerate button to generate a key.
- Application EUI: This option is available when Auto Add Device is enabled. You can type in an application key or click the Autogenerate button to generate an EUI.
- Separate Application keys: Each device has its own application key. Add the key when registering the device.
-
-
Payload format
- Payload type: Setting the payload type allows data going to and from end devices to be processed according to the specified protocol.
- None
- CayenneLPP
- Only forward data object: Enabling this option will only forward the parsed data objects.
- Payload type: Setting the payload type allows data going to and from end devices to be processed according to the specified protocol.
-
Integration Parameters
- Decode Type: data decoding type
- Base 64
- HEX string
- Report LoRa Radio Information: Enabling this option allows reporting of LoRa radio information to the integration server, such as SNR/RSSI, etc.
- Enable HTTP/HTTPS Integration Parameters: enable HTTP interface settings
- Header name
- Header value
- Uplink data URL
- Join notification URL
- Ack notification URL
- Device-status notification URL
- Maximum number of concurrent connections
- Maximum length of queue
- Decode Type: data decoding type
- Click Save Application to add the new application.
If you need to modify or delete the application, go to LoRa® > Applications> application name > Configuration. Here, you can update the configuration or click Remove this application to remove the application.
Add an End Device
-
To add an end device, go to LoRa® > Applications.
-
Click on the target application.
NOTEYou can also click "Add end devices" in the END DEVICES list (this button will only be displayed if there are no end devices in the application).
- In the End devices tab, click Add end device.
- In the End device information page, fill in the following information.
- Activation Mode:
- OTAA: Over-The-Air-Activation (OTAA).
- ABP: Activation-By-Personalization (ABP).
- End device (group) name: Name of the end device (group).
- End device description (optional): A description of the end device, optional.
- Enable LPTP: LoRa Private Transport Protocol (LPTP) is a RAK proprietary message splitting protocol, which can send data with a length exceeding the maximum permissible size, using multiple messages.
- Application Key: The parameter for the LoRaWAN OTAA mode.
- Class: Set LoRaWAN Class.
- Application Session Key: The parameter for the LoRaWAN ABP mode.
- Network Session Key: The parameter for the LoRaWAN ABP mode.
- Frame Counter Width: The width of the frame counter.
- LoRaWAN MAC Version: The LoRaWAN MAC version.
- LoRaWAN Regional Parameters reversion: The LoRaWAN regional parameters reversion.
- To save the changes, click Add end devices.
- In the Adding end devices page, you can choose to add devices either by uploading a CSV file or by entering them manually.
-
Upload a list of end devices: Add end devices via CSV file.
-
Click the download it here link to download the CSV file template and save it locally.
-
Fill in the device information into the template file.
Figure 1: Input device information in OTAA join modeNOTE- In OTAA join mode, you need to fill in the device EUI information.
- In ABP join mode, you need to fill in both the device EUI and device address information.
-
Upload the template file by dropping the file in the form or clicking choose file.
-
After the file is uploaded successfully, the end devices will be displayed in the End devices list.
-
-
Manually add new end devices: Manually enter a main device EUI or a main device address. You can add end devices in batches by setting the step size and the total number of devices.
-
Enter a main device EUI in the End Device EUI (Main) option.
NOTE- In OTAA join mode, you need to fill in the device EUI information.
- In ABP join mode, you need to fill in both the device EUI and device address information.
-
Set the step size in the Step (Optional) option. The device EUI or device address will increase sequentially based on this value.
-
In the Count (optional) option, set the number of end devices to add.
Figure 1: Set step size and count -
Click the Add to "End Devices list". The end devices will be displayed in the End devices list.
-
-
End devices list: All end devices successfully added through Upload a list of end devices and Manually add new end devices will be displayed in the list.
Figure 1: End devices list- EUI: Device EUI.
- ADDRESS: Device address, displayed only in ABP join mode.
- STATUS: Device EUI or device address configuration status.
-
End devices with error: The end devices that failed to be added through Upload a list of end devices and Manually add new end devices will be displayed in the list.
Figure 1: End devices with error- EUI: Device EUI.
- ADDRESS: Device address, displayed only in ABP join mode.
- STATUS: Device EUI or device address configuration status.
- Select the devices to be added in the End devices list and click Add end devices to add the devices to the application.
If you need to modify or delete the device, go to LoRa® > Applications> application name > End devices > device name. Here, you can update the configuration or send downlink messages to the end device.
Configuration: In this tab, you can modify the configuration of the device or delete the device.
-
End device information: Device configuration information.
-
Packet capture: View all packets exchanged between end device and central gateway. Click the Packet capture to view the details.
- Pause/Restart session: Тhe button pauses or restarts the session.
- Download session: Тhe button downloads a
.json
file with packets data in it. - Filter: The button drops-down a filter menu.
- Type: Тype of the packet.
- Frequency: The frequency on which the packet is received/sent.
- RSSI: Range of the RSSI.
- SNR: Range of the SNR.
- Hide CRC_ERR Packets: When enabled, the filter will hide all packets with CRC Error.
- Reset filter: Reset the filter to default.
-
Delete end device: To delete the device, click Delete end device. By deleting this end device, it will be removed from the application.
Downlink: Send downlink messages to the end device.
- Downlink
- Frame Confirmation: Enable or disable frame confirmation.
- FPort: Port.
- HEX Bytes: Hexadecimal message bytes.
- Scheduled Downlink: List of sent downlink data.
- TIMESTAMP: Send time.
- FPORT: Port.
- CONFIRMED: Confirmation status.
- DATA: Message content.
- SIZE: Message bytes.
Overview: In this tab, you can view the end device status, traffic history, data rate, and SNR & RSSI.
- TOTAL DOWNLINK: Total downlink frames transmitted.
- TOTAL UPLINK: Total uplink frames transmitted.
- BATTERY: Battery status.
- END DEVICE ADDRESS: Device address.
- LINK MARGIN: Link margin.
- PACKET LOSS: Packet loss.
- LAST SEEN: Offline time.
- SNR & RSSI: The SNR & RSSI block shows information about the Signal to Noise Ratio (SNR) and Received Signal Strength Indicator (RSSI) of the packets in a graph form.
- Traffic History: This block shows a general graph of the amount of traffic in packets versus time.
- DataRate: This block shows the number of packets as per Data Rate (DR0 to DR7).
Gateways
In this tab, add extender gateways to work with the LNS. The current gateway do not need to be added as the Network Server is working on it and it acts as the central gateway. Note that this tab is available only when the gateway is in Built-in Network Server working mode.
- Navigate to LoRa® > Gateways tab.
- To add an extender gateway, click the Add extender gateway.
- In the new window, configure the following information.
- Extender gateway EUI: Gateway EUI.
- Extender gateway name: Name of the gateway.
- Extender gateway description: (optional) Description of the gateway.
-
To save the changes, click the Add to "Extender Gateway list". The extender gateway will be displayed in the Extender Gateway list. You can also click the X icon to delete the extender gateway.
-
Click Add extender gateway to add the extender gateway to the built-in server.
NOTEIf you select Skip, the extender gateway will not be added successfully and the web page will redirect to the gateway list.
If you need to modify or delete the extender gateway, go to LoRa® > Gateways. Select the target gateway and click the icon in the gateway list.
View gateway details
Click View gateway details to view or modify the configuration of the extender gateway.
Delete extender gateway
Click Delete extender gateway to delete the gateway.
Overview
In this tab, you can see information about the end devices and traffic going thru the extender gateways and the central gateway. Note that this tab is available only when the gateway is in Built-in Network Server working mode.
- In the first block, you can visualize information about the traffic and the end devices of the central gateway and all extender gateways if any.
- Total Downlink: Total downlink frames transmitted.
- Total uplinks: Total uplink frames transmitted.
- Gateways: The total amount of extender gateways that are forwarding frames to the built-in server plus the central one.
- End Devices: The total amount of end-devices that are currently authenticated with the server.
- Total OTAA Requests: The total authentication requests submitted by end-nodes.
- Rejected OTAA Requests: The total authentication requests that were rejected.
- Uptime: The time the built-in server has been working without interruption.
- SNR & RSSI: The SNR & RSSI block shows information about the Signal to Noise Ratio (SNR) and Received Signal Strength Indicator (RSSI) of the packets in a graph form.
- Traffic History: This block shows a general graph of the amount of traffic in packets versus time.
- DataRate: This block shows the number of packets as per Data Rate (DR0 to DR7).
Network
In the Network menu, changes on the WAN (Wide Area Network) and LAN (Local Area Network) interfaces can be performed. The WAN menu contains the interfaces for communication with the Internet. The LAN menu contains the interfaces for the local networking.
WAN
In the WAN menu, you can change the priority of the WAN interfaces. If the highest priority interface goes down, the next in line will be used to access the Internet. The red/green light on the left of the WAN interface name shows if that interface is available.
Change Priority
To rearrange the default order click on the Change Priority button. The priority is changed with the arrows left of the interface name(). The arrow pointing up will increase the priority, and the arrow pointing down will lower it. To save the changes, you need to click on Save.
Ethernet
Shows the information about the selected interface. Expand the interface window by clicking on the name of the interface or the arrow on the left of the interface ().
-
Protocol type: The type of the protocol.
-
IP Address: The address assigned to the gateway.
-
Netmask: The netmask of the gateway.
-
Connection time: The time of the gateway's connection to that interface.
-
RX: Packets received.
-
TX: Packets sent.
-
DNS: DNS server addresses.
-
Settings: Set the network interface and tracking preferences for ethernet mode.
-
General
Figure 1: Ethernet settings General tab- Enable WAN and disable LAN: When switched on, this option enables the WAN and disables the LAN interface.
- Static address: Set a static address for the gateway.
- IPv4 Address: The desired static address of the gateway in IPv4.
- IPv4 Netmask: The netmask of the gateway in IPv4.
- IPv4 Router: The address of the router in IPv4.
- DNS Server: Custom DNS server address.
- DHCP client: The router’s DHCP server will assign IP to the gateway.
- Use custom DNS server: When switched on, this option allows the gateway to assign DNS address from the router.
- DNS Server: Add custom DNS.
- PPPoE: Set Point-to-Point Protocol over Ethernet, with PAP/CHAP Username and Password provided by the internet provider. The DNS server advertised by router switch allows the gateway to assign DNS address from the router. If you want to use custom one, you need to disable it.
-
Tracking: Set up continuous tracking of the interface to automatically switch the gateway to the next available interface when the current interface is no longer stable.
Figure 1: Ethernet settings Tracking tab- IP: Add an IP address to send the ping test.
- Reliability: The added minimum number of IP addresses that must respond to confirm a successful ping test.
- Ping count: Counter of the pings.
- Ping timeout (s): Timeout of the pings.
- Ping interval: The ping interval.
- Down: The number of the ping test that must fail consecutively to confirm the interface is down.
- Up: The number of the ping test that must fail consecutively to confirm the interface is up.
-
Wi-Fi
Shows the information about the selected interface.
-
Protocol Type: The type of the protocol.
-
IP Address: The IP assigned to the gateway.
-
Netmask: The netmask assigned to the gateway.
-
Connection time: The time the gateway is connected to the Wi-Fi interface.
-
Channel: This field shows which operating frequency will be used.
-
(E)SSID: The SSID of the Wi-Fi network.
-
BSSID: Тhe MAC address of the wireless access point or a router in the wireless network.
-
Bitrate: The bitrate of the wireless network.
-
DNS: DNS server addresses.
-
Settings: Set the network interface and tracking preferences for Wi-Fi mode.
-
General: Set a connection to the wireless network.
Figure 1: Wi-Fi settings General tab-
Enabled/Disabled: Enable/disable the Wi-Fi interface.
-
Available (E)SSID networks: The Scan button scans for available wireless networks. Select the desired network or enter it manually.
-
(E)SSID: Extended Service Set Identifier.
-
Encryption: Choose what encryption the wireless network uses and type in the password in the Key field. The options are No Encryption, WPA-PSK, WPA2-PSK, and WPA-PSK/WPA2-PSK Mixed Mode (recommended).
-
Static address: Set a static address for the gateway.
- IPv4 Address: The desired static address of the gateway in IPv4.
- IPv4 Netmask: The netmask of the gateway in IPv4.
- IPv4 Router: The address of the router in IPv4.
- DNS Server: Custom DNS server address.
-
DHCP client: The router’s DHCP server will assign IP to the gateway.
- Use custom DNS server: When disabled, the DNS server addresses advertised from the router will be ignored.
- DNS Server: Add custom DNS.
-
-
Tracking: Set up continuous tracking of the interface to automatically switch the gateway to the next available interface when the current interface is no longer stable.
Figure 1: Wi-Fi settings Tracking tab- IP: Add an IP address to send the ping test.
- Reliability: The added minimum number of IP addresses that must respond to confirm a successful ping test.
- Ping count: Counter of the pings.
- Ping timeout (s): Timeout of the pings.
- Ping interval: The ping interval.
- Down: The number of the ping test that must fail consecutively to confirm the interface is down.
- Up: The number of the ping test that must fail consecutively to confirm the interface is up.
-
Cellular
Shows the information about the selected interface.
-
IP Address: The IP assigned to the gateway.
-
Netmask: The netmask assigned to the gateway.
-
IMSI: The International Mobile Subscriber Identification Number.
-
ICCID: The Integrated Circuit Card Identifier.
-
IMEI: The International Mobile Equipment Identity.
-
Connection time: The time the gateway was connected to the interface.
-
Network: Network standard.
-
SIM Card Status: The status of the SIM card.
-
Settings: Set the network interface and tracking preferences for cellular mode
-
General: Set a cellular connection.
Figure 1: Cellular settings General tab- Enabled/Disabled: Enable/disable the Cellular interface.
- APN (optional): The Access Point Name.
- User (optional): Username used for authorization (leave empty if there is none).
- Password (optional): Password used for authorization (leave empty if there is none).
- PIN code (optional): The PIN code of the SIM Card (leave empty if there is none).
-
Tracking: Set up continuous tracking of the interface to automatically switch the gateway to the next available interface when the current interface is no longer stable.
Figure 1: Cellular settings Tracking tab- IP: Add an IP address to send the ping test.
- Reliability: The added minimum number of IP addresses that must respond to confirm a successful ping test.
- Ping count: Counter of the pings.
- Ping timeout (s): Timeout of the pings.
- Ping interval: The ping interval.
- Down: The number of the ping test that must fail consecutively to confirm the interface is down.
- Up: The number of the ping test that must fail consecutively to confirm the interface is up.
-
LAN
In the LAN tab, you can see and edit information about the Local Area Network.
The red/green light on the left shows if the interface is enabled/disabled. Expand each LAN interface window, by clicking on its name or the arrow on the right () of the interface.
DHCP Server
-
IP Address: The IP address of the gateway DHCP server.
-
Netmask: The netmask of the DHCP server of the server.
-
Settings: Set the network interface preferences for DHCP server.
Figure 1: DHCP Settings- Address: The IPv4 address of the LAN DHCP server.
- Netmask: The netmask of the DHCP server of the server.
Ethernet
The field only shows if the interface is active. The Settings button redirects you to the LAN Ethernet settings.
-
Enable LAN and disable WAN: Enable the LAN Ethernet interface and disable the WAN Ethernet interface.
Figure 1: Ethernet settings
Wi-Fi
-
(E)SSID: SSID of the Access Point (AP) of the gateway.
-
Encryption: Encryption of the AP.
-
Settings: Set the network interface and tracking preferences for Wi-Fi mode.
Figure 1: Wi-Fi settings- Enabled/Disabled: Enable/disable the LAN Wi-Fi interface.
- Channel: Set a channel for the Wi-Fi. Default is Auto, the gateway will automatically choose a channel.
- (E)SSID: The name of the AP.
- Encryption: Set an encryption of the AP with a password written in the Key field. The options are No Encryption, WPA-PSK, WPA2-PSK, and WPA-PSK/WPA-PSK2 Mixed Mode (recommended).
- Hidden: You can hide the AP.
Diagnostics
In the Diagnostics menu, review the logs on the gateway and perform checks.
System Log
On this page, you can see the complete system logs. It is mainly used for debugging purposes. The System Log reports both system information and actual data from LoRa frames coming from the end nodes.
At the top right corner there is the Auto Refresh button. Depending on the state (ON or OFF) the auto-refresh will be enabled or disabled.
Network Utilities
This is where checking via the built-in tools can be performed: Ping, Trace, and Nslookup. You can either enter an URL or an IP Address in the text box and execute the command with one of the buttons. The results are conveniently displayed in a CLI box.
Settings
General Settings
In this tab, change the name of the gateway, setup a system log server or reboot the device.
- Gateway name: Change the default name of the gateway by typing the desired name in the Name field and clicking the Save button.
- System log: Point the gateway to a system log server where they can save logs.
- Buffer size (KiB): This is the maximum size of the log file to be saved.
- Log expiration: How long does it take for the log file to be saved.
- 14 days
- 1 month
- 3 month
- 6 month
- 12 month
- External system log server IP address: The address of the external system log server.
- Port: The corresponding port of the system log server.
- Time synchronization
- Enable NTP client: The switch enables/disables the time synchronization from a Network Time Protocol (NTP) server.
- NTP server candidates: In the NTP server candidates area, you can add or remove NTP candidates. To add a new candidate, click on the Add new server candidate text. A new field pops up, where you need to fill the server candidate.
- Reboot: Here you can reboot the gateway. All unsaved changes will be discarded.
Backup and Restore
In this tab, you can backup, restore or reset the gateway's settings.
- Backup: Use this option to create a backup image of the current configuration settings for the gateway.
- Set password to protect the backup archive : Set a password to protect the backup archive.
- Generate and download backup: The Generate and download backup button creates and downloads an archive file with all current settings.
- Restore: To restore the configuration file, you can upload a previously generated backup here. Where you can upload an archive file by clicking choose file or drag-and-dropping it in the area and restore the previous settings.
- Reset: With the Reset button, you can restore the factory settings. This action will reset the gateway to its factory default settings, and your configuration will be lost permanently.
Firmware
The Firmware tab is where you can see the current version of the firmware and update it.
- Current version: The current firmware version of the gateway.
- Upload the new firmware file: Here you can upload the new firmware file for the gateway.
- Keep settings after updating: If this option is checked, the system will keep settings after the firmware upgrade.
-
Download the latest firmware of the gateway and unzip it.
-
Now, you can either drag and drop the RWI file in the Drop your RWI file here or choose file form or click the choose file link in the form and browse for the RWI file.
Figure 1: Upload the firmware file -
Check the Keep settings after updating option.
NOTEThe Keep settings after updating check box is selected by default, as unchecking it will results in having a gateway with stock settings after the firmware update.
-
Click Update to initiate the flashing process.
Figure 1: Upgrading -
After the upgrade is complete, you need to log in to the gateway again.
When the Enable FOTA option from the WisDM tab is active, you will not be able to update the firmware, as it is done via WisDM.
File Browser
Through the File browser tab, you can access the files in the root partition. System logs are saved there and can be downloaded from here.
-
To download the system logs, go to Settings > File browser > mnt > mmcblk0p1 > syslog.
-
Click on the log file to download.
Figure 1: System logs
WisDM
Here, you can enable/disable WisDM integration and FOTA (Firmware over the air).
- Allow WisDM Integration: Enable the WisDM integration. The gateway can be managed via the WisDM Platform.
- Registered in WisDM:
- : The gateway has been registered in the WisDM system.
- : The gateway is not registered in the WisDM system.
- Enable FOTA: When enabled, the gateway can be upgraded to a newer firmware version via the WisDM platform. If you want to upgrade the firmware via the Web UI, this function must be disabled.
Extensions
Here, you can install extensions to the gateway. For detailed instructions on Extensions, refer to WisGateOS2 Extensions.
User Preferences
Here you can set your personal preferences for the gateway, such as timezone, language or change your password.
In the bottom left corner, choose User preferences to set your personal preferences for the gateway.
Choosing the User preferences option will redirect you to the corresponding page.
- Change password: Change the password for access for the Web UI.
- Time settings: Set local time to the gateway.
- Language: Set system language.
If you need to logout from the Web UI, choose Logout in the bottom left corner.