合宙Air780EP模块 AT开发-MQTT应用指南

已于 2024-08-06 14:23:23 修改
阅读量942 收藏 11
点赞数 25
文章标签： 阿里云
于 2024-07-31 17:04:52 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2301_79081828/article/details/140827511
版权

简介

Air780EP 是合宙的低功耗4G模组之一，支持全系列的AT指令， 以及LuatOS的脚本二次开发。
本文应各位大佬邀请，详细讲解了 780EP 的MQTT的多个AT命令的示例！

材料准备

  • [EVB_Air780EP(V)]开发板一套，包括天线SIM卡
  • USB线
  • PC电脑
  • 串口调试工具（如果没有准备，推荐可以使用llcom，下载地址：https://llcom.papapoi.com）
  • AT固件获取：https://gitee.com/openLuat/airm2m-ec718-at/releases ，进页面按下Ctrl+F 搜索 AirM2M_780EP_LTE_AT 即可找到780EP模块所使用的AT固件，推荐选用该固件名称后面数字版本号最高的最新relase版本进行调试。
  • 当前文档示例使用AirM2M_780EP_V1007_LTE_AT版本固件

在这里插入图片描述

MQTT应用基本流程

4G模块支持MQTT和MQTT SSl协议， MQTT应用的基本流程如下：

1、如果要支持SSL，配置SSL参数

2、通过TCP连接到MQTT服务器

3、发送MQTT CONNECT到服务器，打开会话连接

4、订阅或者发布消息

示例

1.MQTT发布消息示例

先来看个正常情况下的AT命令序列，如果不理解AT命令含义，请自行参考AT手册

AT指令手册下载链接
https://doc.openluat.com/article/4985

AT+CPIN?

 

+CPIN: READY    //查询sim卡是否正常

 

OK

AT+CGATT?

 

+CGATT: 1        //查询是否附着上数据网络，如果返回+CGATT: 0表示未附着上

 

OK


AT+MCONFIG="866289037465624","user","password"

 
OK

AT+MIPSTART="lbsmqtt.airm2m.com","1884"

 

OK

 

CONNECT OK

AT+MCONNECT=1,60

 

OK

 

CONNACK OK

AT+MSUB="mqtt/sub_topic",0

 

OK

 

SUBACK

AT+MPUB="mqtt/pub_topic",0,0,"publish 0 payload"

 

OK

AT+MPUB="mqtt/pub_topic",1,0,"publish 1 payload"

 

OK

 

PUBACK

AT+MPUB="mqtt/pub_topic",2,0,"publish 2 payload"

 

OK

 

PUBREC

 

PUBCOMP

发布消息示例演示效果
在这里插入图片描述

在这个过程中，注意事项如下：

     1、发送MIPSTART命令后，收到OK仅仅表示4G模块开始处理这条命令，并不表示TCP已经连接成功；只有收到CONNECT OK才是成功的应答（其余错误应答，参考AT手册）

     2、发送MCONNECT命令后，收到OK仅仅表示4G模块开始处理这条命令，并不表示MQTT已经连接成功；只有收到CONNACK OK才是成功的应答（其余错误应答，参考AT手册）

     3、发送MSUB命令后，收到OK仅仅表示4G模块开始处理这条命令，并不表示MQTT已经订阅成功；只有收到SUBACK才是成功的应答（其余错误应答，参考AT手册）

     4、发送MPUB命令后，如果QOS不是0，则收到OK仅仅表示4G模块开始处理这条命令，并不表示MQTT已经发布成功；只有收到PUBACK（QOS为1时）或者PUBCOMP（QOS为2时）才是成功的应答（其余错误应答，参考AT手册）

2.MQTT接收消息示例

先来看下接收到订阅消息时的AT命令处理序列，如果不理解AT命令含义，请自行参考AT手册
AT指令手册下载链接
https://doc.openluat.com/article/4985

AT+MCONFIG="866289037465624","user","password"
OK

AT+MIPSTART="lbsmqtt.airm2m.com","1884"
OK
CONNECT OK

AT+MCONNECT=1,60
OK

CONNACK OK

AT+MSUB="mqtt/sub_topic",0
OK
SUBACK

AT+MPUB="mqtt/sub_topic",0,0,"123456"
//在mqtt/sub_topic上收到订阅消息，payload为123456

//默认是直接输出收到的订阅消息，不做缓存

+MSUB: "mqtt/sub_topic",6 byte,123456

//设置订阅消息的处理模式，设置为缓存模式

//接下来收到订阅消息时，会提示订阅消息的缓存位置

AT+MQTTMSGSET=1

OK

//在mqtt/sub_topic上收到一条订阅消息，缓存到位置0

+MSUB: 0

//主动读取缓存的所有订阅消息

AT+MQTTMSGGET

+MSUB:mqtt/sub_topic,6 byte,123456

OK

//在mqtt/sub_topic上收到一条订阅消息，缓存到位置0

+MSUB: 0
//在mqtt/sub_topic上收到一条订阅消息，缓存到位置1

+MSUB: 1

//主动读取缓存的所有订阅消息

AT+MQTTMSGGET
+MSUB:mqtt/sub_topic,6 byte,123456

+MSUB:mqtt/sub_topic,6 byte,123456
OK

接收消息演示效果

接收消息演示效果

3.TCP被动断开示例

先来看下连接被动断开时的AT命令处理序列，如果不理解AT命令含义，请自行参考AT手册
AT指令手册下载链接
https://doc.openluat.com/article/4985

AT+MCONFIG="866289037465624","user","password"
OK

AT+MIPSTART="lbsmqtt.airm2m.com","1884"
OK
CONNECT OK

AT+MCONNECT=1,60
OK
CONNACK OK
CLOSED               //此处TCP连接被动断开

AT+MIPCLOSE
+CME ERROR: 767     //此处无论返回OK、ERROR还是CME ERROR，都直接跳过，不用做正确性判断
AT+MCONFIG="866289037465624","user","password"
OK
AT+MIPSTART="lbsmqtt.airm2m.com","1884"
OK
CONNECT OK
AT+MCONNECT=1,60
OK

CONNACK OK

4.PDP被动去激活示例

先来看下PDP被动去激活时的AT命令处理序列，如果不理解AT命令含义，请自行参考AT手册

AT指令手册下载链接
https://doc.openluat.com/article/4985


AT+MCONFIG="866289037465624","user","password"

OK

AT+MIPSTART="lbsmqtt.airm2m.com","1884"

OK

CONNECT OK

AT+MCONNECT=1,60

OK

CONNACK OK
+CGEV: NW PDN DEACT 1       //此处PDP被动去激活

AT+MIPCLOSE
OK                     //此处无论返回OK、ERROR还是CME ERROR，都直接跳过，不用做正确性判断

AT+MCONFIG="866289037465624","user","password"
OK
AT+MIPSTART="lbsmqtt.airm2m.com","1884"
OK
CONNECT OK
AT+MCONNECT=1,60
OK
CONNACK OK

5.SSL带证书验证流程【单向认证】

先来看下SSL带证书验证（单向认证）时的AT命令处理序列，如果不理解AT命令含义，请自行参考AT手册。

AT指令手册下载链接：
https://doc.openluat.com/article/4985

AT+CGATT?
+CGATT: 1
OK
AT+FSCREATE="ca.crt"//创建CA证书文件
OK
AT+FSWRITE="ca.crt",0,1212,15  
//1212是证书文件长度，15为超时时间，这里是举例说明，请填入实际数据，不要照抄 >
//此处填写证书数据
OK
AT+SSLCFG="cacert",88,"ca.crt"
//设置CA证书文件为ca.crt
OK
AT+SSLCFG="seclevel",88,1
//1表示设置认证模式为只对服务器认证
OK
AT+MCONFIG="868488076506128","user","password"
//这三个参数可以不加双引号，第一个参数需要开发者自己设置
//后两个参数可以不填，格式为:
AT+MCONFIG="868488076506128","",""
OK
AT+SSLMIPSTART="airtest.openluat.com",8883
//开发者请修改为自己的服务器地址和端口
OK
CONNECT OK
AT+MCONNECT=1,60
//在MIPSTART返回CONNECT OK后才能发MCONNECT命令
//而且要立即发，否则会被服务器踢掉
OK
CONNACK OK
--后面发布和接收与前面一样，直接参考

6.SSL带证书验证流程【双向认证】

先来看下SSL带证书验证（双向认证）时的AT命令处理序列，如果不理解AT命令含义，请自行参考AT手册。

AT指令手册下载链接：
https://doc.openluat.com/article/4985

AT+CGATT?
+CGATT: 1
OK
AT+FSCREATE="ca.crt" //创建CA证书文件
OK
AT+FSWRITE="ca.crt",0,1212,15  
//1212是证书文件长度，15为超时时间，这里是举例说明，请填入实际数据，不要照抄 >
//此处填写证书数据
OK
AT+FSCREATE="client.crt"
//创建客户端证书文件
OK
AT+FSWRITE="client.crt",0,1127,15 >
//此处填写证书数据
OK
AT+FSCREATE="client.key"
//创建客户端key文件
OK
AT+FSWRITE="client.key",0,1679,15 >
//此处填写证书数据
OK
AT+SSLCFG="cacert",88,"ca.crt"
//设置CA证书文件为ca.crt
OK
AT+SSLCFG="clientcert",88,"client.crt"
//设置客户端证书文件为client.crt
OK
AT+SSLCFG="clientkey",88,"client.key"
//设置客户端密钥文件为client.key
OK
AT+SSLCFG="seclevel",88,2
//设置认证模式为双向认证
OK
AT+MCONFIG="868488076506128","user","password"
//这三个参数可以不加双引号，第一个参数需要开发者自己设置
//后两个参数可以不填，格式为:
AT+MCONFIG="868488076506128","",""
OK
AT+SSLMIPSTART="airtest.openluat.com",8883
//开发者请修改为自己的服务器地址和端口
OK
CONNECT OK
AT+MCONNECT=1,60
//在MIPSTART返回CONNECT OK后才能发MCONNECT命令
//而且要立即发，否则会被服务器踢掉
OK
CONNACK OK
--后面发布和接收与前面一样，直接参考

常见问题Q&A

以下是针对客户朋友们实际应用中的反馈，整理了MQTT应用中的常见问题：

1、MQTT支持多连接吗

目前MQTT仅支持单连接，不支持多连接

2、MQTT的遗嘱如何使用

通过AT+MCONFIG命令可以设置遗嘱的qos、retain标志、topic、payload；在如下几种（包含但是又不仅限于如下情况）情况下，服务器会主动发布遗嘱消息到订阅的客户端：

  • 模块和服务器通信异常（例如模块突然关机、模块进入了一个没有网络信号的环境等）超过1.5倍（一般是1.5倍，但不排除服务器可以修改这个时间）的 keep alive时间（可以通过AT+MCONNECT设置keep alive时间）

  • 模块主动执行AT+MDISCONNECT或者AT+MIPCLOSE

曾经有用户碰到过如下问题：

模块设置了遗嘱topic为/will_topic，遗嘱payload为offline，keep alive时间为5分钟， 模块关机后，等待2分钟，在等待的2分钟内，其他订阅了/will_topic的客户端没有收到遗嘱消息（这是正常的，因为还没有到达1.5倍的keep alive时间）

2分钟后，模块开机mqtt重连成功后，其他客户端却收到了遗嘱消息，这是什么原因呢？

这部分机制是服务器端设计的，和模块无关.

个人认为： 服务器端仍然在维持2分钟前的那个mqtt连接，现在模块开机，用同样的client id重连后，会断开之前维护的相同client id的mqtt连接，断开时，就发布了一次遗嘱消息。

那这种问题，如何解决呢？

模块可以在AT+MCONNECT返回CONNACK OK之后，通过AT+MPUB一个topic为/will_topic，payload为online的消息，这样订阅了遗嘱topic的其他客户端就会收到这个online消息

3、重试多次PDP，MQTT应用一直连接失败
如果重试多次PDP激活，PDP一直激活失败，或者MQTT一直连接失败，则尝试使用如下手段恢复：

     1、使用RESET引脚复位模块

     2、极端情况下，直接给模块断电，再上电，POWER KEY引脚拉低开机

4、MPUB命令中，payload包含"如何发送？

  • 消息中内嵌的双引号请用\22 表达；
  • 控制字符 \r(0x0D)请用\0D 表达；
  • 控制字符\n（0x0A） 请用\0A 表达 如果是 MCU 发消息，请用\\22，\\0D，\\0A 来 表达，即\需要转义成\\

5、连接服务器失败

  • 检查下模块信号、网络注册、网络附着、PDP激活状态
  • 检查下SIM卡是否欠费
  • 使用mqtt.fx，连接服务器确认一下是否可以连接成功，排除服务器故障
  • 部分国外的开源项目提供免费的MQTT代理服务器，因为网络的原因，国内存在严重的延迟或者丢包现象，导致程序运行出现问题，此现象在AT开发时影响严重
  • 确认是不是域名解析失败导致，可以通过AT+CDNSGIP=确认一下域名是否能正常解析（注意：该命令只有在执行完at+cstt、at+ciicr、at+cifsr后才能正常工作），不能正常解析，可以通过AT+CDNSCFG=ip1,ip2设置域名解析服务器。
  • 在 MIPSTART /SSLMIPSTART返 回 CONNECT OK后 才 能 发 MCONNECT命令，而且要立即发，否则会被服务器踢掉。

6、数据接收缓存问题

  • 不缓存：通过AT+MQTTMSGSET=0设置；收到订阅的publish报文后，立即通过AT口输出主题、payload长度、payload内容，每个报文中支持的payload内容最长4100字节

  • 内存缓存：通过AT+MQTTMSGSET=1设置；内存中有一个缓存表，一条消息最多4kb，最多支持缓存4条publish报文；收到订阅的publish报文后，插入缓冲表中的空闲位置，然后通过AT口输出存储位置；缓存表满之后，新收到的publish报文会覆盖最旧的publish报文

注意：

缓存表位于内存中，断电或者重启后，缓存表中的数据会被清空；建议收到数据时，通过AT+MQTTMSGGET及时读取出来，以防缓冲区满覆盖丢失数据

7、数据发送问题
AT+MPUB最大publish 4100字节,AT+MPUBEX长度取值范围1-4100
个报文中支持的payload内容最长4100字节

本文同样适用于以下型号：
Air700ECQ/Air700EAQ/Air700EMQ
Air780EQ/Air780EPA/Air780EPT/Air780EPS
Air780E/Air780EX/Air724UG…

如有需要，请点击 www.openluat.com 获取联系方式

在这里插入图片描述
在这里插入图片描述

合宙LuatOS
关注
  • 25
    点赞
  • 踩
  • 11
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
Python的paho-mqtt客户端库使用例程
12-15
MQTT是一种轻量级、发布/订阅模式的网络协议，常用于物联网（IoT）、移动应用以及低带宽、高延迟或不稳定网络环境的数据通信。 在Python中，paho-mqtt库提供了简单易用的API，使得开发者能够方便地创建MQTT客户端，...
AIR724模块使用AT指令连接MQTT服务器代码示例
07-03
给出了从复位、查询信号、配置MQTT参数，建立TCP连接，开启MQTT会话、订阅和发送消息的示例代码
Air780E|物联网模组|AT命令|MQTT接入|云平台（1）-MQTT基本原理及AT步骤
Medlar_CN的博客
12-09 6255
AT固件是通信模组或者单片机（MCU）+ 网络模块标准固件的基本配置，该模式定制化程序较高，简单易上手，但缺点也较为明显，仅用于快速基本功能验证。 本系列主要探讨MQTT方式手动接入、信息订阅及发布的基本原理，后续详细介绍接入多种云平台的基本操作及手动鉴权步骤。
LuatOS-Air AT应用指南--MQTT指令流程
l531798151的博客
06-03 954
确认是不是域名解析失败导致，可以通过AT+CDNSGIP=确认一下域名是否能正常解析（注意：该命令只有在执行完at+cstt、at+ciicr、at+cifsr后才能正常工作），不能正常解析，可以通过AT+CDNSCFG=ip1,ip2设置域名解析服务器。AT+CIICR激活网络，在IP START的状态使用AT+CIICR激活网络，激活以后通过AT+CIFSR查询是否获取IP，如果成功就可以开始配置TCP连接了，如果不成功使用AT+CIPSHUT关闭移动网络，从AT+CSTT重新进行。
移远 EC200x/EC600x/EG912Y 4G 系列模组 AT 命令 MQTT 接入 ThingsCloud 云平台
thingscloud的博客
07-18 4758
移远 4G 系列模组的 AT 命令支持 MQTT，请参考以下步骤，只需几分钟就可以接入云平台并上报数据，还可以从云平台下发命令实现远程实时控制。
Air780E|移动|OneNET|AT命令|物联网|三元组|鉴权|算法|密钥生成|（5）-OneNET(中国移动物联网开放平台)手动接入步骤
Medlar_CN的博客
12-12 2477
本系列主要探讨MQTT手动接入OneNET(中国移动物联网开放平台)的基本操作及手动鉴权步骤、信息订阅及发布的基本原理。 参考阅读：物联网模组AT命令接入云平台（1）-MQTT基本原理及步骤
780EP模块 AT开发-MQTT应用指南
最新发布
2401_86441350的博客
07-26 729
4G模块支持MQTT和MQTT SSl协议， MQTT应用的基本流程如下：1、如果要支持SSL，配置SSL参数2、通过TCP连接到MQTT服务器3、发送MQTT CONNECT到服务器，打开会话连接4、订阅或者发布消息。
paho-mqtt.js
10-18
【标题】"paho-mqtt.js" 是一个用于在微信小程序中实现MQTT通信的JavaScript库。MQTT（Message Queuing Telemetry Transport）是一种轻量级的发布/订阅模式的网络协议，常用于物联网（IoT）设备之间的数据传输。在...
Laravel开发-laravel-mqtt-publish
08-28
`laravel-mqtt-publish`是一个专门为Laravel设计的MQTT（Message Queuing Telemetry Transport）发布服务器组件，它使得在Laravel应用中集成MQTT通信变得更加简单。MQTT是一种轻量级的发布/订阅协议，广泛用于物联网...
使用paho-mqtt-c做的mqtt通讯
08-12
`paho-mqtt-c`是Eclipse Paho项目的一部分，它提供了C语言版本的MQTT客户端接口，便于开发者在各种平台上进行MQTT应用的开发。 首先，让我们深入了解一下`paho-mqtt-c`库。这个库提供了完整的MQTT客户端功能，包括...
GPRS连接阿里云
12-27
使用GPRS模块，通过串口发送AT指令连接阿里云，实现IOT。
Air系列4G模块AT版本MQTT应用说明
默铭
07-26 4761
mqtt 4G模块AT版本如何使用MQTT 一、应用概述 4G模块支持MQTT和MQTT SSl协议， MQTT应用的基本流程如下： 1、激活PDP（参考：http://ask.openluat.com/article/937） 2、如果要支持SSL，配置SSL参数 3、通过TCP连接到MQTT服务器 4、发送MQTT CONNECT到服务器，打开会话连接 5、订阅或者发布消息 6、出现异常后：关闭TCP连接，有选择性
【安信可首款4G模组CA-01直连阿里物联网平台③】一型一密认证方式连接
安信可科技
07-13 1515
文章目录一.前言二、激活数据网络三、连接阿里云认证服务器，动态注册设备四、连接阿里云认证服务器，获取到接入服务器的用户名和密码五、连接阿里云接入服务器，收发自己的应用数据六. 收发应用数据 一.前言     一型一密安全认证方式下，同一产品下所有设备可以烧录相同固件（即烧录ProductKey和ProductSecret）。设备发送激活请求时，物联网平台进行身份确认，认证通过，下发该设备对应的DeviceSecret。 二、激活数据网络 **AT+CGATT?** +
Socket closed 异常解决方案：如何解决 JMeter 压测中的问题
qq_48811377的博客
01-03 1981
这些资料，对于【软件测试】的朋友来说应该是最全面最完整的备战仓库，这个仓库也陪伴上万个测试工程师们走过最艰难的路程，希望也能帮助到你！
STM32MP157实现串口接收数据上云-4G设备向云发送数据
Octopus1633的博客
08-25 2666
4G设备向云发送数据
物联网之“BC28 + ONENET + MQTT ”遇到的BUG和解决之法
晚点遇见你，余生都是你！
01-21 4224
首先说下NB卡，NB卡简称窄带物联卡，与4G卡不一样。 NB卡是低流量，多次数触发的，用NB卡的设备适合不移动、低功耗。而4G卡是大流量大数据的，使用该卡的设备适合移动型、偏远地区等。 再说下BC28这NB模块板子，全网通模组。我用的电信NB卡，秒入网秒连接onenet，有的大佬说移动的更适合，电信的会限制某些IP，这个情况没遇到过，所以不好下定论了。 做过NB模块的都知道，目前NB还未出现...
AT指令的发送与接收
weixin_44118217的博客
05-19 6996
AT指令的发送与接收存在问题现存代码运行结果 存在问题 1.接收数据未结束就进入检测环节，导致一直检测不到指定字符串。 解决办法： 接收到‘\n’以后才进入检测环节（用strstr进行对比），否则在while中进行等待。 2.接收失败以后未进行处理，导致接收错误以后卡死。 解决办法：使用switch case进行处理 现存代码 接收中断函数 void Uart2() interrupt 8 { IE2 &= ~0x01; //关闭串口2中断 if (S2CON & S2RI)
4G模块连接MQTT
热门推荐
rootuseres的博客
06-28 8万+
mqtt 作者：如果能编程回忆 最后修改时间：2020年6月12日 概述 Air724模块内置MQTT协议，提供AT，LUAT，CSDK，DTU可供选择使用，接口简单使用方便。 MQTT简介 优势：长连接，低带宽，高可靠。 实用场景：需要服务器下发消息给设备，需要及时收到。例如，远程开关，充电桩等 几个重要名词 username用户名，password密码，clientid用户标识，mqtt可以通过前两个参数保证连接的安全，通过clientid确保设备唯一性。 qos消息质量，分为0，1，2三个等级，
合宙 Luat Air724/7xx/8xx 4G 系列模组 AT 命令 MQTT 接入 ThingsCloud 云平台
thingscloud的博客
07-18 3482
合宙 4G CAT.1 系列模组的 AT 命令支持 MQTT，请参考以下步骤，只需几分钟就可以接入云平台并上报数据，还可以从云平台下发命令实现远程实时控制。
Quectel GSM/GPRS模块系列：GSM-MQTT应用笔记V1.2版详述
本资源是一份由Quectel公司发布的...总结来说，这份应用笔记为使用Quectel GSM/GPRS模块进行MQTT通信的开发者提供了宝贵的指南，帮助他们在物联网(IoT)领域中有效地管理设备间通信，减少维护成本，并充分利用网络资源。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值