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