MQTT 主题概览

更新时间：2022-10-24 06:56:49下载pdf

Tuya MQTT 标准协议提供了很多开箱即用的内置访问协议规范，涵盖了绝大多数开发者需要用到的业务场景，例如设备模型、上报下发、拓扑关系、OTA 升级、定时、远程配置下发、文件传输、NTP 等。更多的功能陆续扩展中。

通过这些标准功能，可以大大地降低开发难度，从而帮助您快速地开发物联网项目，缩短项目上线周期，进而提升快速拓展市场的效率。

以下是能力及主题概览介绍，分为发布主题和订阅主题。

发布主题

下面的主题主要用于设备向云平台发布消息或发起业务请求。

功能	消息类型	Topic 主题
获取模型	设备获取设备模型定义	tylink/${deviceId}/thing/model/get
属性上报	设备主动属性上报	tylink/${deviceId}/thing/property/report
属性下发	设备响应属性设置	tylink/${deviceId}/thing/property/set_response
批量上报	设备批量或为子设备上报	tylink/${deviceId}/thing/data/batch_report
事件上报	设备触发事件消息	tylink/${deviceId}/thing/event/trigger
动作执行	设备端响应执行结果	tylink/${deviceId}/thing/action/execute_response
设备上下线	网关代理子设备上线	tylink/${deviceId}/device/sub/login
设备上下线	网关代理子设备下线	tylink/${deviceId}/device/sub/logout
绑定子设备	网关发现子设备，请求激活子设备并建立拓扑关系	tylink/${deviceId}/device/sub/bind
建立拓扑关系	网关添加设备拓扑关系	tylink/${deviceId}/device/topo/add
删除拓扑关系	网关删除设备拓扑关系	tylink/${deviceId}/device/topo/delete
查询拓扑关系	网关请求云端查询拓扑关系	tylink/${deviceId}/device/topo/get
固件 OTA	设备上报固件版本信息	tylink/${deviceId}/ota/firmware/report
固件 OTA	设备获取静默升级信息	tylink/${deviceId}/ota/get
固件 OTA	设备上报升级状态和进度	tylink/${deviceId}/ota/progress/report
NTP 服务	设备请求时间校正 NTP 服务	tylink/${deviceId}/ext/time/request
夏令时服务	设备请求夏令时 DST 服务	tylink/${deviceId}/ext/time/request
文件上传	设备获取文件上传预签名 URL	tylink/${deviceId}/ext/file/upload/request
文件下载	设备获取文件下载 URL	tylink/${deviceId}/ext/file/download/request
远程配置下发	设备获取最新版本配置文件	tylink/${deviceId}/ext/config/get
自定义协议格式上报	设备上报自定义协议格式数据	tylink/${deviceId}/channel/raw/up

订阅主题

下面的主题主要用于设备从云平台订阅消息或接收指令。

功能	消息类型	Topic 主题
获取模型	接收返回的设备模型定义	tylink/${deviceId}/thing/model/get_response
属性上报	接收属性上报的云端响应	tylink/${deviceId}/thing/property/report_response
属性下发	接收下发的设备属性	tylink/${deviceId}/thing/property/set
批量上报	接收批量上报的云端响应	tylink/${deviceId}/thing/data/batch_report_response
事件上报	接收事件触发的云端响应	tylink/${deviceId}/thing/event/trigger_response
动作执行	接收执行设备动作	tylink/${deviceId}/thing/action/execute
绑定子设备	接收子设备绑定的云端响应【对子设备不用自动订阅】	tylink/${deviceId}/device/sub/bind_response
建立拓扑关系	接收添加设备拓扑关系的云端响应【对子设备不用自动订阅】	tylink/${deviceId}/device/topo/add_response
删除拓扑关系	接收删除设备拓扑关系的云端响应【对子设备不用自动订阅】	tylink/${deviceId}/device/topo/delete_response
查询拓扑关系	接收拓扑关系查询的云端响应【对子设备不用自动订阅】	tylink/${deviceId}/device/topo/get_response
拓扑关系变更	接收拓扑关系发生变更消息下发	tylink/${deviceId}/device/topo/change
固件 OTA	接收云端下发的固件 OTA 升级	tylink/${deviceId}/ota/issue
固件 OTA	接收设备获取静默升级的云端响应	tylink/${deviceId}/ota/get_response
NTP 服务	接收时间校正 NTP 的云端响应	tylink/${deviceId}/ext/time/response
夏令时服务	接收夏令时获取的云端响应	tylink/${deviceId}/ext/time/response
文件上传	接收云端响应文件上传的预签名 URL	tylink/${deviceId}/ext/file/upload/response
文件下载	接收云端响应下载文件 URL	tylink/${deviceId}/ext/file/download/response
远程配置下发	接收远程配置下发	tylink/${deviceId}/ext/config/get_response
自定义协议格式下发	接收自定义协议格式数据下发	tylink/${deviceId}/channel/raw/down

上一篇Tuya MQTT 标准协议