SIM7020系列_MQTT(S)
_应用文档
LPWA Module
芯讯通无线科技(上海)有限公司
上海市长宁区金钟路633号晨讯科技大楼B座6楼
电话:86-21-31575100
技术支持邮箱:support@simcom.com
官网:www.simcom.com
SIM7020系列_MQTT(S)_应用文档_V1.05
名称:
版本:
日期:
状态:
SIM7020系列_MQTT(S)_应用文档
1.05
2020.6.10
发布
版权声明
本手册包含芯讯通无线科技(上海)有限公司(简称:芯讯通)的技术信息。除非经芯讯通书面许可,任何
单位和个人不得擅自摘抄、复制本手册内容的部分或全部,并不得以任何形式传播,违反者将被追究法律责
任。对技术信息涉及的专利、实用新型或者外观设计等知识产权,芯讯通保留一切权利。芯讯通有权在不通
知的情况下随时更新本手册的具体内容。
本手册版权属于芯讯通,任何人未经我公司书面同意进行复制、引用或者修改本手册都将承担法律责任。
芯讯通无线科技(上海)有限公司
上海市长宁区金钟路 633 号晨讯科技大楼 B 座 6 楼
电话:86-21-31575100
邮箱:simcom@simcom.com
官网:www.simcom.com
了解更多资料,请点击以下链接:
http://cn.simcom.com/download/list-230-cn.html
技术支持,请点击以下链接:
http://cn.simcom.com/ask/index-cn.html 或发送邮件至 support@simcom.com
版权所有 © 芯讯通无线科技(上海)有限公司2020,保留一切权利。
www.simcom.com 2 / 19
SIM7020系列_MQTT(S)_应用文档_V1.05
关于文档
版本历史
作者
备注
第一版.
版本 日期
V1.00
V1.01
V1.03
V1.04
V1.05
2018.04.10 徐晓辉
2018.06.07 Albert Meng
2019.05.10 徐晓辉/来文洁 增加 MQTT 的介绍和 SSL 示例
2019.09.09 徐晓辉
2020.03.24 徐晓辉
增加 MQTT 连接 Azure IoT
所有
修正版面
适用范围
本文档适用于以下产品型号:
尺寸(mm) 备注
型号
类别
17.6*15.7
SIM7020C NB1
17.6*15.7
SIM7020E NB1
NB1
SIM7030
16*18
NB1+GNSS 24*24
SIM7060
SIM7020G NB2
SIM7060G NB2+GNSS 24*24
17.6*15.7
Band 1/3/5/8
Band 1/3/5/8/20/28
Band 1/3/5/8
Band 5/8
Band 1/2/3/4/5/8/12/13/17/18/19/20/25/26/28/66/70/71/85
Band 1/2/3/4/5/8/12/13/17/18/19/20/25/26/28/66/70/71/85
www.simcom.com 3 / 19
SIM7020系列_MQTT(S)_应用文档_V1.05
目录
版权声明 .................................................................................................................................. 2
关于文档 .................................................................................................................................. 3
版本历史 ................................................................................................................................................ 3
适用范围 ................................................................................................................................................ 3
目录 .......................................................................................................................................... 4
1 介绍 ................................................................................................................................... 5
1.1 本文目的 ..................................................................................................................................... 5
1.2 参考文档 ..................................................................................................................................... 5
1.3 术语和缩写 .................................................................................................................................. 5
2 MQTT 介绍 ........................................................................................................................ 6
3 MQTT 相关 AT 指令 ........................................................................................................... 7
4 网络承载配置 ..................................................................................................................... 8
4.1 PDN 自激活 ................................................................................................................................ 8
4.2 手动改变 APN 配置 ..................................................................................................................... 9
5 MQTT 同步模式 .............................................................................................................. 10
6 MQTT 业务流程 ............................................................................................................... 11
6.1 MQTT 连接一般 MQTT 服务器 ................................................................................................. 11
6.2 MQTT 连接阿里云 .................................................................................................................... 11
7 MQTTS 业务流程 ............................................................................................................ 13
7.1 使用 AT+CSETCA 设置证书的方式连接 ................................................................................... 13
7.2 MQTTS 连接 Azure IoT ........................................................................................................... 16
www.simcom.com 4 / 19
SIM7020系列_MQTT(S)_应用文档_V1.05
1 介绍
1.1 本文目的
基于 AT 指令手册扩展,本文主要介绍 MQTT(S)的业务流程。
参考此应用文档,开发者可以很快理解并快速开发相关业务。
1.2 参考文档
[1] SIM7020 Series_AT Command Manual
1.3 术语和缩写
www.simcom.com 5 / 19
SIM7020系列_MQTT(S)_应用文档_V1.05
2 MQTT 介绍
MQTT(消息队列遥测传输)是 ISO 标准(ISO/IEC PRF 20922)下基于发布/订阅范式的消息协议。它工作在
TCP/IP 协议族上,是为硬件性能低下的远程设备以及网络状况糟糕的情况下而设计的发布/订阅型消息协议。
MQTT 协议是为大量计算能力有限,且工作在低带宽、不可靠的网络的远程传感器和控制设备通讯而设计的
协议,它具有以下主要的几项特性:
1) 使用发布/订阅消息模式,提供一对多的消息发布,解除应用程序耦合;
2) 对负载内容屏蔽的消息传输;
3) 使用 TCP/IP 提供网络连接;
4) 有三种消息发布服务质量:
“至多一次”,消息发布完全依赖底层 TCP/IP 网络。会发生消息丢失或重复。这一级
别可用于如下情况,环境传感器数据,丢失一次读记录无所谓,因为不久后还会有第二
次发送。
“至少一次”,确保消息到达,但消息重复可能会发生。
“只有一次”,确保消息到达一次。这一级别可用于如下情况,在计费系统中,消息重
复或丢失会导致不正确的结果。
5) 小型传输,开销很小(固定长度的头部是 2 字节),协议交换最小化,以降低网络流量;
6) 使用 Last Will 和 Testament 特性通知有关各方客户端异常中断的机制。
www.simcom.com 6 / 19
SIM7020系列_MQTT(S)_应用文档_V1.05
.
3 MQTT 相关 AT 指令
Command
AT+CMQNEW
AT+CMQCON
AT+CMQDISCON
AT+CMQSUB
AT+CMQUNSUB
AT+CMQPUB
+CMQDISCON
AT+CMQALICFG
AT+CMQALICON
AT+CMQTTSNEW
AT+CMQTTSNEWEXT
AT+CMQAZURECFG
AT+CMQAZURECON
AT+CMQTSYNC
Description
New MQTT
Send MQTT Connection Packet
Disconnect MQTT
Send MQTT Subscribe Packet
Send MQTT Unsubscribe Packet
Send MQTT Publish Packet
MQTT Disconnect Indication
Configure Alibaba Clound Parameters
Send MQTT Connection Packet to Alibaba Cloud
New MQTTS
New a MQTTS Instance by Multi Packages for a Long Size Command
Configure Microsoft Azure IoT Parameters
Send MQTT Connection Packet to Azure IoT
Configure MQTT Synchronization Mode
更多的 AT 指令信息,请参考“SIM7020 Series_AT Command Manual”.
www.simcom.com 7 / 19
SIM7020系列_MQTT(S)_应用文档_V1.05
4 网络承载配置
模块开机会自动激活 PDN 并获取 PS 业务地址。前提是数据卡和天线正常。
4.1
PDN 自激活
//检查 SIM 卡状态
//检查射频信号
//查询 PS 业务附着
//PDN 自激活例子
AT+CPIN?
+CPIN: READY
OK
AT+CSQ
+CSQ: 20,0
OK
AT+CGREG?
+CGREG: 0,1
OK
AT+CGACT?
+CGACT: 1,1
OK
AT+COPS?
+COPS: 0,2,"46000",9
OK
AT+CGCONTRDP
+CGCONTRDP:
1,5,"cmnbiot","100.80.73.123.255.255.255.0"
OK
// PDN 激活成功
//查询网络信息,运营商及网络制式
//9 即 NB-IOT 网络
//查询网络下发 APN 和分配的 IP 地址
www.simcom.com 8 / 19