RAK

• Downloads
• Installation
  • RAK72XX
    • WisGateOS2 to Gateway OS
    • Gateway OS to WisGateOS2
  • RAK7391
• First usage

Note: These are custom firmware images that are not supported by RAK and might might void your warranty. Use at your own risk.

Downloads

Please use one of the download options below to download the latest (v4.5.2) ChirpStack Gateway OS image.

Installation

RAK72XX

WisGateOS2 to Gateway OS

This replaces the WisGateOS2 firmware of the gateway with the ChirpStack GatewayOS OS.

cd /tmp

# Download image
# Note: Replace this URL with the correct image URL from the Downloads!
wget https://artifacts.chirpstack.io/downloads/chirpstack-gateway-os/4.5.2/rak/ramips/mt76x8/chirpstack-gateway-os-4.5.2-rakXXXX-ramips-mt76x8-rakwireless_rak636-squashfs-sysupgrade.bin

# Flash image
# Note: Replace filename with the downloaded image!
sysupgrade -n chirpstack-gateway-os-4.5.2-rakXXXX-ramips-mt76x8-rakwireless_rak636-squashfs-sysupgrade.bin

To avoid conflicting configuration, you must use the -n flag. This will mean all data stored on the gateway will be erased.

Note: This will take a couple of minutes. During the process the gateway might disconnect. After rebooting, the gateway might have a different IP address. Do not power-cycle the gateway!

Gateway OS to WisGateOS2

This restores the WisGateOS2 firmware of a RAK gateway that previously has been flashed with a ChirpStack Gateway OS image. Note: this will not install the latest WisGateOS2 image version. Once you have restored the WisGateOS2 firmware you should upgrade your gateway to the latest WisGateOS2 image.

Set compat_version

You must set the compat_version parameter to 2.1.4, or else the upgrade will fail with:

The device is supported, but this image is incompatible for sysupgrade based on the image version (1.0->2.1.4)

To set this parameter, execute the following command:

uci set system.@system[0].compat_version='2.1.4'
uci commit

Download and flash

cd /tmp

# Download restore image
wget https://artifacts.chirpstack.io/downloads/chirpstack-gateway-os/rak/wisgateos-ramips-mt76x8-rakwireless_rak636-squashfs-sysupgrade.bin

# Flash restore image
sysupgrade -n wisgateos-ramips-mt76x8-rakwireless_rak636-squashfs-sysupgrade.bin

To avoid conflicting configuration, you must use the -n flag. This will mean all data stored on the gateway will be erased.

Note: This will take a couple of minutes. During the process the gateway might disconnect. After rebooting, the gateway might have a different IP address. Do not power-cycle the gateway!

Upgrading to latest WisGateOS2

Once the WisGateOS2 image is restored, you should see the WisGateOS2 web-interface which will guide you through the gateway configuration. Once setup, you should update the firmware to the latest WisGateOS2 version! You can download the latest WisGateOS2 firmware image from the RAK Download Center.

RAK7391

For instructions on how to flash an image to the Compute Module 4, please refer to Flash an image to a Compute Module.

First usage

After flashing the ChirpStack Gateway OS image, follow the Getting started documentation to setup your gateway.