...
- 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.
- 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 |
|---|
|
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 |
|---|
|
# 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 |