Application
Simplify Communication
ile
lF
ia
nt
e
f id
on
C
om
C
SIM7080 Series_MQTT(S)_Application Note
M
Version:1.01
SI
Release Date:Feb 26, 2020
Simplify Communication
www.simcom.com
Simplify Communication
About Document
Document Information
ile
Document
lF
Title SIM7080 Series_MQTT(S)_Application Note
Version 1.01
Document Type Application Note
ia
Document Status Released/Confidential
nt
Revision History
Revision
1.00
Date
Sept 2, 2019
Owner
Zhiyuan.tang
e Status / Comments
First Release
id
1.01 Feb 26,2020 Wenjie.lai Add product types
f
Related Documents
on
[1] SIM7080 Series AT Command Manual V1.02
C
This document applies to the following products:
Name Type Size (mm) Comments
SIM7080G CAT-M/NB 17.6*15.7 *2.3 N/A
om
SIM7070G/SIM7070E CAT-M/NB/EGPRS 24*24*2.4 N/A
SIM7070G-NG NB/EGPRS 24*24*2.4 N/A
SIM7090G CAT-M/NB 14.8*12.8*2.0 N/A
C
Copyrights
M
This document contains proprietary technical information which is the property of SIMCom Wireless Solutions Co.,Ltd. Copying
of this document and giving it to others and the using or communication of the contents thereof, are forbidden without express
authority. Offenders are liable to the payment of damages. All rights reserved in the event of grant of a patent or the
SI
registration of a utility model or design. All specification supplied herein are subject to change without notice at any time.
SIM7080 Series_MQTT(S)_Application Note Page 2 / 10
Simplify Communication
Contents
ile
About Document ................................................................................................................... 2
Document Information.............................................................................................................. 2
Revision History ......................................................................................................................... 2
lF
Related Documents ................................................................................................................... 2
Copyrights ................................................................................................................................. 2
Contents ................................................................................................................................ 3
ia
1 Purpose of this document ............................................................................................... 4
nt
2 MQTT Introduction ......................................................................................................... 4
3 AT Commands for MQTT(S) ............................................................................................. 5
e
4
id
Bearer Configuration ...................................................................................................... 5
4.1 PDN Auto-activation ...................................................................................................... 5
f
5 MQTT(S) Samples ........................................................................................................... 6
on
5.1 MQTT Function.............................................................................................................. 6
5.2 MQTTS Function ............................................................................................................ 6
5.3 Connecting Ali Cloud Function ...................................................................................... 7
C
5.3.1 MQTT Connecting Ali Cloud Function ............................................................... 7
5.3.2 MQTTS Connecting Ali Cloud Function ............................................................. 8
Contact................................................................................................................................ 10
om
C
M
SI
SIM7080 Series_MQTT(S)_Application Note Page 3 / 10
Simplify Communication
1 Purpose of this document
Based on module AT command manual, this document will introduce MQTT application process.
ile
Developers could understand and develop application quickly and efficiently based on this
document.
lF
2 MQTT Introduction
ia
MQTT (Message Queue Telemetry Transport) is a messaging protocol based on the
nt
publish/subscribe paradigm under the ISO standard (ISO/IEC PRF 20922). It works on the TCP/IP
protocol suite and is a publish/subscribe messaging protocol designed for remote devices with
e
poor hardware performance and poor network conditions.
id
The MQTT protocol is a protocol designed for the communication of remote sensors and control
devices with limited computing power and working on low-bandwidth, unreliable networks. It
f
has the following main features:
on
1) Use the publish/subscribe message mode to provide one-to-many message publishing
and uncouple the application;
2) Message transmission for shielding the payload content;
C
3) Provide network connection using TCP/IP;
4) There are three types of message publishing service quality:
om
"At most once," message publishing relies entirely on the underlying TCP/IP network.
Message loss or duplication can occur. This level can be used in the following
situations, environmental sensor data, loss of a read record does not matter,
because there will be a second transmission in the near future.
C
"At least once" to ensure that the message arrives, but message duplication may occur.
M
"Only once" to ensure that the message arrives once. This level can be used in
situations where repeated or missing messages can result in incorrect results.
SI
5) small transmission, low overhead (fixed length of the head is 2 bytes), protocol
exchange is minimized to reduce network traffic;
6) Use the Last Will and Testament features to notify the parties about the mechanism of
client abort.
SIM7080 Series_MQTT(S)_Application Note Page 4 / 10
Simplify Communication
3 AT Commands for MQTT(S)
Command Description
AT+SMCONF Set MQTT Parameter
ile
AT+CSSLCFG SSL Configure
AT+SMSSL Select SSL Configure
lF
AT+SMCONN MQTT Connection
AT+SMPUB Send Packet
AT+SMSUB Subscribe Packet
AT+SMUNSUB Unsubscribe Packet
ia
AT+SMSTATE Inquire MQTT Connection Status
AT+SMPUBHEX Set SMPUB Data Format to Hex
nt
AT+SMDISC Disconnection MQTT
+SMSUB MQTT Receive Subscribe Data
e
For detail information, please refer to “SIM7080 Series_AT Command Manual”.
id
4 Bearer Configuration
f
on
Usually module will register PS service automatically.
C
4.1 PDN Auto-activation
AT Command Response Description
om
AT+CPIN? +CPIN: READY Check SIM card status
OK
AT+CSQ +CSQ: 27,99 Check RF signal
C
OK
AT+CGATT? +CGATT: 1 Check PS service. 1 indicates PS has
M
attached.
OK
SI
AT+COPS? +COPS: 0,0,"CHN-CT",9 Query Network information, operator
and network mode 9, NB-IOT network
OK
AT+CGNAPN +CGNAPN: 1,"ctnb" Query CAT-M or NB-IOT network after
the successful registration of APN
SIM7080 Series_MQTT(S)_Application Note Page 5 / 10
Simplify Communication
OK
AT+CNACT=0,1 OK Activating network bearing
+APP PDP: 0,ACTIVE
ile
5 MQTT(S) Samples
lF
5.1 MQTT Function
AT Command Response Description
ia
AT+CNACT=0,1 OK Open wireless connection parameter 0 is
PDP Index, parameter 1 means active.
nt
+APP PDP: 0,ACTIVE
AT+CNACT? +CNACT: 0,1,"10.94.36.44" Get local IP
+CNACT: 1,0,"0.0.0.0"
e
+CNACT: 2,0,"0.0.0.0"
+CNACT: 3,0,"0.0.0.0"
id
OK
f
AT+SMCONF="URL",117.131.85 OK Set up server URL
on
.139,6000
AT+SMCONF="KEEPTIME",60 OK Set MQTT time to connect server
AT+SMCONN OK
AT+SMSUB="information",1 OK Subscription packet
C
AT+SMPUB="information",5,1,1 OK Send packet, 5 is packet length.
>hello +SMSUB: "information","hello" Get data on server
AT+SMUNSUB="information" OK Unsubscription packet
om
AT+SMDISC OK Disconnect MQTT
AT+CNACT=0,0 OK Disconnect wireless
+APP PDP: 0,DEACTIVE
C
5.2 MQTTS Function
M
AT Command Response Description
AT+CNACT=0,1 OK Open wireless connection parameter 0 is
SI
PDP Index, parameter 1 means active.
+APP PDP: 0,ACTIVE
AT+CNACT? +CNACT: 0,1,"10.94.36.44" Get local IP
+CNACT: 1,0,"0.0.0.0"
+CNACT: 2,0,"0.0.0.0"
SIM7080 Series_MQTT(S)_Application Note Page 6 / 10
Simplify Communication
+CNACT: 3,0,"0.0.0.0"
OK
AT+CFSINIT OK Init FS AT command
AT+CFSWFILE=3,"ca.crt",0,2110, DOWNLOAD After download, sent certificate file
ile
1000 through the serial port.
OK 2110 is certificate size.
Send CA file success
lF
AT+CFSWFILE=3,"myclient.crt",0 DOWNLOAD Send cert file success
,2110,1000
OK
AT+CFSWFILE=3,"myclient.key", DOWNLOAD Send key file success
ia
0,2110,1000
OK
AT+CFSTERM OK Free data buffer
nt
AT+SMCONF="URL",117.131.85 OK Set up server URL
.139,6001
AT+SMCONF="KEEPTIME",60
AT+CSSLCFG="CONVERT",2,"ca.
OK
OK
e Set MQTT time to connect server
rootCA.pem is CA certificate
id
crt"
AT+CSSLCFG="CONVERT",1,"my OK cert.pem is certificate, key.pem is key of
client.crt","myclient.key" cert.pem
f
on
AT+SMSSL=1,"ca.crt","myclient. OK Set CA certificate and cert certificate
crt" name
AT+SMCONN OK
AT+SMSUB="information",1 OK Subscription packet
C
AT+SMPUB="information",5,1,1 OK Send packet, 5 is packet length.
>hello +SMSUB: "information","hello" Get data on server
AT+SMUNSUB="information" OK Unsubscription packet
om
AT+SMDISC OK Disconnect MQTT
AT+CNACT=0,0 OK Disconnect wireless
+APP PDP: 0,DEACTIVE
C
5.3 Connecting Ali Cloud Function
M
5.3.1 MQTT Connecting Ali Cloud Function
SI
AT Command Response Description
AT+CNACT=0,1 OK Open wireless connection parameter 0 is
PDP Index, parameter 1 means active.
+APP PDP: 0,ACTIVE
SIM7080 Series_MQTT(S)_Application Note Page 7 / 10
Simplify Communication
AT+CNACT? +CNACT: 0,1,"10.94.36.44" Get local IP
+CNACT: 1,0,"0.0.0.0"
+CNACT: 2,0,"0.0.0.0"
+CNACT: 3,0,"0.0.0.0"
ile
OK
AT+SMCONF="URL","a1kUAJknr OK The format of domain name is :
0y.iot-as-mqtt.cn-shanghai.aliy productKey.iot-as-mqtt.cn-shanghai.aliy
uncs.com",1883 uncs.com
lF
Note:
a1kUAJknr0y is product_key
AT+SMCONF="USERNAME","70 OK The format of username is:
ia
00C&a1kUAJknr0y" deviceName&productKey
Note:
a1kUAJknr0y is product_key
nt
7080 is device Name
AT+SMCONF="PASSWORD","56 OK The password is generated by SHA1
bf1f37de9ce2591f5699eea1117
a43dae9bd11"
e algorithm
AT+SMCONF="CLIENTID","a1kU OK
id The format of client id is:
AJknr0y.7080|securemode=3,ti productKey.deviceName|securemode=3,
mestamp=2524608000000,sign signmethod=hmacsha1,gw=0|
f
method=hmacsha1,gw=0|"
on
Note:
a1kUAJknr0y is product_key
7080 is deviceName
C
AT+SMCONN OK Connect ok
5.3.2 MQTTS Connecting Ali Cloud Function
om
AT Command Response Description
AT+CNACT=0,1 OK Open wireless connection parameter 0 is
PDP Index, parameter 1 means active.
C
+APP PDP: 0,ACTIVE
AT+CNACT? +CNACT: 0,1,"10.94.36.44" Get local IP
+CNACT: 1,0,"0.0.0.0"
M
+CNACT: 2,0,"0.0.0.0"
+CNACT: 3,0,"0.0.0.0"
SI
OK
AT+CSSLCFG="CONVERT",2,"alii OK Convert aliiot_ca.pem
ot_ca.pem" Note: Import certificates, please refer to
CFSWFILE command
SIM7080 Series_MQTT(S)_Application Note Page 8 / 10
Simplify Communication
AT+CSSLCFG="CONVERT",1,"sim OK Convert cert file
com.cert.pem","simcom.private
.key"
AT+SMCONF="URL","a1kUAJknr OK The format of domain name is :
0y.iot-as-mqtt.cn-shanghai.aliyu productKey.iot-as-mqtt.cn-shanghai.aliy
ile
ncs.com",1883 uncs.com
Note:
a1kUAJknr0y is product_key
AT+SMCONF="USERNAME","70 OK The format of username is:
lF
80&a1kUAJknr0y" deviceName&productKey
Note:
a1kUAJknr0y is product_key
ia
7080 is deviceName
AT+SMCONF="PASSWORD","56 OK The password is generated by SHA1
bf1f37de9ce2591f5699eea1117 algorithm
nt
a43dae9bd11"
AT+SMCONF="CLIENTID","a1kU OK The format of client id is:
AJknr0y.7080|securemode=3,ti
mestamp=2524608000000,sign
e
productKey.deviceName|securemode=3,
signmethod=hmacsha1,gw=0|
method=hmacsha1,gw=0|"
id
a1kUAJknr0y is product_key
7080 is deviceName
f
AT+SMSSL=2,"aliiot_ca.pem","si OK Configure SSL connect index
on
mcom.cert.pem"
AT+SMCONN OK Connect ok
C
om
C
M
SI
SIM7080 Series_MQTT(S)_Application Note Page 9 / 10
Simplify Communication
Contact
SIMCom Wireless Solutions Co.,Ltd
ile
Address: Building B, No.633 Jinzhong Road, Changning District, Shanghai P.R.China 200335
Tel: +86-21-31575126
lF
Support: [email protected]
ia
e nt
f id
on
C
om
C
M
SI
SIM7080 Series_MQTT(S)_Application Note Page 10 / 10
