WisGateOS 2 User Manual
Before using WisGateOS 2, ensure that your gateway has been physically installed and connected to a power source. Follow the setup instructions in the user manual for installation, powering on, and logging in to the Web UI.
Overview of WisGateOS 2
This document provides a detailed overview of WisGateOS 2, an operating system built on OpenWrt and designed to run on all RAK WisGate Edge V2 gateways. It covers general information, configuration guides, and detailed instructions for setting up the gateway.
Some sections may apply only to specific models due to differences in functionality. WisGateOS 2 enables efficient management of LoRaWAN networks and offers flexible features for IoT applications.
Supported WisGate Gateway Models
The following table lists the WisGate Gateway models supported by WisGateOS 2:
| Product | Model |
|---|---|
| WisGate Edge Lite 2 | RAK7268V2 / RAK7268CV2 |
| WisGate Edge Pro V2 | RAK7289V2 / RAK7289CV2 |
| WisGate Edge Prime V2 | RAK7240V2 / RAK7240CV2 |
| WisGate Edge Ultra | RAK7285 / RAK7285C |
| WisGate Soho Pro | RAK7267 |
| WisGate Soho Lite | RAK7266 |
WisGateOS 2 is compatible only with V2 hardware models. V1 models are not supported due to hardware differences.
Supported Features
The table below outlines the full feature set supported by WisGateOS 2, including core functionalities and optional features available via the Extension System. These features enhance the gateway’s connectivity, network management, and integration capabilities for various LoRaWAN applications.
| Feature | Description |
|---|---|
| Built-in Network Server (LNS) | Local LoRaWAN network management with device activation, application routing, and data forwarding. This refers to the RAK gateway's integrated network server. |
| Packet Forwarder | Legacy Semtech packet forwarder mode that transmits LoRa packets via UDP to a LoRa Network Server. |
| Basics Station | A modern packet forwarder using WebSocket (CUPS/LNS) to connect to LNS or CUPS. |
| Gateway Backend | Used in multi-gateway setups where the built-in network server acts as the Central Gateway. Forwards LoRa packets from extender gateways in the same LAN to the internal LNS for centralized processing. |
| MQTT Integrations | Enables MQTT client integration for forwarding uplink data to an external MQTT broker and receiving downlink commands from subscribed topics. |
| HTTP Integrations | Allows each application to forward uplinks and event notifications to external HTTP/HTTPS endpoints via POST requests. |
| Multi-WAN Support | Configure multiple WAN interfaces (Ethernet, LTE, Wi-Fi) with backup and failover. |
| WisDM Integration | Enables remote management, monitoring, and upgrades via the WisDM cloud platform. |
| OpenWrt Security Enhancements | Built on OpenWrt with regular security patches and system-level hardening. |
| Secure Activation from WisDM | Secure remote onboarding and provisioning via WisDM. |
| Extensions | Supports installation and management of modular extensions such as OpenVPN, WireGuard, Failover, Country Code Setting, and more. |
| Fake GPS (Manual Location) | Set GPS coordinates manually when GPS signal is unavailable. |
| Country Code Setting | Select country-specific presets for regulatory compliance. |
| Set Private Channel | Manually configure a private LoRa channel for dedicated communication. |
| Auto Device Registration | Automatically registers unknown LoRa nodes when an uplink is received. |
| 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 upon reconnection to ensure no data is lost. The messages are sent in blocks of 8 (FIFO) until the buffer is fully cleared. |
| Batch Device Registration | Import and register multiple devices at once. |
| Advanced Packet Filtering | Create rules to control which LoRa packets are forwarded to the network server. |
| Fine Timestamp | Provides high-precision timestamps for advanced location and network analytics. |
| Remote Syslog Support | Send system logs to a centralized syslog server for analysis and debugging. |
| Log Rotation | Automatically rotates log files to prevent storage overflow and improve manageability. |
| Encrypted Backup | Create and download encrypted backups of system settings and configuration for secure recovery. |
| Firmware OTA Upgrades | Supports firmware upgrades via local file upload or remote OTA updates. |
| LBT (Listen Before Talk) | Comply with spectrum regulations by checking channel availability before transmission. 💡 NOTE LBT is available on certain gateway models depending on specific hardware functionality. |
What's New in WisGateOS 2?
Stay informed about the latest improvements, feature additions, and fixes introduced in each version of WisGateOS 2. You can explore detailed release notes to track changes across versions.
Want to receive updates directly in your inbox? Subscribe to our product update mailing list to be notified about the latest WisGateOS 2 releases.
