MQTT协议接入
MQTT简介
MQTT（Message Queuing Telemetry Transport，消息队列遥测传输）协议是即时通信协议，是物联网的重要组成部分。
协议特点
MQTT协议是为大量计算能力有限，且工作在低带宽、不可靠的网络的远程传感器和控制设备通讯而设计的协议，它具有以下主要的几项特性：
1.使用发布/订阅消息模式，提供一对多的消息发布，解除应用程序耦合；
2.对负载内容屏蔽的消息传输；
3.使用 TCP/IP 提供网络连接；
4.小型传输，开销很小（固定长度的头部是 2 字节），协议交换最小化，以降低网络流量；
5.使用 Last Will 和 Testament 特性通知有关各方客户端异常中断的机制；
6.有三种消息发布服务质量：
“至多一次”，消息至多发送一次。
“至少一次”，确保消息到达，但消息重复可能会发生。
“只有一次”，确保消息到达一次。
操作前提
1.已创建好产品和设备（产品管理、设备管理）
2.定义好产品模型（模型管理）
获取连接认证参数
设备通过mqtt协议连接云服务，必须认证通过后才能成功建立连接。
【注意】直连设备（网关设备和普通设备）才允许连接
1)建立连接前先从平台获取认证需要的参数
| 参数 | 说明 | 获取路径 |
|---|---|---|
| devId | 设备ID | 用户添加设备时输入的“设备ID”，在“设备管理”中可查看 |
| pk | 产品PK | 平台“设备管理”，根据设备ID找到设备，点击列表右侧的“查看”，复制“设备信息”中的“产品PK”。 |
| devSecret | 设备秘钥 | 平台“设备管理”，根据设备ID找到设备，点击列表右侧的“查看”，复制“设备信息”中的“devSecret”。 |
2）构造MQTT连接的参数
| 参数 | 说明 | 构造方式 |
|---|---|---|
| clientId | 客户端ID | dev:{pk}:{devId} |
| username | 用户名 | {hashMethod}:{random} |
| password | 密码 | hash(pk+devId+devSecret+random)，加密密钥：devSecret。 |
【说明】
（1）参数间使用“:”隔开。
（2）{hashMethod}支持：HmacMD5、HmacSHA1、HmacSHA256 和 HmacSHA512。
（3）password中加密使用的hashMethod、random需跟username中一致。
参数构造实例
Eg：pk=’pk123$’，devId=’1001$’，devSecret=’secret123$’，使用HashMD5方式进行加密，随机字符（random）为’20191108’。
clientId = dev:pk123$:1001$
username = HashMD5:20191108
password = c0608e3abe2f058df1d33020f963dbaf
password是通过HashMD5方法加密后得到。
要加密的字符串：pk123$1001$secret123$20191108，加密密钥：secret123$，加密后得到“c0608e3abe2f058df1d33020f963dbaf”。
（在线工具）
网关集群模式(IoT OS版本为1.4.18及以上支持)
网关 mqtt 连接共支持3种方式：
- 单机模式
- 广播模式
- 集群模式
注意：仅支持 mqtt 方式连接的设备。
应用场景
构建高可用网关
单机模式
单机模式与普通设备连接无异，即 clientId 构造为：dev:{pk}:{devId}，同一个设备作为不同客户端登录会不断顶替对方，造成重复登录。
发布 topic 为 up/dev/{pk}/{devId}
订阅 topic 为 down/dev/{pk}/{devId}
广播模式
clientId 构造为 dev:{pk}:{devId}:{random}，比单机模式多了:{random}，random 为随机字符串，建议6位长度左右的字母+数字作为随机值；同一个设备，如果 clientId 不一样，允许作为不同客户端同时登录 IoTOS 。
发布 topic 为 up/dev/{pk}/{devId}
订阅 topic 为 down/dev/{pk}/{devId}，发给设备的每条消息，每个客户端都会收到相同的消息。
集群模式
订阅 topic 为 $share/gw/down/dev/{pk}/{devId}，$share是固定写法，gw可以改为其他纯字母。发给设备的消息，会被随机分发给其中一个客户端，即使这条消息是被 A 客户端发送给 IoTOS 的，也可能是 A 收不到，而 B 客户端收到。