[技术分享]MQTT AT 应用实例——实现设备数据发布与订阅

TL_LIUJIAYING

# [技术分享] 基于 telink\_9118\_wifi\_sdk 的 MQTT AT 应用实例——实现设备数据发布与订阅 ## 1. 前言 在[技术分享] 从零开始搭建 telink_9118_wifi_sdk 开发环境并运行第一个示例 https://forum.telink-semi.cn/forum.php?mod=viewthread&tid=98596 (出处: 泰凌技术论坛)中，介绍了 SDK 开发环境的搭建。基于此，可以进一步利用 TLSR9118 的网络通信能力进行 MQTT 通信测试。 本文以 MQTT 为例，使用两块TLSR9118 开发板的 MQTT AT 指令，实现设备数据的发布与订阅，并进一步验证 MQTT over TLS 加密通信。 本文主要介绍以下内容： * 配置 MQTT 客户端并连接 Broker； * 使用 MQTT AT 指令进行消息发布与订阅； * 模拟设备数据上报； * 使用 TLS 建立加密 MQTT 连接； * 查询 MQTT 连接及订阅状态。 --- ## 2. 实验准备 本实验基于已经搭建好的 `telink_9118_wifi_sdk` 开发环境，主要使用以下工具： | 工具               | 用途                                   | | ------------------ | -------------------------------------- | | Tera Term/Windterm | 通过串口连接开发板，输入及查看 AT 指令 | | BDT                | 烧录编译好的固件                       | 本次实验使用两块 **TLSR9118 开发板**，分别作为 MQTT 发布端（Publisher）和订阅端（Subscriber），通过 MQTT Broker 实现两块开发板之间的数据通信。如下图所示，两块 TLSR9118 开发板分别用于 MQTT 消息发布和订阅。  本次实验使用的 MQTT Broker 地址为`58.34.176.98`。如下所示  --- ## 3. 烧录固件 使用 BDT 将编译好的固件[bin.zip](https://forum.telink-semi.cn/forum.php?mod=attachment&aid=MjMyNnxlOWI2NGU3NXwxNzg5NzEzMTQ4fDEzNDF8MA%3D%3D) 分别烧录到两块 TLSR9118 开发板。 烧录完成后，通过 Tera Term或Windterm 打开对应串口，确认开发板能够正常响应 AT 指令。 --- ## 4. MQTT 数据发布与订阅 ### 4.1 配置 MQTT 客户端 分别将两块开发板配置为发布端和订阅端，并设置不同的 Client ID，如`pub_board` 和 `sub_board`。 发布端执行： `AT+MQTTUSERCFG=0,1,"pub_board","","",0,0,""` ` AT+MQTTCONNCFG=0,60,0,"","",0,0` 订阅端执行： `AT+MQTTUSERCFG=0,1,"sub_board","","",0,0,"` `" AT+MQTTCONNCFG=0,60,0,"","",0,0` --- ### 4.2 连接 MQTT Broker 两块开发板分别执行：`AT+MQTTCONN=0,"58.34.176.98",18084,0` 连接成功后返回：`CONNECT OK` , 此时，两块开发板均已连接 MQTT Broker。 如下图所示：  服务端可以看到接入的客户端的状态以及消息的发布情况：   --- ### 4.3 订阅与发布消息 连接成功后，在订阅端订阅指定 Topic：`AT+MQTTSUB=0,"Telink-test",0` 然后在发布端向同一 Topic 发布消息：`AT+MQTTPUB=0,"Telink-test","Telink-test-topic",0,0 `  发布成功后，订阅端可以接收到信息：`+MQTTSUBRECV:0,"Telink-test",17,Telink-test-topic `  说明消息已经由 MQTT Broker 转发，并被订阅端成功接收。 --- ## 5. 模拟设备数据上报 实际应用中，MQTT 通常用于设备向服务器上报设备状态或传感器数据。因此，将前面的测试消息替换为一组模拟设备数据： `device=TL-SENSOR-001,temp=26.1,humi=49.5,voltage=3.17,rssi=-59,state=active` 发布端：`AT+MQTTPUB=0,"telink/device/data","device=TL-SENSOR-001,temp=26.1,humi=49.5,voltage=3.17,rssi=-59,state=active",0,0`  订阅端：`AT+MQTTSUB=0,"telink/device/data",0` 发布后，订阅端即可收到对应的设备数据。如下图所示  --- ## 6. 使用 TLS 加密 MQTT 通信 除普通 TCP 连接外，MQTT 还可以通过 TLS 对通信过程进行加密。 进行 MQTT TLS 通信前，需要准备相应的 CA 证书（`cacert.pem`）、客户端证书(`device.crt`)和客户端私钥(`device.key`)[MQTTTLS.zip](https://forum.telink-semi.cn/forum.php?mod=attachment&aid=MjI3N3xiY2ZmMmI1MHwxNzg5NjM3NDQ2fDEzNDF8MA%3D%3D) ，并加载到开发板(这里推荐使用teraterm串口工具，使用fs load 命令，从 YMODEM 选择要上传的⽂件)： `fs load /mqtt/cacert.pem` `fs load /mqtt/device.crt` `fs load /mqtt/device.key` 由于证书验证依赖系统时间，因此进行 TLS 连接前可先配置 SNTP： `AT+CIPSNTPCFG=1,8,"ntp1.aliyun.com"` `AT+CIPSNTPTIME?` 确认系统时间正常后，再进行 MQTT TLS 连接。  ### 6.1 配置 MQTT TLS 本次实验以同时进行服务器证书验证和客户端证书认证的方式为例。 两块开发板分别配置 MQTT TLS： 发布端： `AT+MQTTUSERCFG=0,5,"pub_board","","",0,0,"/mqtt/cacert.pem" ` `AT+MQTTCONNCFG=0,60,0,"","",0,0` 订阅端： `AT+MQTTUSERCFG=0,5,"sub_board","","",0,0,"/mqtt/cacert.pem" ` `AT+MQTTCONNCFG=0,60,0,"","",0,0` 然后连接 MQTT Broker：`AT+MQTTCONN=0,"58.34.176.98",18086,0` 客户端证书和私钥加载正常，返回：`OK` 表示 MQTT TLS 连接建立成功。  ### 6.2 TLS MQTT 下的数据通信 TLS 连接建立后，MQTT 消息的发布与订阅方式与普通 MQTT 基本一致。 发布端： `AT+MQTTPUB=0,"telink/device/data","device=TL-SENSOR-001,temp=26.1,humi=49.5",2,0`  订阅端： `AT+MQTTSUB=0,"telink/device/data",2`  发布端发送数据后，订阅端可以正常接收对应消息，说明 TLS MQTT 连接下的消息发布与订阅功能正常。 --- ## 7. 查询 MQTT 状态 在通信过程中，可以使用以下指令查询 MQTT 连接状态和订阅状态： `AT+MQTTCONN?` →返回：`+MQTTCONN:0,6,5,"58.34.176.98",18086,"/mqtt/cacert.pem",0` `AT+MQTTSUB?`→返回： `+MQTTSUB:0,"Telink-test",0 ` `+MQTTSUB:1,"Telink-TLS-test",0`  通过查询结果可以确认当前 MQTT 客户端的连接状态及相关连接信息。 --- ## 8. 取消订阅与断开连接 实验完成后，可以取消 Topic 订阅并清理 MQTT 连接： `AT+MQTTUNSUB=0,"Telink-TLS-test"` `AT+MQTTCLEAN=0`  至此，MQTT 消息发布、订阅以及 TLS MQTT 通信测试完成。 --- ## 9. 实验结果 通过本次实验，在已经搭建好的 `telink_9118_wifi_sdk` 开发环境基础上，使用 MQTT AT 指令完成了 TLSR9118 开发板的 MQTT 通信测试。 实验结果如下： * TLSR9118 开发板能够连接 MQTT Broker； * 发布端能够向指定 Topic 发布消息； * 订阅端能够订阅 Topic 并接收消息； * 能够通过 MQTT AT 指令查询连接及订阅状态； * 能够建立 MQTT TLS 加密连接； * TLS MQTT 连接建立后，可以正常进行数据发布与订阅。 ## 10. 总结 本文基于 `telink_9118_wifi_sdk` 开发环境，通过 TLSR9118 开发板实际操作 MQTT AT 指令，完成了 MQTT 客户端配置、Broker 连接、消息发布、订阅及接收等操作，并进一步验证了 MQTT TLS 加密通信。 通过上述实验，可以快速了解 TLSR9118 使用 MQTT AT 指令进行设备数据通信的基本流程。 <i class="pstatus"> 本帖最后由 TL_LIUJIAYING 于 2026-9-18 14:32 编辑 </i><br /> <br />

TL_HUANGJIN

非常详细，很棒呀👍 🎉️