- 最新动态
- 功能总览
- 服务公告
- 计费说明
- 产品介绍
- 快速入门
- 用户指南
- 最佳实践
- 开发指南
-
API参考
- 应用侧API参考
- 设备侧MQTT/MQTTS接口参考
- 设备侧HTTPS接口参考
- 设备侧LwM2M接口参考
- 安全隧道WebSocket接口参考
- 模组AT指令参考
- 修订记录
- SDK参考
- 场景代码示例
-
常见问题
- 热门问题
-
方案咨询
- 连接IoT平台的业务场景有哪些？
- 设备管理服务和设备接入服务合一后的差异点是什么？
- IAM子用户或子项目是否可以开通物联网平台服务？
- 物联网平台支持在华为云的哪些区域开通？
- 华为是否提供模组/硬件终端/应用软件等？
- IAM用户访问API提示没有权限？(是否区分版本？)
- 创建规则或者设置资源文件存储时候提示赋予Security Administrator权限
- 物联网平台设置默认资源空间的规则是什么？
- 设备接入服务如何获取设备数据？
- 物联网平台的资源空间和设备可以无限创建吗？
- 物联网平台支持批量注册设备吗？
- 物联网平台对应用侧和设备侧在开发或使用时有限制吗？
- 物联网平台支持的DTLS加密算法有哪些？
- 物联网平台支持二进制大小端模式切换吗？
- 什么是NB-IoT？
- 物联网平台支持的硬件架构和使用的相关组件有哪些？
- 如何获取平台接入地址？
- 设备集成相关问题
- 设备侧SDK相关问题
- 设备发放相关问题
- LWM2M/CoAP接入相关问题
- MQTT接入相关问题
- 泛协议接入相关问题
- 物模型相关问题
- 消息通信相关问题
- 订阅推送相关问题
- 编解码插件相关问题
- OTA升级相关问题
- 应用集成相关问题
- 实例管理相关问题
- 视频帮助
- 文档下载
- 通用参考
展开导读
链接复制成功！
Topic定义
设备使用MQTT协议接入平台时，平台和设备通过Topic进行通信。平台预置的topic列表如下：
|
Topic分类 |
Topic |
Publisher(发布者) |
Subscriber(订阅者) |
用途 |
|---|---|---|---|---|
|
设备消息相关Topic |
$oc/devices/{device_id}/sys/messages/up |
设备 |
平台 |
|
|
$oc/devices/{device_id}/sys/messages/down |
平台 |
设备 |
||
|
设备命令相关Topic |
$oc/devices/{device_id}/sys/commands/request_id={request_id} |
平台 |
设备 |
|
|
$oc/devices/{device_id}/sys/commands/response/request_id={request_id} |
设备 |
平台 |
||
|
设备属性相关Topic |
$oc/devices/{device_id}/sys/properties/report |
设备 |
平台 |
|
|
$oc/devices/{device_id}/sys/gateway/sub_devices/properties/report |
设备 |
平台 |
||
|
$oc/devices/{device_id}/sys/properties/set/request_id={request_id} |
平台 |
设备 |
||
|
$oc/devices/{device_id}/sys/properties/set/response/request_id={request_id} |
设备 |
平台 |
||
|
$oc/devices/{device_id}/sys/properties/get/request_id={request_id} |
平台 |
设备 |
||
|
$oc/devices/{device_id}/sys/properties/get/response/request_id={request_id} |
设备 |
平台 |
||
|
$oc/devices/{device_id}/sys/shadow/get/request_id={request_id} |
设备 |
平台 |
||
|
$oc/devices/{device_id}/sys/shadow/get/response/request_id={request_id} |
平台 |
设备 |
||
|
设备事件相关Topic |
$oc/devices/{device_id}/sys/events/up |
设备 |
平台 |
设备事件上报与平台事件下发，可用于：设备网关管理、软固件升级、文件上传/下载、设备时间同步、设备信息上报、设备日志收集、远程配置 |
|
$oc/devices/{device_id}/sys/events/down |
平台 |
设备 |
说明：
- {device_id}用于标识Topic路由的目标设备，设备侧订阅该topic或往topic推送消息时，该值需要替换为设备与平台建立MQTT连接时使用的设备ID参数值。
- {request_id}用于唯一标识这次请求。设备侧发起的消息带该参数时，需要保证设备侧该参数值的唯一性，可以用递增的数字或者UUID来实现。当设备收到平台下发的topic中包含request_id时，设备侧响应的request_id需要跟平台下发的保持一致。
- 设备侧订阅带{request_id}参数的topic时，可以使用通配#。如设备侧订阅命令下发请求的topic $oc/devices/{device_id}/sys/commands/request_id={request_id}时，可以用$oc/devices/{device_id}/sys/commands/#。
- 平台采用了隐式订阅的功能，对于下行的系统topic，设备无需订阅，平台默认该设备订阅了qos为0的系统topic。如果需要qos为1的下行系统topic，需要设备自行订阅。
- 除了device_id、request_id其他均为系统字段。
