RDK Resources
[*RDK Preferred*]
Code Management Facility
RDK Forums
[RDK Conferences]
RDK Support
Archives
Papers & Presentations Archive
Children Display |
---|
Table of Contents |
---|
The Firmware upgrade will upgrade higher or lower version of the current image in RPI target with the help of Xconf server and Local TFTP server.
This page dedicated to bringing up and validation of Firmware upgrade in R-Pi Zero.
Refer below link for RPI-0 Environment setupRDK-C Environment Setupand RPI-3 B+.
Refer below link to build camera image
Morty:
RDK-C Build Instruction for RPI-0
...
language | bash |
---|---|
title | Image Flash step |
...
RDK-C Build Instruction for RPI-3
Dunfell:
RDK-C rdk-next Yocto 3.1 dunfell build for Raspberrypi
STEP 1:
Install xinetd and tftpd-hpa application in your local PC to setup tftp server by using below command
...
Create checksum file for your upgrading image.
Dunfell:
Before creating checksum file, need to decompress the .wic.bz2 camera image with the below command
$ bzip2 -dk camera_image
Example:
$ bzip2 -dk rdk-generic-camera-image_default_20201125081842.rootfs.wic.bz2
After decompression, we may get "rdk-generic-camera-image_default_20201125081842.rootfs.wic" this image.use this image to create checksum file and firmware upgrade.
Code Block | ||||
---|---|---|---|---|
| ||||
Morty: md5sum "<imagefile_name>.rootfs.rpi-sdimg" > imagefile_name.txt for Ex: upgrading image file is rdk-generic-camera-image_default_20200329074421.rootfs.rpi-sdimg md5sum "rdk-generic-camera-image_default_20200329074421.rootfs.rpi-sdimg" > rdk-generic-camera-image_default_20200329074421.txt Dunfell: md5sum "<imagefile_name>.rootfs.wic" > imagefile_name.txt for Ex: upgrading image file is rdk-generic-camera-image_default_20201125081842.rootfs.wic md5sum "rdk-generic-camera-image_default_20201125081842.rootfs.wic" > rdk-generic-camera-image_default_20201125081842.tx |
STEP 3:
Create new folder for example "tfphome" in your PC home direcotry to maintain checksum file and upgrading image file.
Keep upgrading image file and checksum file in your created folder.
For Ex:
Morty:
Keep rdk-generic-camera-image_default_20200329074421.rootfs.rpi-sdimg and rdk-generic-camera-image_default_20200329074421.txt files in your tftphome folder.
Dunfell:
Keep rdk-generic-camera-image_default_20201125081842.rootfs.wic and rdk-generic-camera-image_default_20201125081842.txt files in your tftphome folder.
STEP 4:
Check tftp file is there or not in /etc/xinetd.d/ directory. if it is not there then create tftp file under this /etc/xinetd.d/ direcotry and add below content.
...
Code Block | ||
---|---|---|
| ||
sudo service tftpd-hpa restart sudo /etc/init.d/xinetd restart |
Enter XConf server wiki page with below URL to create Environment,Model,Mac list,Firmware config,Firmware rule and Download Location Round Robin Filter.
Code Block | ||||
---|---|---|---|---|
| ||||
http://35.155.171.121:9093/admin/ux |
STEP 1:
Select Environments option within common list to enter Environments page.
...
Give ID and Description to setup Environment for your device and save that details in xconf server..
STEP 1:
Select Models option within common list to enter Models page.
...
Give ID and Description to setup Model for your device and save that details in xconf server..
STEP 1:
Select MAC Lists option within common list to enter MAC Lists page.
...
Give Name and Data to set MAC detail for your device and save that details in xconf server..
Ensure application type is stb. If the application type is xhome then change application into stb.
...
Give Description,File name ( Upgrading image name ),Version( Upgrading image name without .rootfs.rpi.sdimg) and select your model name and save the details in xconf server.
STEP 1:
Select Firmware Rule option within common list to enter Firmware Rule page.
...
Select your firmware config under Action option and save your Firmware rule in XConf server.
Server Set-up :
XCONF side :
1.Select Download Location filter under the firmware tab in XCONF UI
2.click the edit button
3.Enter the "Location (FQDN)" field is local/Public http server (fully qualified domain name ) (ex : www.myfirmware.com)
4.Enter the "Location (full URL)" field is full location path of local/Public http server (ex : http://www.myfirmware.com)
5.Unclick the check box of Never use HTTP
6. Removed the model name from Rogue Models.
7.Removed the firmware version (If it's not updated earlier, please ignore this step).
8. click the save button.
RPI Target :
9.In DUT, please edit the following file with below format,If it's local http server
i) Open the /etc/hosts
ii) Add your local http server ip with DNS ( Ex : 192.168.0.128 www.myfirmware.com)
iii) Save the file.
Note : Every reboot, You need to add the above three steps if it's local http server.
Verify that XConf Server configuration displays the Json response from the mentioned URL:
Using the below url to view the JSON Format result of http protocol ,
http://35.155.171.121:9092//xconf/swu/stb?eStbMac=<RPI MAC ADDRESS>&model=<model_name>&capabilities=RCDL&capabilities=supportsFullHttpUrl
Verify that image file and its respective md5 checksum file is present in the http folder:
ltts40009681@CHTSL20070:/var/www/html$ ls
rdk-generic-camera-image_default_20210107140802.rootfs.wic.bz2
rdk-generic-camera-image_default_20210107140802.txt
STEP 1:
Select Download Location Filter option within common list to enter Download Location Filter page.
...
Enable Never use HTTP and select your Rongue Rogue model.
Give TFTP server running IP address to download image.
Verify that XConf Server configuration displays the Json response from the mentioned URL:
...
Please find the summary on firmware upgrade explained above
...
1. RPI will go for reboot while booting for the first time, since two more partition needs to be created which requires reboot. Depends on the image present in xconf and RPI, further reboot will happen for upgrade. Please refer to design (Firmware Upgrade Support in R-Pi - RDK Camera - Design - M5 - 2020) for how firmware upgrade works with bank switching
...
RPI will support only tftp protocol . No http protocol support is provided yet.