online-update-check

Use this interface to check for new firmware versions.

In order to conduct the firmware checking, an update can not be in progress.

You can obtain current device running status mask using get-status:

"cur-status": 65552                    // device running status mask

The output of cur-status & Device Status Mask is as follows:

Device status	Condition
Firmware update is not in progress	cur-status & statusUpgrade != statusUpgrade

HTTP Request

GET http://ip/usapi?method=online-update-check

Parameter	Description
method	online-update-check

Response Body

{
  "result": 0
}

Item	Description
result	0 indicates that the request was accepted successfully. Refer to API Status Codes to find specific description for other values.

Detection Status

Obtain check-upgrade and upgrade using get-status.

"check-upgrade": {
  "result": 0,
  "client-id": ""
},
"upgrade": {
  "ver": "1.2.123",
  "date": "2012-1-1 00:00:00",
  "size-byte": 12004784,
  "info": [
    {
      "version": "1.2.123",
      "changelog": "## Develop version 1.2. ## Develop version2."
    }
  ]
}

Item	Description
result	Indicates returned status. 27: initial status 2: checking 0: the request was accepted successfully. Refer to API Status Codes to find specific description for other values.
ver	Indicates new firmware version.
date	Indicates release date of the new firmware.
size-byte	Indicates file size of new firmware(B).
info	Indicates release note.
client-id	Reserved.

Call clear-check-update to reset the status to Initial status(27) after detection failed.

Ultra Encode