onenet设备终端接入协议4mqtt.docxVIP

Message Queuing Telemetry Transport（MQTT） 版本号 修订日期 修订内容 说明 V1.1 2015/9/8 草稿 V2.0 2016/4/8 重构 Liuyuan V2.1 2016/4/19 丰富报文格式，业务流程 Leihong V2.2 2016/7/13 增加设备间订阅，创建topic功能 Leihong 目录 TOC \o 1-3 \h \z \u 1 说明 3 2 接入流程 3 3 Packet格式说明 4 3.1 Fixed header 4 3.2 Variable Header Payload 4 4 支持的packet 5 4.1 CONNECT 5 4.1.1 Fixed Header 5 4.1.2 VariableHeader 5 4.1.3 Payload 6 4.2 CONNACK 6 4.2.1 Fixed Header 6 4.2.2 VariableHeader 6 4.3 PUBLISH（client - server） 7 4.3.1 Fixed header 7 4.3.2 VariableHeader 7 4.3.3 Payload 8 4.4 PUBLISH（server - client） 8 4.4.1 Fixed header 8 4.4.2 VariableHeader 8 4.4.3 Payload 8 4.5 PUBACK 9 4.4.1 Fixed header 9 4.4.2 VariableHeader 9 4.6 SUBSCRIBE 9 4.5.1 Fixed header 9 4.5.2 VariableHeader 9 4.5.3 Payload 9 4.7 SUBACK 10 4.6.1 Fixed header 10 4.6.2 VariableHeader 10 4.6.3 Payload 10 4.8 UNSUBSCRIBE 10 4.7.1 Fixed header 10 4.7.2 VariableHeader 11 4.7.3 Payload 11 4.9 UNSUBACK 11 4.9.1 Fixed header 11 4.9.2 VariableHeader 11 5 接入流程 12 5.1 连接鉴权 12 5.2 消息发布 13 5.2.1 数据点上报 13 5.2.2 平台命令(下发回复) 17 5.2 创建Topic 19 5.3 订阅 21 5.4 取消订阅 21 5.5 推送设备Topic 22 说明 MQTT协议详细内容请参见MQTT version 3.1.1官方文档，本文档对此不做详细说明，仅指明OneNet的要求、默认参数、以及当前实现与MQTT官方文档的差异。 该版本支持的功能: 鉴权; 数据点上报(平台指定topic); 创建topic; 获取项目的topic列表; 订阅/取消平台的topic; 设备间topic订阅; 平台命令下发; Qos0(c?S) ,Qos1(C-S); 接入流程 访问平台 /注册用户； 用户根据业务情况，在“连接请求”章节中选择EDP登录方式（目前公测阶段，页面还未提供MQTT登录选项，登录方式与EDP兼容）； 登录需填写设备相关属性，在项目下新增设备，获取项目ID、设备ID，以及authinfo等信息； 设备发送TCP连接请求到以下地址，发送封装的报文与平台交互。 平台服务器地址9，TCP 端口6002 Packet格式说明 包格式包含三部分： Fixed Header 所有packet中都必须有 Varable Header 部分包含有 Payload 部分包含有 3.1 Fixed header Bit 7 6 5 4 3 2 1 0 byte 1 MQTT Packet Type 0 0 0 0 byte2 - 5 Remaining Length（该字段占用1-4个字节） 该版本支持的所有类型： 名字 值 流向 描述 CONNECT 1 C-S 客户端请求与服务端建立连接 CONNACK 2 S-C 服务端确认连接建立 PUBLISH 3 C?S 发布消息 PUBACK 4 C?S 收到发布消息确认 SUBSCRIBE 8 C-S 订阅请求 SUBACK 9 S-C 订阅确认 UNSUBSCRIBE 10 C-S 取消订阅 UNSUBA