Flash / backup the OS
By default, each Unipi Gate device comes with a Linux Debian-based OS that contains pre-installed Node-RED software. The OS can be reflashed to install any supported software.
Gate
- Download the ZIP archive with OS image and extract it into a new folder in your PC
Flashing the OS using the service interface
To upload OS into the Unipi Gate through its service interface, you need to access the service mode first. To enable it, follow instructions in this article.
- Enter the device's IP address into a web browser. Upon confirmation, you will be connected to the Unipi Gate service interface
- In the service interface, drag and drop the archive.swu file extracted from the OS image archive into the Software update dialogue window
- The flashing process is indicated by rapid blinking of ACT, TX and RX diodes (demonstration here)
- Wait until the device finishes the process. Its progress can be monitored in a dialogue window under the Messages label
- Finishing the process is indicated by diodes going off and a reboot of the device
Flashing the OS using a USB flashdisk
- Prepare a USB flash disk in FAT32 format with a capacity of at least 2 GB
- Copy the content of the ZIP archive onto the flash disk
- Unplug the power supply from the device and insert the flash disk into the device's USB port
- Press and hold the SERVICE button on the device's face side
- Plug the power supply back. Unipi Gate will automatically start the OS flashing process indicated by rapid blinking of ACT, TX and RX diodes (demonstration here)
- You can now release the SERVICE button
- Finishing the process is indicated by diodes going off and a reboot of the device
If the USB flash disk is not compatible, Unipi Gate will not start the OS flashing and reboots. In that case, you need to use a different flash disk or the above-mentioned flashing through the service interface.
Creating a OS back-up on a USB flashdisk
- Prepare a USB flash disk in FAT32 format with a capacity of at least 2 GB
- Start the device in the service mode
- Insert the flash disk and wait for approximately 5 seconds
- In the service interface, click on the Backup to USB flash button located in the Backup dialogue window
- Unipi Gate will start creating the OS backup - the process is indicated by rapid blinking of ACT, TX and RX diodes (demonstration here)
- Upon finishing the process, a “Updated successfully” prompt will be displayed in the service display and blinking of the LEDs will slow down (demonstration here)
- You can now reboot the device using a button on the upper right corner of the web interface
- For loading the backup or uploading the OS into a different device of the same product line, follow the guide below
If the USB flash disk is not compatible, Unipi Gate will not start the backup process. In that case, you need to use a different flash disk.
If you are creating a backup on a device with a lower FID than the one you will flash the backup OS to (e.g. FID 1.1 → FID 2.0), always update the following packages first: g1-kernel-image
, g1-u-boot
, g1-altboot
Update by the following commands:
sudo apt update sudo apt install g1-kernel-image g1-u-boot g1-altboot
For a Debian 12 based OS you need to update these packages: unipi-kernel
, unipi-u-boot
, unipi-altboot
sudo apt update sudo apt install unipi-kernel unipi-u-boot unipi-altboot
Restore the OS from back-up on the USB flashdisk
- Unplug the power supply from the device and insert the flash disk into the device's USB port
- Press and hold the SERVICE button on the device's face side
- Plug the power supply back. Unipi Gate will automatically start the OS flashing process indicated by rapid blinking of ACT, TX and RX diodes (demonstration here)
- You can now release the SERVICE button
- Finishing the process is indicated by diodes going off and a reboot of the device