Skip to content

Upgrading Router Firmware

This guide shows you how to upgrade the firmware on your GL.iNet router hubs.

Prerequisites

  • Latest version of wavectl installed
  • Physical or network access to router hubs
  • Site numbers for each router hub
  • Firmware files provided by Blackfire Technology

Process Overview

  1. Update wavectl to the latest version (if not already done)
  2. Flash routers with the latest firmware
  3. Reconfigure each hub using wavectl configure-hub

Step-by-Step Guide

1. Update wavectl

Ensure you have the latest version of wavectl installed on your local machine

2. Flash Router Firmware

For each GL.iNet Node and Control Hub:

  1. Access the router's UBOOT web interface
  2. Upload the latest respective firmware file provided by Blackfire Technology
  3. Initiate the upgrade and wait for the router to reboot

Firmware Compatibility

Only use firmware files provided or approved by Blackfire Technology. Using incompatible firmware may cause router malfunction.

3. Reconfigure Each Hub

From your local machine (in the deployment directory), reconfigure each router hub:

# For each site, run:
wavectl configure-hub --site <site-number>

Router Upgrade Tips

  • Upgrade one router at a time
  • Schedule during maintenance windows
  • Keep firmware files organised
  • Document which sites have been upgraded
  • Test connectivity

Troubleshooting

Router Won't Boot After Firmware Flash

If the router fails to boot after flashing:

  1. Power cycle the router (unplug for 30 seconds, then plug back in)
  2. Wait 2-3 minutes for full boot
  3. Try accessing the web interface again
  4. If still unresponsive, contact Blackfire Technology support

Firmware Version Compatibility

Version Requirements

Always check the Waveshift release notes for firmware compatibility requirements. Some Waveshift server versions may require specific minimum firmware versions on router hubs.