...

• Select MAC Lists option within Common list to enter MAC Lists page.
• After entered MAC Lists page press create button to add your device MAC detail.
• Give Name and Data to set MAC detail for your device and save those details in XConf server.

User also has the option to choose multiple mac address from a file. User can use a browse button on the right side of the UI to select the files which holds the mac addresses. 

Note: All formats are not accepted here. each line holds only a single mac address

Eg: 
AA:AA:AA:AA:AA:AA
BB:BB:BB:BB:BB:BB

• Press the Add '+' button
• Then press save

Create IP Lists

• Select IP Lists option within Common list to enter IP Lists page.
• After entering IP Lists page press create button to add your device IP detail.
• Give Name and Data to set IP detail for your device and save those details in XConf server.

...

•  Go to Firmware -> Firmware Rules -> Define Properties -> Create
•  A page will be displayed with options to select the template. Select ‘DOWNLOAD_LOCATION_FILTER’ from the list
• In this 'firmware rule' page with type 'DOWNLOAD_LOCATION_FILTER', we can specify the firmwareDownloadProtocol and firmware location . This property will override the default value set from ‘Download Round Robin location filter’.
•  Add the firmwareDownloadProtocol and the local http/tfp location as the firmwareLocation in XConf server. (Make sure local server and STB are in same network)

By default, rebootImmediately flag will be false. If we need to perform reboot immediately after writing the image to other partition, User can configure REBOOT_IMMEDIATELY_FILTER

•  Go to Firmware -> Firmware Rules -> Define Properties -> Create
•  A page will be displayed with options to select the template. Select ‘REBOOT_IMMEDIATELY_FILTER’ from the list
• In this 'firmware rule' page with type 'REBOOT_IMMEDIATELY_FILTER', we can specify the 'rebootImmediately’ as true.

Image Added

Now we have everything configured in the XCONF server side. we can validate in the XConf Firmware test page to see the configurations set.

...

RDKUI provides the option to perform the firmware upgrade. User can go to Settings->Other Settings->Advanced Settings-> Device -> Firmware Update

Image Added

Select Check for Update

Image Removed

Validations 

Validation performed in two devices. Amlogic skyworth and Sercomm realtek. 

Amlogic skyworth

We need to follow the same steps as mentioned in the How to Prepare for XConf Server

To view the configurations set, we can use the Firmware Test page available as part of UI. 

Image Removed

You can specify any key value parameters here in this document Key value is used as "estbMac" and value as the <device mac address>

Image Removed

here download location filter is used. this is to configure for specifying local hfs server's ip and protocol

Image Removed

Initial screen

Image Removed

After clicking Check for Update the state will change to Downloading

Image Removed

...

Image Added

As this being the reference UI, Current implementation is using only the API calls not the Events of plugin and API is invoked only when a page transition is done. So we may need to go to the previous

...

Image Removed

Sercomm Realtek

screen's in order to see the transitions

• State indicates validation is completed

Image Added

• State indicates when preparing for reboot 

Image Added

STB will check for upgrade and downloads to the other partition and next time boots up with this image. If reboot immediately filter is set to true in the XConf server, STB will go for immediate reboot once the image write is successful in the other partition.

The configuration used in Sercomm Realtek can be found same as the firmware test page as below. Here one more filter is configured which is rebootfilter this has rebootImmediately set to true , in addition to the Download filter. 

Which means when user clicks for "Check for Update", downloaded this firmware information configured in the XConf server and boots up the image with that.  In the screenshot, you would be able to see the image initially loaded was sercom-generic-mediaclient-image_FBT_6.0.0-rc4_20231107155246 to sercom-generic-mediaclient-image_FBT_6.0.0-rc3_20231011085623

Image Removed

Initial screen

Image Removed

Image Removed

After clicking Check for Update the state will change to Downloading

Image Removed

...