原创力文档- 1、本文档共24页，可阅读全部内容。
- 2、原创力文档（book118）网站文档一经付费（服务费），不意味着购买了该文档的版权，仅供个人/单位学习、研究之用，不得用于商业用途，未经授权，严禁复制、发行、汇编、翻译或者网络传播等，侵权必究。
- 3、本站所有内容均由合作方或网友上传，本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺！文档内容仅供研究参考，付费前请自行鉴别。如您付费，意味着您自己接受本站规则且自行承担风险，本站不退款、不进行额外附加服务；查看《如何避免下载的几个坑》。如果您已付费下载过本站文档，您可以点击 这里二次下载。
- 4、如文档侵犯商业秘密、侵犯著作权、侵犯人身权等，请点击“版权申诉”（推荐），也可以打举报电话：400-050-0827(电话支持时间：9:00-18:30)。
版本号修订日期修订内容说明MessageQueuingTelemetryTransport
版本号
修订日期
修订内容
说明
2015/9/8
草稿
2016/4/8
重构
Liuyuan
2016/4/19
丰富报文格式，业务流程
Leihong
2016/7/13
增加设备间订阅，创建topic功能
Leihong
目录
说明 3
接入流程 3
Packet格式说明 4
Fixedheader 4
VariableHeaderPayload 4
支持的packet 5
CONNECT 5
FixedHeader 5
VariableHeader 5
Payload 6
CONNACK 6
FixedHeader 6
VariableHeader 6
PUBLISH（client-server） 7
Fixedheader 7
VariableHeader 7
Payload 8
PUBLISH（server-client） 8
Fixedheader 8
VariableHeader 8
Payload 8
PUBACK 9
Fixedheader 9
VariableHeader 9
SUBSCRIBE 9
Fixedheader 9
VariableHeader 9
Payload 9
SUBACK 10
Fixedheader 10
VariableHeader 10
Payload 10
UNSUBSCRIBE 10
Fixedheader 10
VariableHeader 11
Payload 11
UNSUBACK 11
Fixedheader 11
VariableHeader 11
接入流程 12
连接鉴权 12
消息发布 13
数据点上报 13
平台命令(下发回复) 17
创建Topic. 19
订阅 21
取消订阅 21
推送设备Topic 22
说明
MQTT协议详细内容请参见MQTTversion官方文档，本文档对此不做详细说明，仅指明OneNet的要求、默认参数、以及当前实现与MQTT官方文档的差异。
该版本支持的功能:鉴权;
数据点上报(平台指定topic);
创建topic;
获取项目的topic列表;订阅/取消平台的topic;设备间topic订阅;
平台命令下发;Qos0(c?S),Qos1(C-S);
接入流程
访问平台注册用户；
用户根据业务情况，在“连接请求”章节中选择EDP登录方式（目前公测阶段，页面还未提供MQTT登录选项，登录方式与EDP兼容）；
登录需填写设备相关属性，在项目下新增设备，获取项目ID、设备ID，以及authinfo等信息；
设备发送TCP连接请求到以下地址，发送封装的报文与平台交互。
平台服务器地址，
平台服务器地址，TCP端口6002
Packet格式说明
包格式包含三部分：
FixedHeader
FixedHeader
VarableHeaderPayload
所有packet中都必须有
部分包含有部分包含有
Fixedheader
Bit
Bit
byte1
byte2-5
7
6
5
4
MQTTPacketType
3
0
2
0
1
0
0
0
RemainingLength（该字段占用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
取消订阅
UNSUBACK
11
S-C
取消订阅确认
VariableHeaderPayload
消息类型
VariableHeader
Payload
CONNECT
有
有
CONNACK
有
有
PUBLISH
有
有
PUBACK
有
无
SUBSCRIBE
有
有
SUBACK
有
有
UNSUBSCRIBE
有
有
UNSUBACK
有
无
支持的packet
CONNECT
FixedHeader
Bit
Bit
byte1
byte2-5
7
6
5
4
MQTTPacketType
3
0
2
0
1
0
0
0
RemainingLength（该字段占用1-4个字节）
VariableHeader
De
文档评论（0）