永兴集团

WH-GM5TF-N40使用MQTT连接华为云示例

一、资料下载

WH-GM5TF-N40资料官网下载链接：http://www.mnsmc.com/Product/292.html

WH-GM5-EVK 资料官网下载链接： http://www.mnsmc.com/Product/304.html

【PC端调试工具】网络调试助手 串口调试助手二合一http://www.mnsmc.com/Download/27.html

二、硬件连接

1、所需物品

WH-GM5TF-N40 模块 1台

WH-GM5-EVK 评估板 1块

12V电源适配器 1个

USB-RS232串口线 1条

SIM卡 1个

笔记本电脑 1台

2、硬件连接

WH-GM5TF-N40焊接到WH-GM5-EVK 评估板，评估板的232串口接USB-RS232串口线到电脑USB口，然后评估板接12V电源适配器上电。

电脑打开设置软件USR-CAT1 V1.2.5（在WH-GM5TF-N40资料包里面）

3、查看端口号

电脑鼠标点击计算机管理，右击，点开设备管理器，点击端口，查看接WH-GM5TF-N40评估板的USB-RS232串口线COM口号，COM3。

三、华为云设置

1、注册登录华为云，新建实例

（1）注册登录华为云http://www.huaweicloud.com/

（2）所有服务，找到打开IoT物联网，找到点击设备接入IoTDA

（3）新建IoTDA实例，案例用标准版测试，点击新建的实例名称测试。

（4）设备接入，查看MQTT端口号（1883），点击详情查看华为云服务器地址：a5de3ee32a.st1.iotda-device.cn-east-3.myhuaweicloud.com

2、创建产品

（1）点击左侧产品，点击创建产品

（2）创建产品，产品名TEST，协议类型MQTT，数据格式JSON，设备类型选择标准类型。

点击确定。

（3）创建产品成功

（3）查看主题，点击产品，点击Topic管理，点击系统预置Topic,设备消息相关Topic

备注：设置到实际产品，里面的{device_id}替换添加华为云的设备ID。

本案例是设备ID是6698b2c06c3ff74ec4662907_1234567890

2个主题就是：

$oc/devices/6698b2c06c3ff74ec4662907_1234567890/sys/messages/up

$oc/devices/6698b2c06c3ff74ec4662907_1234567890/sys/messages/down

3、注册设备

（1）点击设备，所有设备，点击注册设备。

（2）单设备注册，选择所属资源空间，所属产品选择TEST，设备标识码自定义了1234567890，下面对应生成设备ID，6698b2c06c3ff74ec4662907_1234567890，设备名称USR-TEST，设备描述MQTT，密钥自定义了12345678，点击确定。

（3）设备创建成功，状态是未激活，等待WH-GM5设置MQTT参数连接华为云之后，在线。

4、生成客户端ID、用户名和密码

（1）找到华为云设备接入MQTTClientID生成工具，链接：http://iot-tool.obs-website.cn-north-4.myhuaweicloud.com/

（2）将设备ID和 密钥 分别填入DeviceId和DeviceSecret中，然后点击Generate，生成ClientID，Username和Password。

DeviceId设备ID：6698b2c06c3ff74ec4662907_1234567890

DeviceSecret密钥：12345678

生成ClientID：6698b2c06c3ff74ec4662907_1234567890_0_1_2024071806

生成Username：6698b2c06c3ff74ec4662907_1234567890

生成Password：be467a743ba87b36fd9c47b06e0e6d1009f214ac7d033394d78d72c487699929

四、WH-GM5TF-N40参数设置

1、打开设置软件

2、进入配置状态

设置软件选择USB-RS232串口线的COM口，串口参数设置和WH-GM5串口参数一致，打开串口，点击进入配置状态，返回a+ok。

3、获取当前参数

点击获取当前参数，再对参数进行修改。

4、设置连接华为云的MQTT参数

（1）选择MQTT模式

（2）MQTTClient连接选择通用MQTT

服务器地址填：a5de3ee32a.st1.iotda-device.cn-east-3.myhuaweicloud.com

端口填：1883

用户名：6698b2c06c3ff74ec4662907_1234567890

密码：be467a743ba87b36fd9c47b06e0e6d1009f214ac7d033394d78d72c487699929

客户端ID：6698b2c06c3ff74ec4662907_1234567890_0_1_2024071806

MQTT串口传输模式设置：透传模式

（3）主题设置

订阅主题：勾选主题1，填$oc/devices/6698b2c06c3ff74ec4662907_1234567890/sys/messages/up

推送主题：勾选主题1，填$oc/devices/6698b2c06c3ff74ec4662907_1234567890/sys/messages/down

5、点击设置并保存所有参数，参数设置才生效。

五、通讯测试

1、华为云设备在线

WH-GM5设置完MQTT连接华为云参数，华为云设备在线。

2、华为云下发数据

（1）WH-GM5的评估板232串口接USB-RS232串口线，电脑打开一个串口助手，COM3，串口参数和GM5一致，准备接收华为云下发的数据。

（2）华为云页面，点击所有设备，找到添加的设备，点击云端下发，点击下发消息。

下发消息：Topic类型选系统Topic，消息格式选仅消息内容，base64编码改为否，消息内容选择字符串，输入数据123，点击确定。

（3）串口助手接收到数据123。

2、WH-GM5串口上报数据到华为云

（1）电脑打开串口助手COM3，串口参数和GM5一致，向华为云发送数据456。

（2）华为云页面，点击运行日志，选中需要查询的设备信息和日期，点击后面的刷新符号，可以看到华为云请求内容456。

编写人：金志方 编写日期：2024-07-18

审核人：金志方 审核日期：2024-07-18

订正版本：V1.0 订正内容：初稿