Versions Compared

Key

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

...

TR-181 Data Model Parameters 


S.NODMValueDescription
1Device.DeviceInfo.X_RDKCENTRAL-COM_FirmwareDownloadURLhttp://192.168.0.8 Value should be local/public http server url
2Device.DeviceInfo.X_RDKCENTRAL-COM_FirmwareDownloadProtocolhttpValue should be auto-generated based on above parameter Input
3Device.DeviceInfo.X_RDKCENTRAL-COM_FirmwareToDownloadrdkb-generic-broadband-image_rdk-next_20210525055548.rootfs.wicValue should be Firmware Image Name .

Note: This API does not reboot the device.

4Device.DeviceInfo.X_RDKCENTRAL-COM_FirmwareDownloadStatusCompletedReturns the current state of the Firmware Download operation.
5Device.DeviceInfo.X_RDKCENTRAL-COM_FirmwareDownloadNowTrue 

Downloads and upgrades the firmware. The firmware is updated in the passive bank and marks it as active.

Reboots the device and the device boots up with the active bank and updated firmware.


Flashing the image


Info
titlesd-card size requisite

It is must to have minimal size of 8GB SD-Card for Firmware upgrade support

...

Generated image has to be flashed to an SD card using this command in local PC:

$ sudo dd if=bzip2 -d <path to ImageName.wic.bz2>
$ sudo -E bmaptool copy --nobmap <path to ImageName.rpi-sdimg> of=wic> <path to SD card space> bs=4M


Ex:


$ bzip2 -d rdk-generic-broadband-image-raspberrypi-rdk-broadband.wic.bz2
$ sudo

dd if=

-E bmaptool copy --nobmap rdk-generic-broadband-image-raspberrypi-rdk-broadband.

rpi-sdimg of=

wic /dev/sdb

bs=4M


The SD card is inserted to the Raspberry Pi board and booted to check for containers created.

The Raspberry Pi board is connected to the PC via a USB to serial converter and the logs can be checked in console or can be connected via HDMI cable to a TV and logs will be shown in the terminal

Creating checksum file

It is necessary to flash the stable image during upgrade. So checksum file has to be created for the image to be uploaded using below command

Info
titlemd5sum checksum creation

md5sum "<imagefile_name>.rootfs.rpi-sdimg" > imagefile_name.txt

After checksum file is created, place this file in tftp location along with actual image file which is expected by firmware upgrade script. Without which firmware upgrade wont be allowed by scripts

Creating Multi-Boot compatible SD-CARD if RDKB is Flashed for first time

...

This resize can be achieved using gpartedui gparted ui tool which should be available in host pc

...

8. After applying close size increased to 2 GB can be seen

 

With selection of HTTP Protocol

Local Apache2 server set up

Server Set-up :

  1. Install  Install the apache2 http server in local pc Add the below line in /etc/hosts (192.168.0.107(wan IP) http://www.myfirmware.com)
  2.  place the rpi image and checksum files in document root directory.

RPI Target :

...

Note : Every reboot, You need to add the above three steps if it's local http server.

HTTP Location folder

Verify that

...

rpi image file  is present in the http folder

...

. Here , document root directory as "/var/www/html"

Code Block
languagebash
themeDJango
titleLocal Http server Document root path
collapsetrue
keerthana@keerthana-INVALID:/var/www/html$ pwd
/var/www/html
keerthana@keerthana

...

-INVALID:/var/www/html$ ls

...

 -lh rdkb-generic-broadband-image_

...

rdk-next_

...

20210813104338.rootfs.

...

wic
-rw-r--r-- 1 root root 316M Aug 13 17:29 rdkb-generic-broadband-image_

...

rdk-next_20210813104338.rootfs.wic
keerthana@keerthana-INVALID:/var/www/html$ 


RPi - Board

  1. Flash the RDKB image supported for Firmware upgrade feature in the Rpi and verify the 2 partitions(ex. mmcblk0p1, mmcblk0p2) present under dev folder (use command ls /dev)
  2. Device auto-reboots and verify there are 2 more additional partitions are created (ex. mmcblk0p3, mmcblk0p4).
  3. Open /etc/include.properties file and verify the CLOUDURL parameter where XConf Server URL is configured
  4. Verify the image version ( cat /version.txt) displays the flashed image version
  5. Open /rdklogs/logs/swupdate.log to verify the communication from RPI board with XConf Server and the download status
  6. Verify the tftp download is happening by noticing the change of file size using below command:cd /extblock/tftpimage/imagedwnldls -lh  (use this command frequently to verify the file size change) if tftp protocol was selected in XCONF UI
  7. Verify the http download is happening by noticing the change of file size using below command : cd /extblock/httpimage/imagedwnldls -lh(use this command frequently to verify the file size change)if http protocol was selected in XCONF UI
  8. Once image download completed, the Rpi board will auto reboot and come up with downloaded image
  9.  Verify the version of booted image which shows the downloaded image version

...