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
Breathing Light – Customize gateway LED behavior
Description | By using the breathing light extension, you can personalize the LED light's working modes, frequency, and color. |
Usage | Change LED behavior to meet site requirements, such as disabling blinking, adjusting colors for specific alerts, or matching internal maintenance standards. |
Support | HW: WisGate Edge Lite 2 and WisGate Soho Lite SW: WisGateOS 2 |
Custom Logo – Brand the Web UI with your logo
Description | The Custom Logo extension allows you to upload your logo in the Web UI. |
Usage | Quickly brand the gateway UI for customer deliveries, demos, or white-label projects. |
Support | HW: All WisGateOS 2 gateways SW: WisGateOS 2 |
Country Settings (LBT) – Set country code and enable Listen-Before-Talk
Description | Set your country to automatically apply the correct LoRaWAN® frequency plan, maximum transmit power, and channel list. Enable Listen-Before-Talk (LBT) for regions where it is mandatory to check channel availability before transmission. |
Usage | Ensure regulatory compliance in regions such as AS923-JP and KR920, and reduce interference in dense deployments. |
Support | HW: Only gateways with LBT-capable hardware SW: WisGateOS 2 |
Open/Close Port – Control port access and allowlist IPs
Description | Manage which network ports are open on the gateway and restrict access to trusted IP addresses or subnets, reducing the risk of unauthorized connections. |
Usage | Limit SSH/HTTP access to admin networks, allow MQTT/HTTPS only for internal systems, comply with enterprise security policies. |
Support | HW: All WisGateOS 2 gateways SW: WisGateOS 2 |
Solar Battery – Monitor solar power system status
Description | Display real-time operational data of the gateway’s solar battery, including performance, health, cycle count, capacity, and charging/discharging modes, helping to assess system reliability. |
Usage | Monitor off-grid or solar-powered sites, schedule preventive maintenance, and verify performance during prolonged low-sunlight conditions. |
Support | HW: RAK Battery Plus-compatible gateways (RAK7240V2, RAK7267, RAK7289V2, RAK7285) SW: WisGateOS 2 |
WireGuard VPN – Lightweight, high-speed encrypted tunnel
Description | Creates a secure WireGuard VPN tunnel between the gateway and a remote VPN server, enabling encrypted, low-latency communication over the internet. |
Usage | Protect remote operations, enable cross-region private networking, and maintain high-speed secure connectivity. |
Support | HW: All WisGateOS 2 gateways SW: WisGateOS 2 |
OpenVPN Client – Connect gateway to an OpenVPN server
Description | Establishes an encrypted VPN tunnel between the gateway and a remote OpenVPN server, enabling secure communication and remote management over public or private networks. |
Usage | Secure access over Ethernet/Wi‑Fi/LTE; HQ private network integration. |
Support | HW: All WisGateOS 2 gateways SW: WisGateOS 2 |
Operation & Maintenance – Scheduled reboot & LTE auto-recovery
Description | Provides scheduled gateway reboots and automatic LTE module restart when connectivity loss is detected, ensuring stable operation in remote or critical deployments. |
Usage | Maintain uptime in unstable cellular networks, reduce manual intervention at unmanned sites, and simplify post-deployment maintenance. |
Support | HW: LTE-compatible gateways RAK7268CV2, RAK7240CV2, RAK7289CV2, RAK7285C, RAK7266, RAK7267 SW: WisGateOS 2 v2.2.x or later |
Field Test Data Processor – Local signal analysis & coverage visualization
Description | Processes uplink data from RAK10701-Plus Field Tester via MQTT, computing RSSI, SNR, and packet loss locally. Supports CSV export, heatmap coverage visualization, and offline testing with manual location tags, with no cloud dependency. |
Usage | Pre-deployment surveys; indoor/outdoor optimization; GPS-denied testing; periodic coverage audits. |
Support | HW: WisGateOS 2 gateway + RAK10701-Plus Field Tester SW: WisGateOS 2 v2.2.x or later |
Failover Reboot – Auto-recover by rebooting LTE/gateway when all links fail
Description | Monitors LTE, Ethernet, and Wi-Fi links. If all enabled connections are offline, it first attempts recovery by rebooting the LTE module. If unsuccessful, the system reboots the gateway to restore connectivity. |
Usage | Multi-link networks requiring autonomous recovery; high-availability edge nodes; rooftop/remote sites where LTE reboot is the primary failover method. |
Support | HW: WisGateOS 2 gateways with multiple network interfaces (Ethernet/LTE/Wi-Fi) SW: WisGateOS 2 v2.2.x or later |
Wi‑Fi Reboot – Auto‑recover Wi‑Fi via ping/httping checks
Description | Periodically checks Wi-Fi connectivity and, if all tests fail, reboots the Wi-Fi module or the entire gateway to restore connection. |
Usage | Factories or campuses with AP roaming; indoor weak-signal floors; temporary hotspots or unstable Wi-Fi environments. |
Support | HW: All WisGateOS 2 gateways SW: WisGateOS 2 v2.2.x or later |
RF Spectrum Scanner – Real-time spectrum scan & channel analysis
Description | Scan defined bands and generate color-coded heatmaps of RSSI over time/frequency to detect interference, noisy channels, and spectrum patterns. |
Usage | Pre-deployment site surveys; urban interference diagnosis; optimize LoRa® channel plans; periodic RF audits. |
Support | HW: RAK7289V2 / RAK7289CV2 SW: WisGateOS 2 v2.2.x or later |
LoRa Packet Local Storage – Store & retain LoRa® packets as CSV
Description | Record and manage all uplink and downlink LoRa® packets with configurable retention periods. It provides a reliable local data source for network analysis, performance monitoring, and troubleshooting. |
Usage | Network analysis; performance monitoring; troubleshooting; compliance-ready audits. |
Support | HW: All WisGateOS 2 gateways SW: WisGateOS 2 v2.2.15 or later |