2024-05-08
401
USR-DR514 的MQTT模式连接阿里云示例
备注：USR-DR514需要插SIM卡联网。
一、资料下载
USR-DR504/DR514说明书（完整版）http://www.kewodl.com/Download/1046.html
USR-DR514 规格书 http://www.kewodl.com/Download/1047.html
USR-DR504/514 标准AT指令集http://www.kewodl.com/Download/1048.html
USR-DR514设置软件在这个压缩包内，USR-DR504/514 边缘计算+MQTT使用资料包http://www.kewodl.com/Download/990.html
【PC端调试工具】网络调试助手 串口调试助手二合一http://www.kewodl.com/Download/27.html
二、硬件连接
1、所需物品
USR-DR514 产品 1台
220V交流端子供电电源线 1条
USB-RS485串口线 1条
笔记本电脑 1台
2、硬件连接
USR-DR514的485串口接USB-RS485串口线到电脑USB口，接好4G天线，插好外置SIM卡，然后产品接220V交流端子供电电源线，上电（220V交流电供电注意安全）。
3、查看端口号
电脑鼠标点击计算机管理，右击，点开设备管理器，点击端口，查看接USR-DR514的USB-RS485串口线COM口号，COM10。
三、阿里云设置
1、登陆阿里云平台，找到物联网平台，这里用的连接公共实例
（1）登陆阿里云平台
（2）找到物联网平台
（3）开通连接公共实例
2、创建产品
（1）点击产品，点击创建产品
（2）新建产品信息，依次填写：
产品名称举例test——所属品类选择自定义品类——节点类型选择直连设备——联网与数据联网方式选择蜂窝（2G/3G/4G/5G）——数据格式选择透传/自定义——认证方式选择设备秘钥——点击确定，完成创建产品。
3、查看产品Topic
（1）点击产品，点击查看
（2）点击Topic类列表，点击自定义Topic,找到订阅和发布
设置USR-DR514的MQTT参数，需要按照以下方法设置订阅和A 发布主题。
数据订阅测试：将订阅的主题/i4u4VIKvRXf/USR-DR514/user/get填写到USR-DR514订阅的主题配置中去（注意将原主题中的${deviceName}替换为USR-DR514(本产品的DeviceName)）；
数据发布测试：将发布的主题/i4u4VIKvRXf/USR-DR514/user/update填写到USR-DR514的A主题发布主题的配置中去（注意将原主题中的${deviceName}替换为USR-DR514(本产品的DeviceName)）；
4、添加设备
（1）产品创建成功后，添加设备。点击设备，点击添加设备，产品名举例填test,DeviceName填USR-DR514，备注名称填MQTT，点击确认。
（2）添加完设备，如下图展示，设备状态是未激活，等设置完USR-DR514的MQTT连接阿里云参数之后，设备状态才显示在线。
5、查看设备证书内容，生成USR-DR514连接阿里云的用户名
（1）点击设备，点击查看，再点击DeviceSecret后面的查看。
展示设备证书：
ProductKey: i4u4VIKvRXf
DeviceName: USR-DR514
DeviceSecret: 0be5dd5df57ed4fc2d84751287857b4d
（2）转换USR-DR514连接阿里云的用户名：
用户名： 由设备名 DeviceName、符号（&）和产品 ProductKey 组成。
固定格式：${YourDeviceName}&${YourPrductKey}。
完整示例如：device&alxxxxxxxxxx。
USR-DR514连接阿里云的用户名：USR-DR514&i4u4VIKvRXf
6、查看账号和地域，生成USR-DR514连接阿里云的服务器地址
（1）查看使用的阿里云账号aliyun9810869345
（2）根据地域名称华东2（上海）查询地域ID：cn-shanghai
（3）转换USR-DR514连接阿里云的服务器地址：
格式：${YourProductKey}.iot-as-mqtt.${region}.aliyuncs.com。
其中，${region}需替换为您物联网平台服务所在地域的代码。地域代码，请参见地域和可用区。如：
alxxxxxxxxxx.iot-as-mqtt.cn-shanghai.aliyuncs.com。
USR-DR514连接阿里云的服务器地；aliyun9810869345.iot-as-mqtt.cn-shanghai.aliyuncs.com
USR-DR514连接阿里云的端口用1883
7、使用MQTT签名工具，生成USR-DR514连接阿里云的密码
（1）打开MQTT签名工具
下载USR-DR514/514 边缘计算+MQTT使用资料包，解压缩，找到MQTT签名工具
（2）密码由参数值拼接加密而成
可以使用物联网平台提供的生成工具自动生成 Password，也可以手动生成 Password。
单击下载 Password 生成小工具。解压缩下载包后，双击 sign 文件，即可使用。
➢ 使用 Password 生成小工具的输入参数：
▪ productKey：设备所属产品 Key。可在控制台设备详情页查看。
▪ deviceName：设备名称。可在控制台设备详情页查看。
▪ deviceSecret：设备密钥。可在控制台设备详情页查看。
▪ timestamp：（可选）时间戳。
▪ clientId：设备的 ID 信息，与 Client ID 中${clientId}一致。
▪ method：选择签名算法类型，与 Client ID 中 signmethod 确定的加密方法一致。
（3）转换USR-DR514连接阿里云的密码
填入设备信息：
▪ productKey设备所属产品 Key：i4u4VIKvRXf
▪ deviceName设备名称：USR-DR514
▪ deviceSecret设备密钥：0be5dd5df57ed4fc2d84751287857b4d
▪ timestamp（可选）时间戳：
▪ clientId设备的 ID 信息：12345678
▪ method选择签名算法类型：hmacsha1
签名结果：D025D767654679BE0FB1AC08267C7DEABA2FCD2B
USR-DR514连接阿里云的的密码：D025D767654679BE0FB1AC08267C7DEABA2FCD2B
8、生成USR-DR514连接阿里云的客户端ID
（1）Client ID格式：
生成 mqttClientId，用于 MQTT 的底层协议报文。
格式固定：${clientId}|securemode=3,signmethod=hmacsha1|。
完整示例：12345|securemode=3,signmethod=hmacsha1|。
其中，
${clientId}为设备的 ID 信息。可取任意值，长度在 64 字符以内。建议使用设备的 MAC 地址或 SN
码。
securemode 为安全模式，TCP 直连模式设置为 securemode=3，TLS 直连为 securemode=2。
signmethod 为算法类型，支持 hmacmd5 和 hmacsha1。
（2）转换USR-DR514连接阿里云的Client ID
客户端ID：12345678|securemode=3,signmethod=hmacsha1|
四、USR-DR514参数设置
1、打开USR-DR514设置软件V1.0.7
2、打开串口，点击进入配置状态
3、点击获取当前参数
4、设置MQTT模式参数
（1）选择MQTT模式
（2）MQTT Client连接
地址：aliyun9810869345.iot-as-mqtt.cn-shanghai.aliyuncs.com
端口：1883
用户名：USR-DR514&i4u4VIKvRXf
密码：D025D767654679BE0FB1AC08267C7DEABA2FCD2B
数据格式：格式化输出
客户端ID：12345678|securemode=3,signmethod=hmacsha1|
（3）MQTT主题订阅
主题1设置/i4u4VIKvRXf/USR-DR514/user/get
（4）A主题
发布主题：/i4u4VIKvRXf/USR-DR514/user/update，设置软件点击设置所有参数
5、点击设备重启
6、设置软件点击关闭串口
五、MQTT连接阿里云功能调试
1、查看阿里云设备状态在线
USR-DR514 设置完MQTT连接阿里云参数，联网正常，在阿里云平台可以看到设备状态是在线。
2、数据订阅测试(格式化输出)
（1）点击设备，点击查看
（2）点击Topic列表，点击发布消息
（3）使用阿里云平台发布的消息www.kewodl.com，被USR-DR514订阅到，并通过USR-DR514串口发给串口端，数据格式是格式化输出，串口助手接收的数据/i4u4VIKvRXf/USR-DR514/user/get,www.kewodl.com
3、数据发布测试
（1）点击设备，点击日志服务
（2）发布消息格式
通过串口向发服务器更新设备状态时，需遵循如下数据格式：
主题名(最多100字节) | , | 服务等级 | , | 数据 |
示例：/i4u4VIKvRXf/USR-DR514/user/update,0,1234567890
（注：“,”为英文输入法下的格式）
（3）USR-DR514使用串口助手发送数据/i4u4VIKvRXf/USR-DR514/user/update,0,1234567890，发送完成之后，我们在阿里云平台可以通过日志服务，点击查看，看到USR-DR514串口发到阿里云的数据1234567890。
4、数据订阅测试(透传)
（1）USR-DR514，点击进入配置状态，点击获取当前参数，数据格式设置透传，点击设置所有参数，点击设备重启，最后关闭串口。
（2）登陆阿里云平台，点击设备，点击查看
（3）点击Topic列表，点击发布消息
（4）使用阿里云平台发布的消息www.kewodl.com，被USR-DR514订阅到，并通过USR-DR514串口发给串口端，数据格式是透传，串口助手接收的数据www.kewodl.com
编写人：金志方 编写日期：2024-03-21
审核人：金志方 审核日期：2024-03-21
订正版本：V1.0 订正内容：初稿
