UISP Devices - Recovery Mode
The following instructions are provided to restore a UISP device to its default state in the unlikely event it becomes unresponsive. This process is irreversible and may not be appropriate for initial troubleshooting.
Recovering Devices with a Reset to Factory Default
Once the device is plugged in, press and hold the Reset button until the device's port LEDs light up sequentially, starting with the first port and ending with the fifth one. At this moment, the device is reset to its factory settings.
Recovering Devices with a Third-Party TFTP Client
The TFTP Recovery feature is initiated by pressing an unresponsive device’s Reset button and using a TFTP client at a workstation. Pressing the Reset button will trigger the device’s TFTP Recovery Mode, which runs a TFTP server on the device. Afterward, the recovery image can be retrieved from the TFTP client.
The UISP recovery images used for TFTP Recovery can be downloaded below.
UISP Recovery Images
Public Release:
UISP-Console recovery image - 5.3.1
UISP-R-Pro Recovery image - 5.3.1
UISP-S-Pro recovery image - 1.5.0
UISP-P recovery image - 1.0.0-beta.5
Note: This process assumes that a TFTP client is already set up at a workstation to allow the recovery image to be uploaded to an unresponsive UISP device.
- Download the appropriate device recovery file linked above.
- Connect Port 1 of the UISP device to a desktop or LAN using an Ethernet cable. Assign a static IP address to the computer's network interface (e.g., 192.168.1.10/24).
- Press and hold the Reset button on the device after plugging it in. The port LEDs will light sequentially from the first to the fifth port. Continue holding the button until this sequence completes two rounds. The LEDs will then blink three times, indicating entry into TFTP Recovery Mode.
- Wait until the LEDs alternate in a zig-zag pattern between even and odd ports. This indicates the device is assigned the static IP address 192.168.1.20/24 and is ready to accept the recovery file
- Use a TFTP client application to upload the recovery image to the device.
- Wait for the TFTP recovery process to complete. The device will reboot, with LED lights flashing White/Off in 0.5-second intervals.
- Allow the reboot to finish. At this point, most UISP devices are ready for re-adoption in the UISP application. There is an additional step for UISP consoles.
- For UISP Console device only: Access the device via a browser at http://192.168.1.20. Use the web form to apply the latest firmware (found on the community forums). After the firmware is updated, the device will reboot, completing the recovery process.
Windows Clients
In this example, our TFTP client is Tftpd32 with the following settings:
Host: 192.168.1.20
Port: 69
Local File: <image-path>.bin
Remote File: <blank>
Block Size: Default
Linux and macOS Clients
Open a new Terminal window and use the following TFTP client commands:
tftp
tftp> connect 192.168.1.20
tftp> binary
tftp> put <image-name>.bin
or in one line:
tftp 192.168.1.20 -m binary -c put <image-name>.bin