Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Test Setup Block Diagram 

Image RemovedImage Added

Firmware Upgrade validation Procedure

TFTP Server

...

STEP 1:

Install xinetd and tftpd-hpa application in your local PC to setup tftp server by using below command
TFTP Server Installation Step

sudo apt-get install xinetd
sudo apt-get install tftpd-hpa


STEP 2

...

Either TFTP/ HTTP server can be used to download the image, depends on the requirement.

Things to be done before checking for the server configurations:

STEP 1:

Create a .tar file and place the image files.

...

  • zImage--4.14.22-r0-turris-20200629035029.bin
  • rdkb-generic-broadband-image_default_20200629035029.rootfs.tar.gz
  • armada-385-turris-omnia.dtb

tar -cvf <imagefile_name>.tar <path-of-rdkb*.rootfs.tar.gz> <path-of-zImage*.bin> <path-of-armada*.dtb>

For Ex:
tar -cvf rdkb-generic-broadband-image_default_20200629035029.tar /home/kaviya/rdkb-generic-broadband-image_default_20200629035029.rootfs.tar.gz /home/kaviya/zImage--4.14.22-r0-turris-20200629035029.bin /home/kaviya/
armada-385-turris-omnia.dtb


STEP 23:

Create checksum file for the upgrading image.
md5sum checksum creation

md5sum "<imagefile_name>.tar" > imagefile_name.txt
 
For Ex:
md5sum "rdkb-generic-broadband-image_default_20200629035029.tar" > rdkb-generic-broadband-image_default_20200629035029.txt

TFTP Server Setup

STEP 1:

...

...

sudo apt-get install xinetd
sudo apt-get install tftpd-hpa

STEP 2:

Create new folder for example "tftp" in your PC home directory and place the checksum file and upgrading image file (the .tar file generated).

STEP 34:

Check for tftp file in /etc/xinetd.d/ directory. If not, then create tftp file under this /etc/xinetd.d/ directory and add below content.

...

service tftp
{
protocol        = udp
port            = 69
socket_type     = dgram
wait            = yes
user            = nobody
server          = /usr/sbin/in.tftpd
server_args     = -c -v -s /home/xyz/tftp ( upgrading file and checksum file  maintained in this directory )
disable         = no
}


STEP 45:

Verify /etc/default/tftpd-hpa file content

...

# /etc/default/tftpd-hpa
 
TFTP_USERNAME="tftp"
TFTP_DIRECTORY="/home/xyz/tftp" ( upgrading file and checksum file  maintained in this directory )
TFTP_ADDRESS="0.0.0.0:69"
TFTP_OPTIONS="--secure"


STEP 56:

Start tftp server and xinetd server

sudo service tftpd-hpa restart
/etc/init.d/xinetd restart

HTTP Server Setup

STEP 1:

Ensure the http server in running in the local PC. If not, then activate or install it (For Example, Lighttpd)

STEP 2:

Once the server is running, place the necessary files in the below path.

Path of the image file to be placed: /var/www/html

This directory should contain the image file and the checksum file:

...

For Ex:
rdkb-generic-broadband-image_default_20200629035029.tar

rdkb-generic-broadband-image_default_20200629035029.txt

XCONF Server Setup

XConf URL

http://35.155.171.121:9093/admin/ux

STEP 1:

Create Environment

Select  common → Environments. Then click edit and enter the device environment detail.

STEP 2:

Create Model

Select common → Models. Then add your device model detail.

STEP 3:

Create Mac List

Select common → MAC Lists. Then add your device MAC detail


STEP 4NOTE: Before configuring Firmware essentials, Ensure application type is stb. (If the application type is xhome then change it)

Create Firmware Config

Select Firmware → Firmware Configs. 

Give Description,File name ( Upgrading image name ),Version( Upgrading image name without extension) and select your model name and save the details in xconf server.

STEP 5:

Create Firmware Rules

Select Firmware → Firmware Rules

...

Select your firmware config under Action option and save your Firmware rule in XConf server.

STEP 5:


Edit Download Location Round Robin Filter

Select Firmware → Download Location Filter

After entered Download Location Round Robin filter, then edit your image downloading details.

FOR TFTP SERVER CONFIGURATION:

Enable Never use HTTP and select your Rongue Rogue model.

Give TFTP server running IP address to download image.

Image Removed

...

Image Added


Verify Xconf Server Configuration

Verify that XConf Server configuration displays the Json response from the mentioned URL:

http://<Xconf Server IP:port no.>35.155.171.121:9092//xconf/swu/stb?eStbMac=<MAC address><Turris MAC address>&model=<model_name>&capabilities=RCDL&capabilities=supportsFullHttpUrl

Example, http://35.155.171.121:9092//xconf/swu/stb?eStbMac=D8:58:D7:00:A6:B4&model=%3Cmodel_name%3E&capabilities=RCDL&capabilities=supportsFullHttpUrl

Turris-Omnia Board

U-boot-fw-Utils Configuration

...

1) Add the necessary firmware utilities in armada_38x_defconfig

...

Note: The U-boot Configuration is added to handle the uboot environment in linux. This is specifically to change the root value in bootargs ( to avoid the old rootfs in mmcblk0p5 and  load the downloaded rootfs that has been placed in the mmcblk0p7). And so, the new rootfs comes up while the reboot.

Firmware

...

upgrade 

1) Flash the image and confirm for the 7 partitions in the turris-omnia board(ex. mmcblk0p1, mmcblk0p2, mmcblk0p3, mmcblk0p4, mmcblk0p5, mmcblk0p6, mmcblk0p7)

...

6) Download the image in the /tmp folder(roots image, zImage, dtb file) and move the rootfs filesystem(rdk*.rootfs.tar.gz) into the 7th partition and kernel (zImage*.bin) image into 3rd partition

...

9) Verify the version of booted image which shows the downloaded image version

Conclusion

...

Please find the summary on firmware upgrade explained above

  • Build the Rdkb Turris Image
  • Flash the build image 
  • Setup xconf server ready with rules and download location, for Turris-Omnia device
  • Place the upgrading image and checksum file in tftp serverserver 
  • Boot the flashed image

Limitations

...

Yet to have https support

...

Image Download is verified only with TFTP server