Versions Compared

Key

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

...

  • Client end Configurations and verification (in BPI)
    Verify the CLOUDURL URL in /etc/include.properties File
    CLOUDURL="https://xconf.rdkcentral.com/xconf/swu/stb?eStbMac="
    Code Block
    root@Filogic-GW:~# cat /etc/include.properties   
    LOG_PATH=/rdklogs/logs
    CRON_SPOOL=/var/spool/cron/crontabs
    CRON_FIFO_FILE=/etc/cron.d/FIFO
    PERSISTENT_PATH=/nvram
    RAMDISK_PATH=/tmp
    TEMP_LOG_PATH=/var/logs
    UTILITY_PATH=/lib/rdk
    RDK_PATH=/lib/rdk
    EROUTER_INTERFACE=erouter0
    TELEMETRY_JSON_RESPONSE=/nvram/rtl_json.txt
    
    CLOUDURL="https://xconf.rdkcentral.com/xconf/swu/stb?eStbMac="
  • Verify the contents of /etc/dcm.properties
    Code Block
    root@Filogic-GW:~# cat /etc/dcm.properties 
    LOG_SERVER=xconf.rdkcentral.com
    DCM_LOG_SERVER=https://xconf.rdkcentral.com/xconf/logupload.php
    DCM_LOG_SERVER_URL=https://xconf.rdkcentral.com/loguploader/getSettings
    DCM_SCP_SERVER=xconf.rdkcentral.com
    HTTP_UPLOAD_LINK=https://xconf.rdkcentral.com/xconf/telemetry_upload.php
    DCA_UPLOAD_URL=xconf.rdkcentral.com
    
    DCM_HTTP_SERVER_URL=https://xconf.rdkcentral.com/xconf/telemetry_upload.php
    DCM_LA_SERVER_URL=https://xconf.rdkcentral.com/xconf/logupload.php
  • Check the current image version using  “cat /version.txt”
    Code Block
    root@Filogic-GW:~# cat /version.txt 
    imagename:rdkb-generic-broadband-image_rdk-next_20251204071936
    BRANCH=rdk-next
    YOCTO_VERSION=kirkstone
    VERSION=6.1.12.04.25
    SPIN=0
    BUILD_TIME="2025-12-04 07:19:36"
    JENKINS_JOB=Default
    JENKINS_BUILD_NUMBER=0
    Generated on Thu Dec 04  07:19:36 UTC 2025
  • Verify if Firmware job is available using the command "crontab -l | grep fwupgrade" as shown below
    Code Block
    root@Filogic-GW:~# crontab -l | grep fwupgrade
    */15 * * * * /usr/bin/fwupgrade >> /var/log/fwupgrade_cron.log 2>&1
  • Automatically the Firmware upgrade job will be triggered every 15mins of current system time.
  • Once the Firmware Upgrade job is started, verify the log file - /var/log/fwupgrade.log
    Code Block
    cat /var/log/fwupgrade_cron.log
    cloudFWFile     : rdkb-generic-broadband-image_rdk-next_20251103090407.bin.wic.bz2
    cloudFWLocation : 192.168.0.7
    cloudFWVersion  : rdkb-generic-broadband-image_rdk-next_20251103090407.bin.wic.bz2.txt
    cloudProto      : http
    Active root partition: /dev/mmcblk0p4
    downloading image using curl -fgLo /tmp/rdkb-generic-broadband-image_rdk-next_20251103090407.bin.wic.bz2.txt  http://192.168.0.7/rdkb-generic-broadband-image_rdk-next_20251103090407.bin.wic.bz2.txt  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                     Dload  Upload   Total   Spent    Left  Speed
    100    99  100    99    0     0  42471      0 --:--:-- --:--:-- --:--:-- 49500
    Xconf-server Version: rdkb-generic-broadband-image_rdk-next_20251103090407
    Current Partition Version: rdkb-generic-broadband-image_rdk-next_20251103110434
    Passive Partition device: /dev/mmcblk0p8
    Mount successful and version.txt found at /mnt/passiveroot/version.txt
    Passive Partition Version: rdkb-generic-broadband-image_rdk-next_20251103110434
    Passive partition does not contain version.txt yet.
    Neither active nor passive have the required version. Proceeding with upgrade...
    Opened /tmp/xconf_flag for writing
    Successfully wrote to /tmp/xconf_flag
    the value of Xconf upgarde flag  is 1CR component name is: eRT.com.cisco.spvtg.ccsp.CR
    subsystem_prefix eRT.
    Execution succeed.CR component name is: eRT.com.cisco.spvtg.ccsp.CR
    subsystem_prefix eRT.
    Execution succeed.CR component name is: eRT.com.cisco.spvtg.ccsp.CR
    subsystem_prefix eRT.
    Execution succeed.CR component name is: eRT.com.cisco.spvtg.ccsp.CR
    subsystem_prefix eRT.
    Execution succeed.[INFO] Firmware upgrade is in progress.....
  • Verify the tftp/http download is happening by noticing the change of file size using below command:
    ls /mnt/bootpart/ -sh  (use this command frequently to verify the file size change)
    Code Block
    root@Filogic-GW:~# ls /mnt/bootpart/ -sh
    total 203M
     16K lost+found  203M rdkb-generic-broadband-image_rdk-next_20250916120622.bin.wic.bz2
    root@Filogic-GW:~# ls /mnt/bootpart/ -sh
    total 205M
     16K lost+found  205M rdkb-generic-broadband-image_rdk-next_20250916120622.bin.wic.bz2
    root@Filogic-GW:~# ls /mnt/bootpart/ -sh
    total 207M
     16K lost+found  207M rdkb-generic-broadband-image_rdk-next_20250916120622.bin.wic.bz2
    root@Filogic-GW:~# ls /mnt/bootpart/ -sh
    total 209M
  • Once image download completed, the BPI board will auto reboot and come up with downloaded image.code
  • Once the board comes up, check the image loaded in the box using “cat /version.txt” command .It will be upgraded with the image from xconf-server.
    Code Block
    root@Filogic-GW:~# cat /version.txt 
    imagename:rdkb-generic-broadband-image_rdk-next_20250916120622
    BRANCH=rdk-next
    YOCTO_VERSION=kirkstone
    VERSION=6.1.09.16.25
    SPIN=0
    BUILD_TIME="2025-09-16 12:06:22"
    JENKINS_JOB=Default
    JENKINS_BUILD_NUMBER=0
    Generated on Tue Sep 16  12:06:22 UTC 2025

...

Code Block
root@Filogic-GW:~# /usr/bin/fwupgrade recover
[INFO] Running recovery process...
recovering base image has startedbl2 and fip 2 are ready to swapping
All done. Rebooting...
Connection to 192.168.2.15 closed by remote host.
Connection to 192.168.2.15 closed.
chtsl00601@chtsl00601-Latitude-3420:~$

Direct Firmware Upgrade using dmcli (Quick Testing)

For development, debugging, or quick validation purposes, firmware upgrades can be triggered directly on the device using the dmcli command without relying on the XConf server.

Code Block
titledmcli Commands
dmcli eRT setv Device.DeviceInfo.X_RDKCENTRAL-COM_FirmwareDownloadProtocol string <PROTOCOL>
dmcli eRT setv Device.DeviceInfo.X_RDKCENTRAL-COM_FirmwareDownloadURL string <server_IP:Port_num>
dmcli eRT setv Device.DeviceInfo.X_RDKCENTRAL-COM_FirmwareToDownload string <Image_name>
dmcli eRT setv Device.DeviceInfo.X_RDKCENTRAL-COM_FirmwareDownloadAndFactoryReset int 1

Example:

Code Block
titleExample
# Using HTTP server.
dmcli eRT setv Device.DeviceInfo.X_RDKCENTRAL-COM_FirmwareDownloadProtocol string HTTP
dmcli eRT setv Device.DeviceInfo.X_RDKCENTRAL-COM_FirmwareDownloadURL string http://192.168.2.122:8080
dmcli eRT setv Device.DeviceInfo.X_RDKCENTRAL-COM_FirmwareToDownload string rdkb-generic-broadband-image_rdk-next_20250904115114.bin.wic.bz2
dmcli eRT setv Device.DeviceInfo.X_RDKCENTRAL-COM_FirmwareDownloadAndFactoryReset int 1

# Using TFTP server.
dmcli eRT setv Device.DeviceInfo.X_RDKCENTRAL-COM_FirmwareDownloadProtocol string TFTP
dmcli eRT setv Device.DeviceInfo.X_RDKCENTRAL-COM_FirmwareDownloadURL string tftp://192.168.2.246:69
dmcli eRT setv Device.DeviceInfo.X_RDKCENTRAL-COM_FirmwareToDownload string aug_04.wic.bz2
dmcli eRT setv Device.DeviceInfo.X_RDKCENTRAL-COM_FirmwareDownloadAndFactoryReset int 1