A7600 Series_
SSL_Application Note
LTE Module
SIMCom Wireless Solutions Limited
Building B, SIM Technology Building, No.633, Jinzhong Road
Changning District, Shanghai P.R. China
Tel: 86-21-31575100
support@simcom.com
www.simcom.com
A7600 Series_SSL_Application Note_V1.00
A7600 Series_SSL_Application Note
1.00
2020.6.19
Released
Document Title:
Version:
Date:
Status:
GENERAL NOTES
SIMCOM OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS, TO SUPPORT
APPLICATION AND ENGINEERING EFFORTS THAT USE THE PRODUCTS DESIGNED BY SIMCOM.
THE INFORMATION PROVIDED IS BASED UPON REQUIREMENTS SPECIFICALLY PROVIDED TO
SIMCOM BY THE CUSTOMERS. SIMCOM HAS NOT UNDERTAKEN ANY INDEPENDENT SEARCH
FOR ADDITIONAL RELEVANT INFORMATION, INCLUDING ANY INFORMATION THAT MAY BE IN THE
CUSTOMER’S POSSESSION. FURTHERMORE, SYSTEM VALIDATION OF THIS PRODUCT
DESIGNED BY SIMCOM WITHIN A LARGER ELECTRONIC SYSTEM REMAINS THE RESPONSIBILITY
OF THE CUSTOMER OR THE CUSTOMER’S SYSTEM INTEGRATOR. ALL SPECIFICATIONS
SUPPLIED HEREIN ARE SUBJECT TO CHANGE.
COPYRIGHT
THIS DOCUMENT CONTAINS PROPRIETARY TECHNICAL INFORMATION WHICH IS THE PROPERTY
OF SIMCOM WIRELESS SOLUTIONS LIMITED COPYING, TO OTHERS AND USING THIS DOCUMENT,
ARE FORBIDDEN WITHOUT EXPRESS AUTHORITY BY SIMCOM. OFFENDERS ARE LIABLE TO THE
PAYMENT OF INDEMNIFICATIONS. ALL RIGHTS RESERVED BY SIMCOM IN THE PROPRIETARY
TECHNICAL INFORMATION ,INCLUDING BUT NOT LIMITED TO REGISTRATION GRANTING OF A
PATENT , A UTILITY MODEL OR DESIGN. ALL SPECIFICATION SUPPLIED HEREIN ARE SUBJECT TO
CHANGE WITHOUT NOTICE AT ANY TIME.
SIMCom Wireless Solutions Limited
Building B, SIM Technology Building, No.633 Jinzhong Road, Changning District, Shanghai P.R. China
Tel: +86 21 31575100
Email: simcom@simcom.com
For more information, please visit:
https://www.simcom.com/download/list-863-en.html
For technical support, or to report documentation errors, please visit:
https://www.simcom.com/ask/ or email to: support@simcom.com
Copyright © 2020 SIMCom Wireless Solutions Limited All Rights Reserved.
www.simcom.com 1 / 25
A7600 Series_SSL_Application Note_V1.00
About Document
Version History
Version
V1.00
Date
2020.06.19
Chapter
What is new
New version
Scope
This document presents the AT Command Set for SIMCom A7600 Series, including A7600XX-XXXX,
A5360E, and A7670X.
www.simcom.com 2 / 25
A7600 Series_SSL_Application Note_V1.00
Contents
About Document .................................................................................................................... 2
Version History ...................................................................................................................................... 2
Scope .................................................................................................................................................... 2
Contents ................................................................................................................................. 3
Introduction ...................................................................................................................... 4
1
1.1 Purpose of the document ................................................................................................................. 4
1.2 Related documents .......................................................................................................................... 4
1.3 Conventions and abbreviations ....................................................................................................... 4
1.4 The process of SSL AT Commands ................................................................................................. 5
1.5 Error Handling.................................................................................................................................. 6
1.5.1 Failed to Open SSL Connection ............................................................................................ 6
2 AT Commands for SSL .................................................................................................... 7
3 SSL Examples .................................................................................................................. 8
3.1 Access to TCP server ...................................................................................................................... 8
3.2 Access to SSL/TLS server (not verify server and client) ................................................................ 10
3.3 Access to SSL/TLS server (only verify the server) ......................................................................... 12
3.4 Access to SSL/TLS server (verify server and client) ...................................................................... 14
3.5 Access to SSL/TLS server (only verify the client) .......................................................................... 16
3.6 Access to SSL/TLS server in transparent mode ............................................................................ 18
3.7 Download certificate into module ................................................................................................... 20
4 Appendix ........................................................................................................................ 24
4.1 Result codes and unsolicited codes ............................................................................................... 24
4.1.1 Command result codes .............................................................................................. 24
4.1.2 Unsolicited result codes ....................................................................................................... 24
www.simcom.com 3 / 25
A7600 Series_SSL_Application Note_V1.00
1 Introduction
1.1 Purpose of the document
Based on module AT command manual, this document will introduce SSL application process.
Developers could understand and develop application quickly and efficiently based on this document.
1.2 Related documents
[1] A7600 Series_AT Command Manual
1.3 Conventions and abbreviations
PDP Packet Data Protocol;
SSL Security Socket Layer;
URC Unsolicited result codes;
DNS Domain Name Server;
www.simcom.com 4 / 25
A7600 Series_SSL_Application Note_V1.00
1.4 The process of SSL AT Commands
SIM Card Status:
Execute AT+CPIN?,if response is
+CPIN:READY,means SIM Card Status is
normal.Reboot the module or check SIM
card status if AT+CPIN? Fails to identify
SIM card in 20s.
Signal quality:
Execute AT+CSQ to query signal quality.If
rssi is equals to 99,please check SIM card
status or reboot the module
CS Service:
If
of AT+CREG? equals to 1,it means
that the module has registered on CS
domain service.Reboot the module if it
fails to registered on CS domain.
PS Serivce:
If of AT+CGREG?/AT+CEREG? equals
to 1,it means that the module has
registered on PS domain service.
Power on the module
Check the status of SIM card or
Reboot the module
Query SIM card status by
AT+CPIN?
+CPIN: READY
Query signal quality by AT+CSQ
+CSQ: ,,0 < rssi < 31
Query CS service by AT+CREG?
+CREG: 0,1
Query PS service by
AT+CGREG?/AT+CEREG?
UE system information:
If is “NO SERVICE”,it
means network status has some problem.
Query UE information by
AT+CPSI?
NO SERVICE
1.Configure PDP Context by
AT+CGDCONT=,,
2.Activate the PDP Context by
AT+CGACT=,[]
3.Query IP address of the PDP context by
PDP Context:
AT+CGACT?
Configure the PDP context
by AT+CGDCONT
Active the PDP context by
AT+CGACT=,[] and
AT+CGACT?
PDP ACTIVE FAIL
Download certificate
into module
Download certificate
into the module by
AT+CCERTDOWN=,
Configure the certificate
Configure the SSL
Context by
AT+CSSLCFG
Manage and list the
certificate
List certificates
by AT+CCERTLIST
Delete certificates by
AT+CCERTDELE
If use SSL,configure
the SSL context
before the other
operation
Configure the report mode
of sending and receiving
data by AT+CCHSET
Before CCH set the
report mode
Configure the mode of sending and
receiving data by AT+CCHMODE
Before CCH set the
transparent mode
If
AT+CCHMODE
=1 will ignore
the AT+CCHSET
Y
AT+CCHMODE=1?
N
Before the
operation of CCH
should excute
AT+CCHSTART
Start SSL service and
active PDP context
by AT+CCHSTART
Set the SSL context by
AT+CCHSSLCFG
connect the server by
AT+CCHOPEN=, ””,[,[]]
Send data directly
after showed below
words
CONNECT 115200
Get the IPv4
address after
calling
AT+CCHSTART by
AT+CCHADDR
Start SSL service and
active PDP context by
AT+CCHSTART
Set the SSL context by
AT+CCHSSLCFG
connect the server by
AT+CCHOPEN=, ””,[,[]]
Quit transparent
mode by +++
Enter transparent
mode by ATO
Disconnect from server by
AT+CCHCLOSE=
Stop SSL service
by AT+CCHSTOP
NO
Report the recv
data directly
Send data by
AT+CCHSEND=,
AT+CCHSET=1,1?
or
AT+CCHSET=0,1?
Disconnect from
server by
AT+CCHCLOSE=
Judge the
report mode is
on or not
YES
Read the cached data that
received from the server by
AT+CCHRECV=
[,]
After operation
of CCH ,close
the session
Stop SSL service by
AT+CCHSTOP
Stop the SSL
service and
deactive PDP
www.simcom.com 5 / 25
A7600 Series_SSL_Application Note_V1.00
1.5 Error Handling
1.5.1 Failed to Open SSL Connection
If it is failed to open SSL connection, please check the following aspects:
1. Query the status of the specified PDP context by AT+CGACT? command to check whether the
specified PDP context has been activated.
2. Please check the SSL configuration by AT+CSSLCFG? command, especially the SSL version and
cipher suite
3.When the CCHXXX: is not 0, it indicates an error code replied from CCH server.
For more details, please refer to A7600 Series_AT Command Manual _V1.01.09.
www.simcom.com 6 / 25
A7600 Series_SSL_Application Note_V1.00
2 AT Commands for SSL
Command
AT+CSSLCFG
AT+CCERTDOWN
AT+CCERTLIST
AT+CCERTDELE
AT+CCHSET
AT+CCHMODE
AT+CCHSTART
AT+CCHSTOP
AT+CCHADDR
AT+CCHSSLCFG
AT+CCHCFG
AT+CCHOPEN
AT+CCHCLOSE
AT+CCHSEND
AT+CCHRECV
For more detailed information, please refer to A7600 Series_AT Command Manual.
Description
Configure the SSL Context
Download certificate into the module
List certificates
Delete certificates
Configure the report mode of sending and receiving data
Configure the mode of sending and receiving data
Start SSL service
Stop SSL service
Get the IPv4 address
Set the SSL context
Configure the Client Context
Connect to server
Disconnect from server
Send data to server
Read the cached data that received from the server
www.simcom.com 7 / 25