Versions Compared

Key

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

...

Request to retrieve firmware configuration. 

Firmware Config request

Code Block
languagephp
themeEclipse
http://<host>:<port>/xconf/swu/bse?ipAddress=100.71.216.10


Header

Code Block
languagephp
themeEclipse
Accept: application/json

...


 OR
Accept: application/xml


Response example 

Code Block
languagephp
themeEclipse
{

...



    "location": "69.252.80.69",

...



    "ipv6Location": "2001:558:fe15:13::a296:e4b3",

...



    "protocol": "tftp",

...



    "modelConfigurations": [

...



        {

...



            "model": "RPI-V",

...



            "firmwareFilename": "rdk-generic-hybrid-image-20190106221326.sdimg",

...



            "firmwareVersion": "rdk-generic-hybrid-image-20190106221326"

...



        },

...



        {

...



            "model": "RPI-B",

...



            "firmwareFilename": "rdk-generic-broadband-image-20200101201216.sdimg",

...



            "firmwareVersion": "rdk-generic-broadband-image-20200101201216"

...



        }

...



    ]

...


}


Last log - /estbfirmware/lastlog

Request to get last change log. 

FirmwareRules

Code Block
languagephp
themeEclipse
http://<host>:<port>/estbfirmware/lastlog?mac=CC:CC:CC:CC:CC:C2


Header

Code Block
languagephp
themeEclipse
Accept: application/json

...


 OR
Accept: application/xml


Response example 

Code Block
languagephp
themeEclipse
{

...



    "input": {

...



        "estbMac": "CC:CC:CC:CC:CC:C2",

...



        "env": "ASDF",

...



        "model": "ASDF",

...



        "firmwareVersion": "1",

...



        "bypassFilters": [],

...



        "forceFilters": [],

...



        "capabilities": [],

...



        "timeZone": "UTC",

...



        "time": "10/18/2016 12:51:00",

...



        "ipAddress": "0:0:0:0:0:0:0:1",

...



        "rcdl": false,

...



        "rebootDecoupled": false,

...



        "supportsFullHttpUrl": false

...



    },

...



    "rule": {

...



        "type": "MAC_RULE",

...



        "name": "11111111111111",

...



        "noop": false

...



    },

...



    "filters": [

...



        {

...



            "type": "DownloadLocationRoundRobinFilter",

...



            "id": "SINGLETON_DOWNLOAD_LOCATION_ROUND_ROBIN_FILTER",

...



            "name": "DOWNLOAD_LOCATION_ROUND_ROBIN_FILTER_VALUE",

...



            "noop": true

...



        }

...



    ],

...



    "explanation": "Request: com.comcast.xconf.estbfirmware.EstbFirmwareContext$Converted@23fe12cd[\r\n  estbMac=CC:CC:CC:CC:CC:C2\r\n  env=ASDF\r\n  model=ASDF\r\n  firmwareVersion=1\r\n  ecmMac=<null>\r\n  receiverId=<null>\r\n  controllerId=<null>\r\n  channelMapId=<null>\r\n  vodId=<null>\r\n  bypassFilters=[]\r\n  forceFilters=[]\r\n  capabilities=[]\r\n  timeZone=UTC\r\n  time=2016-10-18T12:51:00.000\r\n  ipAddress=0:0:0:0:0:0:0:1\r\n]\n matched MAC_RULE f0362812-1777-4109-8a81-7f8907566d07: 11111111111111\n received config: FirmwareConfig[\r\n  description=1\r\n  supportedModelIds=[1, ASDF]\r\n  firmwareDownloadProtocol=tftp\r\n  firmwareFilename=1\r\n  firmwareLocation=162.150.228.179\r\n  firmwareVersion=1\r\n  ipv6FirmwareLocation=2001:558:1020:1:250:56ff:fe94:646f\r\n  upgradeDelay=<null>\r\n  rebootImmediately=false\r\n  id=5d9579b2-21f1-45a4-925f-88ed28e75892]\n was blocked/modified by filter SINGLETON_DOWNLOAD_LOCATION_ROUND_ROBIN_FILTER DOWNLOAD_LOCATION_ROUND_ROBIN_FILTER_VALUE",

...



    "config": {

...



        "firmwareDownloadProtocol": "tftp",

...



        "firmwareFilename": "1",

...



        "firmwareVersion": "1",

...



        "rebootImmediately": false,

...



        "firmwareLocation": "162.150.228.179",

...



        "ipv6FirmwareLocation": "2001:558:1020:1:250:56ff:fe94:646f"

...



    }

...


}


Change logs - /estbfirmware/changelogs

Request to get all change logs. 

FirmwareRules

Code Block
languagephp
themeEclipse
http://<host>:<port>/estbfirmware/changelogs?mac=CC:CC:CC:CC:CC:C2


Header

Code Block
languagephp
themeEclipse
Accept: application/json

...



or Accept:

...

 application/xml


Response example 

Code Block
languagephp
themeEclipse
[

    {

Response example 

[

    {

        "input": {

...



            "estbMac": "CC:CC:CC:CC:CC:C2",

...



            "firmwareVersion": "asdf",

...



            "bypassFilters": [],

...



            "forceFilters": [],

...



            "capabilities": [],

...



            "timeZone": "UTC",

...



            "time": "12/16/2016 13:55:00",

...



            "ipAddress": "0:0:0:0:0:0:0:1",

...



            "rcdl": false,

...



            "rebootDecoupled": false,

...



            "supportsFullHttpUrl": false

...



        },

...



        "rule": {

...



            "type": "MAC_RULE",

...



            "name": "11111111111111",

...



            "noop": false

...



        },

...



        "filters": [

...



            {

...



                "type": "DownloadLocationRoundRobinFilter",

...



                "id": "SINGLETON_DOWNLOAD_LOCATION_ROUND_ROBIN_FILTER",

...



                "name": "DOWNLOAD_LOCATION_ROUND_ROBIN_FILTER_VALUE",

...



                "noop": true

...



            }

...



        ],

...



        "explanation": "Request: com.comcast.xconf.estbfirmware.EstbFirmwareContext$Converted@4f733919[\r\n  estbMac=CC:CC:CC:CC:CC:C2\r\n  env=<null>\r\n  model=<null>\r\n  firmwareVersion=asdf\r\n  ecmMac=<null>\r\n  receiverId=<null>\r\n  controllerId=<null>\r\n  channelMapId=<null>\r\n  vodId=<null>\r\n  bypassFilters=[]\r\n  forceFilters=[]\r\n  capabilities=[]\r\n  timeZone=UTC\r\n  time=2016-12-16T13:55:00.000\r\n  ipAddress=0:0:0:0:0:0:0:1\r\n]\n matched MAC_RULE f0362812-1777-4109-8a81-7f8907566d07: 11111111111111\n received config: FirmwareConfig[\r\n  description=1\r\n  supportedModelIds=[1, ASDF]\r\n  firmwareDownloadProtocol=tftp\r\n  firmwareFilename=1.bin\r\n  firmwareLocation=162.150.228.179\r\n  firmwareVersion=1.bin\r\n  ipv6FirmwareLocation=<null>\r\n  upgradeDelay=<null>\r\n  rebootImmediately=false\r\n  id=5d9579b2-21f1-45a4-925f-88ed28e75892]\n was blocked/modified by filter SINGLETON_DOWNLOAD_LOCATION_ROUND_ROBIN_FILTER DOWNLOAD_LOCATION_ROUND_ROBIN_FILTER_VALUE",

...



        "config": {

...



            "firmwareDownloadProtocol": "tftp",

...



            "firmwareFilename": "1.bin",

...



            "firmwareLocation": "162.150.228.179",

...



            "firmwareVersion": "1.bin",

...



            "rebootImmediately": false

...



        }

...



    },

...



    {

...



        "input": {

...



            "estbMac": "CC:CC:CC:CC:CC:C2",

...



            "firmwareVersion": "1",

...



            "bypassFilters": [],

...



            "forceFilters": [],

...



            "capabilities": [],

...



            "timeZone": "UTC",

...



            "time": "12/16/2016 13:55:00",

...



            "ipAddress": "0:0:0:0:0:0:0:1",

...



            "rcdl": false,

...



            "rebootDecoupled": false,

...



            "supportsFullHttpUrl": false

...



        },

...



        "rule": {

...



            "type": "MAC_RULE",

...



            "name": "11111111111111",

...



            "noop": false

...



        },

...



        "filters": [

...



            {

...



                "type": "DownloadLocationRoundRobinFilter",

...



                "id": "SINGLETON_DOWNLOAD_LOCATION_ROUND_ROBIN_FILTER",

...



                "name": "DOWNLOAD_LOCATION_ROUND_ROBIN_FILTER_VALUE",

...



                "noop": true

...



            }

...



        ],

...



        "explanation": "Request: com.comcast.xconf.estbfirmware.EstbFirmwareContext$Converted@c277e2a[\r\n  estbMac=CC:CC:CC:CC:CC:C2\r\n  env=<null>\r\n  model=<null>\r\n  firmwareVersion=1\r\n  ecmMac=<null>\r\n  receiverId=<null>\r\n  controllerId=<null>\r\n  channelMapId=<null>\r\n  vodId=<null>\r\n  bypassFilters=[]\r\n  forceFilters=[]\r\n  capabilities=[]\r\n  timeZone=UTC\r\n  time=2016-12-16T13:55:00.000\r\n  ipAddress=0:0:0:0:0:0:0:1\r\n]\n matched MAC_RULE f0362812-1777-4109-8a81-7f8907566d07: 11111111111111\n received config: FirmwareConfig[\r\n  description=1\r\n  supportedModelIds=[1, ASDF]\r\n  firmwareDownloadProtocol=tftp\r\n  firmwareFilename=1.bin\r\n  firmwareLocation=162.150.228.179\r\n  firmwareVersion=1.bin\r\n  ipv6FirmwareLocation=<null>\r\n  upgradeDelay=<null>\r\n  rebootImmediately=false\r\n  id=5d9579b2-21f1-45a4-925f-88ed28e75892]\n was blocked/modified by filter SINGLETON_DOWNLOAD_LOCATION_ROUND_ROBIN_FILTER DOWNLOAD_LOCATION_ROUND_ROBIN_FILTER_VALUE",

...



        "config": {

...



            "firmwareDownloadProtocol": "tftp",

...



            "firmwareFilename": "1.bin",

...



            "firmwareLocation": "162.150.228.179",

...



            "firmwareVersion": "1.bin",

...



            "rebootImmediately": false

...



        }

...



    },

...



    {

...



        "input": {

...



            "estbMac": "CC:CC:CC:CC:CC:C2",

...



            "firmwareVersion": "2",

...



            "bypassFilters": [],

...



            "forceFilters": [],

...



            "capabilities": [],

...



            "timeZone": "UTC",

...



            "time": "12/16/2016 13:53:00",

...



            "ipAddress": "0:0:0:0:0:0:0:1",

...



            "rcdl": false,

...



            "rebootDecoupled": false,

...



            "supportsFullHttpUrl": false

...



        },

...



        "rule": {

...



            "type": "MAC_RULE",

...



            "name": "11111111111111",

...



            "noop": false

...



        },

...



        "filters": [

...



            {

...



                "type": "DownloadLocationRoundRobinFilter",

...



                "id": "SINGLETON_DOWNLOAD_LOCATION_ROUND_ROBIN_FILTER",

...



                "name": "DOWNLOAD_LOCATION_ROUND_ROBIN_FILTER_VALUE",

...



                "noop": true

...



            }

...



        ],

...



        "explanation": "Request: com.comcast.xconf.estbfirmware.EstbFirmwareContext$Converted@32c0d2ed[\r\n  estbMac=CC:CC:CC:CC:CC:C2\r\n  env=<null>\r\n  model=<null>\r\n  firmwareVersion=2\r\n  ecmMac=<null>\r\n  receiverId=<null>\r\n  controllerId=<null>\r\n  channelMapId=<null>\r\n  vodId=<null>\r\n  bypassFilters=[]\r\n  forceFilters=[]\r\n  capabilities=[]\r\n  timeZone=UTC\r\n  time=2016-12-16T13:53:00.000\r\n  ipAddress=0:0:0:0:0:0:0:1\r\n]\n matched MAC_RULE f0362812-1777-4109-8a81-7f8907566d07: 11111111111111\n received config: FirmwareConfig[\r\n  description=1\r\n  supportedModelIds=[1, ASDF]\r\n  firmwareDownloadProtocol=tftp\r\n  firmwareFilename=1.bin\r\n  firmwareLocation=162.150.228.179\r\n  firmwareVersion=1.bin\r\n  ipv6FirmwareLocation=<null>\r\n  upgradeDelay=<null>\r\n  rebootImmediately=false\r\n  id=5d9579b2-21f1-45a4-925f-88ed28e75892]\n was blocked/modified by filter SINGLETON_DOWNLOAD_LOCATION_ROUND_ROBIN_FILTER DOWNLOAD_LOCATION_ROUND_ROBIN_FILTER_VALUE",

...



        "config": {

...



            "firmwareDownloadProtocol": "tftp",

...



            "firmwareFilename": "1.bin",

...



            "firmwareLocation": "162.150.228.179",

...



            "firmwareVersion": "1.bin",

...



            "rebootImmediately": false

...



        }

...



    }

...



]


Minimum firmware check - /estbfirmware/checkMinimumFirmware

...