Obtain whether the firmware on the device is available for upgrade

Last Updated on : 2023-06-19 07:06:50

API address

GET: /v1.0/iot-03/devices/{device_id}/upgrade-infos

Request parameter

Parameter name	Type	IN	Required	Description
device_id	String	uri	true	Device ID

Return parameter

Parameter name	Type	Description
result	List

Description of result

Parameter name	Type	Description
upgrade_status	Integer	UpgradeStatus=1; otherwise, 0; if the device is being upgraded, corresponding status=2
current_version	String	The current version number of the channel firmware of the device
upgrade_version	String	The version number of the OTA for the channel firmware of the device
upgrade_desc	String	Upgrade description information
upgrade_type	Integer	Upgrade Method
module_type	Integer	The firmware corresponds to the channel number, and the channel number must be specified when confirming the upgrade
module_desc	String	Module type description
last_upgrade_time	Long	Last upgrade time
control_type	Integer	Is the device controllable
url	String	The relevant fields of the file, mainly used for Bluetooth and other devices

Request example

GET: /v1.0/iot-03/devices/002000425ccf7fc7342a/upgrade-infos

Return example

[
    {
        "module_type": 0,
        "current_version": "1.1.5",
        "upgrade_status": 0,
        "last_upgrade_time": 0,
        "module_desc ": "{\"code\":\"FIRMWARE_UPGRADE_TYPE_DESC_0\"}",
        "control_type": 0
    },
    {
        "module_type": 9,
        "current_version": "1.0.0",
        "upgrade_status": 0,
        "last_upgrade_time": 0,
        "module_desc ": "{\"code\":\"FIRMWARE_UPGRADE_TYPE_DESC_9\"}",
        "control_type": 0
    }
]

Error code

For more information, see error code.

Prev DocDevice OTA Update

Next DocConfirm Device Update