WisGateOS 2 Extensions User Manual
Overview
WisGateOS 2 introduces an extension framework that enables gateways to install additional software modules. Extensions can be added, removed, or updated as needed, making deployments more flexible and adaptable.
Starting from WisGateOS 2 2.2.x, the extension installation process is further improved for better security and user experience:
- All extensions are verified with a digital signature to ensure authenticity and compatibility.
- The Extension Gallery enables direct access to verified extensions, simplifying installation and management workflows.
- An Internet connection is required during installation to complete the signature verification.
To check your gateway firmware version, navigate to Dashboard > Overview in the Web UI.
- For gateways running WisGateOS 2 2.2.x or later, proceed to the updated steps in the WisGateOS 2 2.2.x or Later section.
- For gateways running WisGateOS 2 2.0.x or 2.1.x, follow the installation procedure outlined in the WisGateOS 2 2.0.x/2.1.x section.
Supported Extensions
| Extensions | Descriptions | Remarks |
|---|---|---|
| Breathing Light | By using the breathing light extension, you can personalize the LED light's working modes, frequency, and color. | - |
| Custom Logo | The Custom Logo extension allows you to upload your logo in the Web UI. This extension is universal and applicable to all gateways that support WisGateOS 2. | - |
| Country Settings | Listen Before Talk (LBT) ensures the gateway checks the availability of the channel before transmitting. This is crucial in LoRaWAN, a multi-channel protocol that uses the ISM band, to prevent collision from simultaneous transmission. LBT regulations vary by country, and WisGateOS 2 provides a country table for easy configuration of the country code. | - |
| Open/Close Port | This extension enables you to add or delete packet traffic management rules on the gateway, allowing designated subnet host IPs to communicate with the gateway through specified ports. | - |
| Solar Battery | The Solar Battery extension displays the operational status of the gateway's solar battery, including its performance, health status, cycle period, capacity, charging and discharging modes, and more. | Compatible with any WisGateOS 2 gateway equipped with solar power systems. |
| WireGuard | WireGuard is a simple and fast VPN, designed to be more efficient and leaner than the IPsec protocol, and outperform RAKwireless’s OpenVPN.. Support for WireGuard has been implemented on RAKwireless gateways. | - |
| OpenVPN Client | OpenVPN is a VPN solution that creates a secure network through a server accessible via a public IP address. This server allows the gateway and various client devices, such as PCs and smartphones, to connect. It can utilize backhaul options like Ethernet, Wi-Fi, or LTE. For LTE connections, ensure the gateway has a static public IP address. | - |
| Operation and Maintenance | This operation and maintenance tool supports scheduled device reboots and 4G network monitoring. If the 4G connection is lost, it automatically restarts the cellular module to restore connectivity. | This extension is only compatible with WisGateOS 2 2.2.x and later. |
| Field Test Data Processor | This application provides backend computing for the Field Tester. It communicates with the LoRaWAN network server via MQTT (subscribe/publish), supporting both the built-in LNS on the RAK gateway and third-party LNS. It also allows you to view and download measurement data. | This extension is only compatible with WisGateOS 2 2.2.x and later. |
| Failover Reboot | The Failover Reboot tool periodically checks the status of all enabled network links (LTE / Ethernet / Wi-Fi) of the gateway. Once it detects that all network links are offline, it will try to restore network connectivity by rebooting the LTE module or the gateway to trigger failover. | This extension is only compatible with WisGateOS 2 2.2.x and later. |
| Wi-Fi Reboot | This extension monitors Wi-Fi connectivity by periodically sending ping and httping requests to specified targets. If all tests consistently fail, it will trigger a Wi-Fi module reboot, and escalate to a full system reboot if necessary. | This extension is only compatible with WisGateOS 2 2.2.x and later. |
| RF Spectrum Scanner | The RF Spectrum Scanner extension enables real-time scanning and visualization of RF activity across a defined frequency range. It uses color-coded heatmaps to display signal strength (RSSI) over time and frequency, helping you detect interference, identify noisy channels, and assess the overall RF environment. | This extension is only compatible with WisGateOS 2 2.2.x and later. |
