Machine Translated by Google
SIM7028系列_MQTT(S)
_应用说明
低功率广域网模块
芯讯通无线解决方案有限公司中国上海长宁区临
虹路289号芯讯通总部大楼3号楼电话:86‑21‑31575100
support@simcom.com  
www.simcom.com
Machine Translated by Google
SIM7028系列_MQTT(S)_应用笔记_V1.03
文件名:
版本:
日期:
地位:
SIM7028系列_MQTT(S)_应用笔记
1.03
2022.12.09
已发布
一般注意事项
SIMCOM  将此信息作为服务提供给客户,以支持
使用  SIMCOM  设计的产品的应用和工程工作。
所提供的信息基于专门提供给以下人员的要求
SIMCOM  来自客户。  SIMCOM  尚未进行任何独立搜索
如需其他相关信息,包括可能包含在
客户的财产。此外,该产品的系统验证
SIMCOM  在更大的电子系统中设计仍然是责任
客户或客户的系统集成商的。所有规格
此处提供的内容可能会发生变化。
版权
本文档包含属于财产的专有技术信息
未经  SIMCOM  明确授权,禁止向其他人复制和使用本文档。违法者须承担以下责任:
赔偿金的支付。  SIMCOM  保留所有权利
技术信息,包括但不限于  A  的注册授予
专利、实用新型或设计。此处提供的所有规格均受
随时更改,恕不另行通知。
芯讯通无线科技有限公司
上海长宁区临虹路289号芯讯通总部大楼3号楼
中国
电话:+86  21  31575100
电子邮件:simcom@simcom.com
欲了解更多信息,请访问:
https://www.simcom.com/download/list‑863‑en.html
如需技术支持或报告文档错误,请访问:
https://www.simcom.com/ask/或发送电子邮件至:support@simcom.com
版权所有  ©  2022  芯讯通无线科技有限公司  保留所有权利。
www.simcom.com
1/40
Machine Translated by Google
关于文档
SIM7028系列_MQTT(S)_应用笔记_V1.03
版本历史
修订日期
V1.00
V1.01
V1.02
V1.03
章节
全部
全部
2022年5月12日
2022年5月31日
2022.07.06  全部
2022.10.24  全部
描述
新版本
更新文件
更新一些描述
添加详细信息
范围
本文档可应用于以下模块。
名称  型号  尺寸(mm)
SIM7028  NB2  17.6*15.7
评论
频段  1/2/3/4/5/8/12/13/14/17/18/19/20/25/26/28/66/70/85
www.simcom.com
2/40
Machine Translated by Google
内容
SIM7028系列_MQTT(S)_应用笔记_V1.03
关于文档................................................ ...................................................... ......................  2
版本历史................................................ ...................................................... ......................................2范
围...................... ...................................................... ...................................................... ......................................................  2
内容................................................ ...................................................... ......................................  3
1简介................................................................ ...................................................... ......................................  5
1.1  本文件的目的................................................ ...................................................... ............  5
1.2  相关文件................................................................ ...................................................... ......................................5
1.3  约定和缩写................................................................ ...................................................... ..................5
1.4  AT  命令语法................................................................ ...................................................... ......................................  6  1.4.1  基本语
法................................ ...................................................... ......................................................  6  1.4.2  S  参数语
法.................................. ...................................................... ......................................6  1.4.3  扩展语
法................................ ...................................................... ...................................................... ......  6  1.4.4  在同一命令行上组合  AT  命
令.................................. ......................................7  1.4.5  在单独的行中输入连续的  AT  命
令................................. ......................................................7
1.5  AT  命令定义................................................................ ...................................................... ......................................  7
2  MQTT(S)简介...................................................... ...................................................... ........................  8  2.1  MQTT(S)简
3  MQTT(S)的  AT  命令................................................. ......................................................  10  3.1概
介................................................ ...................................................... ................................................8  2.2  MQTT(S)  AT  命令使用流
程。 ...................................................... ................................9
述................................................. ...................................................... ................................................10
3.2  命令详细说明................................................ ...................................................... ...  10  3.2.1  AT+CMQTTSTART  启动  MQTT  服
务................................................ ................................................  10  3.2.2  AT+CMQTTSTOP  停止  MQTT服
务................................................ ......................................  11  3.2.3  AT+CMQTTACCQ  获取客户
端.................................. ...................................................... ......................................  12  3.2.4  AT+CMQTTREL  释放客户
端...................... ...................................................... ......................  14  3.2.5  AT+CMQTTSSLCFG  设置  SSL  上下文(仅适用于  SSL/
TLS  MQTT)...... .................................15  3.2.6  AT+CMQTTWILLTOPIC  输入遗嘱消息主
题................................. ......................................................16  3.2.7  AT+CMQTTWILLMSG  输入遗嘱消息................................................  
17  3.2.8  AT+CMQTTCONNECT  连接  MQTT服务器................................. ......................................................  18
3.2.9  AT+CMQTTDISC  断开与服务器的连接......................................... ......................................  20  3.2.10  AT+CMQTTTOPIC  输入发
布消息的主题... ......................................................  21  3.2.11  AT+CMQTTPAYLOAD  输入发布消息....................................... ......................  
22  3.2.12  AT+CMQTTPUB  向服务器发布消息................................. ......................................................24  3.2.13  AT+CMQTTSUB  向
服务器订阅消息....................................... ......................  25  3.2.14  AT+CMQTTUNSUB  取消订阅服务器消
息...................... ...................................27  3.2.15  AT+CMQTTCFG  配置  MQTT上下文... ...................................................... ...................28  
3.3  命令结果代码................................................. ...................................................... ......................................  30
3.3.1  说明................................................. ......................................................  30  3.3.2  主动结果代
码................................ ...................................................... ......................................31
www.simcom.com
3/40
Machine Translated by Google
SIM7028系列_MQTT(S)_应用笔记_V1.03
4  MQTT(S)示例...................................................... ...................................................... ..................  34  4.1  在不使用  SSL/TLS  的情况下连接到  
MQTT  代理....................................... ...................................................... ......  34
4.2  连接到  SSL/TLS  MQTT  服务器(不验证服务器)................................................ ......................................  36  4.3  访问  SSL/TLS  MQTT  
Broker(仅验证服务器).. ...................................................... ............  37  4.4  访问  SSL/TLS  MQTT  Broker(验证服务器和客户
端)................................. ......................................  39
www.simcom.com
4/40
Machine Translated by Google
SIM7028系列_MQTT(S)_应用笔记_V1.03
1简介
1.1  文件的目的
本文档以模块AT指令手册为基础,介绍了SIM7028系列模块上的MQTTS应用流程,开发者可以根据本文档快速、高效地理解和开发应
用。
1.2  相关文件
[1]  SIM7028系列_AT命令手册
1.3  约定和缩写
在本文档中,GSM  引擎被称为以下术语:  ME(移动设备);    MS(移动站);    TA
(终端适配器);    DCE(数据通
信设备)或传真DCE(传真调制解
调器、传真板卡);
在应用中,控制设备通过其串行接口发送AT命令来控制GSM引擎。
串行线另一端的控制设备称为以下术语:
  TE(终端设备);    DTE(数据终
端设备)或简单地说是在嵌入式设备上运行的“应用程序”
系统;
其他公约:
  MQTT(消息队列遥测传输);    SSL(安全套接字层);    
PDP(分组数据协议);
www.simcom.com
5/40
Machine Translated by Google
1.4  AT命令语法
SIM7028系列_MQTT(S)_应用笔记_V1.03
必须在每个命令行的开头设置“AT”或“at”或“aT”或“At”前缀。终止一个
命令行输入。
命令通常后面跟着一个响应,其中包括。  “<响应>”
在本文档中,仅呈现响应,被有意省略。
1.4.1  基本语法
这些  AT  命令的格式为“AT”或“AT&”,其中“”是命令,并且
“”是该命令的参数。一个例子是“ATE”,它告诉  DCE
是否根据“”的值将接收到的字符回显给DTE 。  “”是
可选,如果缺少,将使用默认值。
1.4.2  S  参数语法
这些  AT  命令的格式为“ATS=”,其中“”是要设置的S寄存器的索引,  “”是要分配给它的值。  “”
是可选的;如果缺少,则分配默认值。
1.4.3  扩展语法
这些命令可以在多种模式下运行,如下表所示:
表  1:AT  命令和响应的类型
测试命令
AT+=?
读命令
AT+?
写命令
AT+=<⋯>
执行命令
移动设备返回设置的参数及取值范围列表
使用相应的写入命令或通过内部进程。
该命令返回参数的当前设置值或
参数。
该命令设置用户可定义的参数值。
执行命令读取受以下影响的非变量参数
www.simcom.com
6/40
Machine Translated by Google
AT+
GSM  引擎的内部流程。
1.4.4  在同一命令行上组合  AT  命令
SIM7028系列_MQTT(S)_应用笔记_V1.03
您可以在同一行输入多个  AT  命令。在这种情况下,您不需要在每个命令之前键入“AT”或“at”前缀。相反,您只需在命令行开头键入“AT”或“at”即
可。
请注意扩展命令后使用分号作为命令分隔符;基本语法或  S
参数语法,分号不用输入,例如:
ATE1Q0S0=1S3=13V1X4;+IFC=0,0;+IPR=115200。
命令行缓冲区最多可以接受  559  个字符(从第一个命令开始计算)
不带“AT”或“at”前缀)或  39  个  AT  命令。如果输入的字符超过此数量,则无
该命令将被执行,TA  将返回“ERROR”。
1.4.5  在单独的行中输入连续的  AT  命令
当您需要分行输入一系列  AT  命令时,请注意,您需要等待
您输入之前输入的最后一个  AT  命令的最终响应(例如  OK、CME  错误、CMS  错误)
下一个  AT  命令。
1.5  AT命令定义
  回车符
  换行符
  <..>
  [..]
参数名称。尖括号不出现在命令行上
选项参数。方括号不会出现在命令行上。
www.simcom.com
7/40