远程配置

更新时间：2024-06-19 06:29:58下载pdf

通过涂鸦开发者平台提供的远程配置功能，开发人员可在不用重启设备或中断设备运行的情况下，在线远程更新设备的系统参数、网络参数等配置信息。

本文档介绍设备主动请求远程配置信息和平台推送配置信息的 Topic 及数据格式定义。

功能说明

平台远程配置功能支持：

开启或关闭产品的远程配置。
在线编辑配置文件，并管理版本。
从平台推送配置文件，批量更新设备配置信息。
设备主动请求更新配置信息。

详细信息，可查看平台操作手册远程配置。

远程配置下载

设备发送消息

设备主动请求获取产品下最新版本的配置文件。

topic：tylink/${deviceId}/ext/config/get

{
    "msgId":"45lkj3551234***",
    "time":1626197189638,
    "data":{
        "bizType":"PRODUCT_FILE"
    }
}

参数说明

参数	类型	说明	必选	备注
${deviceId}	string	设备 ID	是	设备 ID。如果是子设备的身份，`deviceId` 应该为子设备 ID。
version	string	协议版本	否	默认 1.0，仅有 1.0。
msgId	string	消息 ID	是	总长度不超过 32 位的字符，请求和响应消息通过该值建立应答关系。
time	number	消息时间戳	是	消息发送时的 Unix 时间戳，10 位秒级或 13 位毫秒级。
data	object	获取时间服务参数	是	获取时间服务参数
data.bizType	string	业务类型	是	业务类型。目前支持产品维度远程文件配置，取值：`PRODUCT_FILE`。

设备接收消息

设备请求云端获取最新版本配置文件，云端响应返回最新版本配置文件的 URL。

topic：tylink/${deviceId}/ext/config/get_response

{
    "msgId":"45lkj3551234***",
    "time":1626197189638,
	"data":{
        "bizType":"PRODUCT_FILE",
        "pid":"5k8h97qska6pf***",
        "fileName": "n2atcfaa_000004d6n7_0.0.8.json",
        "url":"https://tuya-temp-fileupload-1254153901.cos.ap-shanghai.myqcloud.com/iot-platform-tmp/bay1617694933431vh5n/1631015173bbb14756aa2.png?sign=q-sign-algorithm%3Dsha1%26q-ak%3DAKIDopcCYgw0qRoyV5qfKjvg2pPkqESnb5zI%26q-sign-time%3D1631015173%3B1631018773%26q-key-time%3D1631015173%3B1631018773%26q-header-list%3D%26q-url-param-list%3D%26q-signature%3D4670e7d3cf500f9210a0f2d5bc9e98d6e429****",
        "size": 5165,
        "sha256": "54081B1FD727F2F6533178B7FC18B144177A0E33201D1685BBF0B2E38AB9A***",
        "version": "0.0.8", 
        "md5": "74ea6d75f6487049b61a2aa24da2f***"  
    }
}

参数说明

参数	类型	说明	必选	备注
${deviceId}	string	设备id	是	设备 ID。如果是子设备的身份，`deviceId` 应该为子设备 ID。
version	string	协议版本	否	默认 1.0，仅有 1.0。
msgId	string	消息的id	是	总长度不超过 32 位的字符，请求和响应消息通过该值建立应答关系。
time	number	消息时间戳	是	消息发送时的 Unix 时间戳，10 位秒级或 13 位毫秒级。
data	object	获取时间服务参数	是	获取时间服务参数。
data.bizType	string	业务类型	是	业务类型。目前支持产品维度远程文件配置，取值：`PRODUCT_FILE`。
data.pid	string	产品 PID	是	产品 PID。
data.fileName	string	配置文件名称	是	配置文件名称。
data.url	string	上传的预签名 URL	是	用于设备文件上传的预签名URL，可用来直接上传文件到云存储。
data.size	integer	配置文件大小	是	单位为字节。
data.sha256	stirng	文件的 SHA-256 哈希值	是	文件的 SHA-256 哈希值。
data.version	stirng	当前文件版本	是	当前文件版本。
data.md5	stirng	文件的 MD5 值	是	文件的 MD5 值。

上一篇固件升级 OTA

下一篇自定义透传协议