...

User can configure firmware rules, configurations, Telemetry settings, RFC settings etc in the admin UI. While  dataservice, currently tells the XConf version information - Which version is used, when was it updated lastly and the commit informations etc.

Configure the device in XConf Server

In order to configure the device information user needs to login to XConf admin UI . For getting the access details, refer this page XConf Reference Setup Credentials and fill the information in admin UI and press login button.

...

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

...

As our requirement is to perform firmware upgrade, User need to configure the information  like which Firmware version, From where to download the image and how(protocol) to download.

There are 3 significant steps involved in the XConf firmware upgrade configuration:

1. Firmware Config – The firmware details will can be configured here.

    Where : Go to Firmware - > Firmware Configs -> Create.

    How : Add your firmware details - File name ( Upgrading image name ), Version( Upgrading image version) and select your model name and save the details in XConf server.

Create Firmware Config

Before configuring Firmware essentials, Ensure application type is stb.

• • Select Firmware Config option within Firmware list to enter Firmware Configs page.
  • After entered Firmware Configs page press create button to add your device firmware configuration detail.
  • Give Description, File name ( Upgrading image name ), Version( Upgrading image name) and select your model name and save the details in XConf server.

Image Added

2. Firmware rule – Rule is to map your device to the configuration created.

    Where : Go to Firmware -> FirmwareRule - > Create.

     How  How : Select one of the default template like MAC_RULE.

...

select the firmware config from the drop down list to map it with the rule

3. Download Location Filter – Here we can specify the download location URL and it’s protocol.

Where : Go to Firmware-> Download Location Filter -> Edit.

How : An Http location will be returned by default for all the devices. Enter FQDN and Full URL of the location.

The configuration will be available through below XConf data service API: https://XConf.rdkcentral.com:9092/XConf/swu/stb/ 

Create Firmware Config

Before configuring Firmware essentials, Ensure application type is stb.

• Select Firmware Configs option within common list to enter Firmware Configs page.
• After entered Firmware Configs page press create button to add your device firmware configuration detail.
• Give Description, File name ( Upgrading image name ), Version( Upgrading image name) and select your model name and save the details in XConf server.

Image Removed

Create Firmware Rules

Create Firmware Rules

• • Select Firmware Rules option within Firmware
Select Firmware Rule option within common
• • list to enter Firmware Rule page.
  • After entered Firmware Rule page press create button to add your device firmware Rule detail.
  • After entered firmware Rule page you can see list of default templates(ENV_MODEL_RULE, IP_RULE, MAC_RULE etc.)
    Note: If we need to create new custom template, go to Firmware → Firmware templates. Enter the ID name. Select priority from the 'Priority' drop down menu. Add conditions. Once saved select the new template to create firmware rule
  • Choose MAC_RULE(any required template) in this list of Template to add your device MAC list in Firmware Configuration.
  • After we select the required template, 'Add firmware Rule' page will be displayed. Here the build conditions will be present from the 'template' that we added and in addition to that we can add additional Build Conditions also.
  • Add your device specific eStbMac under build condition option.
  • Select your firmware config under Action option and save your Firmware rule in XConf server.

Image Modified

...

3. Download Location

...

Filter – Here we can specify the download location URL and it’s protocol.

  There is a by default location available in Download Round Robin location filter’, but admin

...

• Place the upgrading image in download location file server.
• Select Download Location Filter option within common list to enter into Download Location Filter page.
• After entered Download Location Filter page press edit button to add your Download Location details.
• Enter FQDN and Full URL of the location. This location will be applied by default for all the devices.

Admin can set up an alternative download location for hosting the firmware image using any local file server . To add alternative location for the device, we need to override it from firmware rules.

•  Go to Firmware -> Firmware Rules -> Define Properties -> Create
•  A page will be displayed with options to select the template. Select ‘DOWNLOAD‘DOWNLOAD_LOCATION_FILTER’ 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’.

For setting up Local File Server refer section "Setup a local File-Server" under Support Section. Below setup shows using hfs as file server:

Host the upgrade image in File-Server and copy the link address of the file url. Below snapshot was taken with another setup hence there is mismatch with the URI. Use the uri which is obtained from section "Setup a local File-Server", "link address of the image" (http://192.168.1.106:8001)

...

•  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)

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.

Verification using

Image Removed

...

XConf firmware Test page

After creating the Firmware configs and Firmware rules, go to Firmware->Test page and give a parameter that will match the one of the rules that you have created. Then matched rule will be displayed like below. 

How to

...

perform the Firmware upgrade in STB 

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

Select Check for Update

In this document, we are configuring local hfs server. 

Validations 

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

...