Turris Omnia 2019 & Turris Omnia 2020: Flashing Instruction (Drafting)

Hardware Information

Wi-Fi Extender Reference Target

Requirements

Two files are required to bring up Newer model of Turris Omnia (Turris Omnia 2019 & Turris Omnia 2020)[Revision: CZ11NIC23]

• Omnia Medkit image

omnia-medkit-openwrt-mvebu-cortexa9-cznic_turris-omnia-initramfs_autoupgrade.tar.gz

• WIC gzip image(Example: rdkb-generic-broadband-image_default_20200809095738.rootfs.wic.gz) coming out of build Turris Omnia RDKB Gateway: Yocto Build Instructions

Extract *.wic.gz image and rename to sysupgrade.wic

manigandan@manigandan-Latitude-3400:~$ gunzip rdkb-generic-broadband-image_default_20200809095738.rootfs.wic.gz
manigandan@manigandan-Latitude-3400:~$ mv rdkb-generic-broadband-image_default_20200809095738.rootfs.wic sysupgrade.img

Flashing RDKB image (A Yocto Project based Distro)

Perform following steps to flash New Turris Omnia with RDKB image.

• Connect a USB flash drive to PC that is running Linux. Create a partition in flash drive and format the partition with mkfs.ext2
• Copy both attached medkit image and sysupgrade.img image to USB flash drive.
• Disconnect other USB devices from the Turris Omnia and connect the flash drive to either USB port.

• Hold down the reset button (backside, bottom centre) and plug in the power cord. Wait until the fourth LED lights up (green), then release (before the 5th LED lights up). _{Please check here to see more detail on rescue modes.}

• Wait approximately 2 minutes for the Turris Omnia to flash itself with the temporary image, during which LEDs will change multiple times.

During 4-led upgrade procedure, following things are done:

1. Power on Turris Omnia perform 4-led upgrade with usb plugged in, containing the new medkit and the sysupgrade image.
2. Rescue image in Turris Omnia will find and install the medkit image on mmc flash and reboot.
3. Since the medkit image now has a boot.scr in bootfs, u-boot 2019 uses this to boot into the medkit image automatically.
4. The medkit's startup script mounts the usb device and performs a sysupgrade using the wic image(RDK image).
5. The wic image is flashed to mmc and the system reboots.
6. The new bootfs also contains a boot.scr. U-boot again uses this to boot RDKB image into the board. Now, RDK-B boots.

RDK Firmware(Image) upgrade:

Approach 1:

RDK firmware upgrade with XConf server: Firmware upgrade through XCONF server - Turris-Omnia - User Manual - 2020 - M6

Approach 2(Quick):

Copy zImage and rootfs files from PC to /tmp/ directory of Turris Omnia which is running RDK Image

For example

In Turris Omnia, execute /lib/rdk/TurrisFwUpgrade.sh  to flash new RDK image present in /tmp folder

Turris Omnia will now run upgraded version of Yocto based RDK image.