Introduction

Firmware upgrade through system plugin

The firmware upgrade can be achieved through the RDK4 System plugin as well as using the systemd service.

User Initiated FW upgrade is handled by org.rdk.System Plugin through ‘updateFirmware’ method. System plugin will invoke ‘deviceInitiatedFWDnld.sh’  script to communicate with Xconf server and fetch firmware information. Image download will be initiated by ‘deviceInitiatedFWDnld.sh’. Once download is completed then a device specific script will be executed. The device specific script can have implementation specific to the platform and will invoke the Flash Utility after verifying integrity of the firmware.

Image Modified

Use case

Usecase description

• Admin: Responsible for configuring the XConf firmware control rules specific to the model and upload the stable release firmware image to the file server.
• File Server: It hosts the firmware upgrade package. Could be supporting various protocols (HTTP,HTTPS, FTP, SFTP, TFTP etc) but these are not coming under Xconf's scope. XConf provides a File Server to host the firmware upgrade package but it it does not mandate to use the same.
• XConf Server: When an STB queries for details about any available update, XConf shares the available details of firmware update package to STB after matching against its configured rules for that STB make & model.
• STB: This could be any RDKV flavor (IP/Hybrid STB, TV Platforms etc).  

...

How to prepare XConf Server

...

The cloud URL should be set in the file /etc/include.properties (In RPI images, this configuration is enough)

CLOUDURL=https://xconf.rdkcentral.com:9092/xconf/swu/stb?eStbMac= 

• Activate the System Service Plugin in the Controller UI or execute the below command: 

...