SIM7500_SIM7600_SIM7800
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
SIM7500_SIM7600_SIM7800 Series_SSL_Application Note_V2.00
SIM7500_SIM7600_SIM7800 Series_SSL_Application Note
2.00
2020.8.6
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
2 / 10
SIM7500_SIM7600_SIM7800 Series_SSL_Application Note_V2.00
Version History
Version
V2.00
Date
2020.8.6
Owner
Yulong.Li
What is new
Update the format
www.simcom.com
3 / 10
SIM7500_SIM7600_SIM7800 Series_SSL_Application Note_V2.00
Contents
Version History.................................................................................................................................................... 3
Contents................................................................................................................................................................ 4
Introduction...................................................................................................................................................5
1.1 Purpose of the document................................................................................................................................5
1.
2. SSL Introduction.............................................................................................................................................6
2.1 Characteristic.................................................................................................................................................... 6
2.2 SSL Context Configuration............................................................................................................................. 6
2.3 SSL Commands Process................................................................................................................................ 7
3. AT Commands for SSL..................................................................................................................................8
4. Bearer Configuration.....................................................................................................................................9
4.1 Start SSL Service............................................................................................................................................. 9
www.simcom.com
4 / 10
SIM7500_SIM7600_SIM7800 Series_SSL_Application Note_V2.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.
www.simcom.com
5 / 10
SIM7500_SIM7600_SIM7800 Series_SSL_Application Note_V2.00
2. SSL Introduction
SSL feature includes SSL (Secure Socket Layer) and TLS (Transport Layer Security). It is used to transport
encrypted data based on TCP/IP protocol and SSL/TLS. SSL/TLS usually works between Transport Layer
and Application Layer.
2.1 Characteristic
Support multiple SSL contexts;
Support encrypted and unencrypted connections;
Unencrypted Connections
Module works as TCP clients.
It exchanges unencrypted data with TCP servers by TCP
connections.
Encrypted Connections
Module works as SSL clients. It exchanges encrypted data with SSL servers by TCP connections.
Support multiple data transmission mode;
Direct Push Mode
Host data will be sent to internal protocol stack and forwarded to air interface. Data received from
air interface will be transmitted to internal protocol stack and forwarded to COM ports.
Buffer Access Mode
Host data will be sent to internal protocol stack and forwarded to air interface. Data received from
air interface will be saved into local buffers. Host could retrieve buffer data by AT commands.
Transparent Access Mode
Host data will be directly sent to air interface. Data received from air interface will be directly sent to
COM ports.
2.2 SSL Context Configuration
www.simcom.com
6 / 10
SIM7500_SIM7600_SIM7800 Series_SSL_Application Note_V2.00
Step 1: Configure SSL version by AT+CSSLCFG=“sslversion”,
,.
Step 2: Configure SSL authentication mode by AT+CSSLCFG=“authmode”,, .
Step 3: Configure the flag of ignore local time by
AT+CSSLCFG=“ignorlocaltime”,,.
Step 4: Configure the max time in SSL negotiation stage by
AT+CSSLCFG=“negotiatetime”,,.
Step 5: Download the certificate into the module by AT+CCERTDOWN.
Step 6: Configure the server root CA by AT+CSSLCFG=“cacert”,,.
Step 7: Configure the client certificate by AT+CSSLCFG=“clientcert”,,.
Step 8: Configure the client key by AT+CSSLCFG=“clientkey”,,.
Step 10: Delete the certificate from the module by AT+CCERTDELE.
Step 11: List the certificates by AT+CCERTLIST.
2.3 SSL Commands Process
Step 1: Ensure GPRS network is available before performing SSL related operations.
Step 2: Configure the parameter of PDP context by AT+CGDCONT.
Step 3: Activate the PDP context to start SSL service by AT+CCHSTART.
Step 4: Configure SSL context by AT+CSSLCFG (if connect to SSL/TLS server).
Step 5: Set the SSL context used in SSL connection by AT+CCHSSLCFG (if connect to SSL/TLS server).
Step 6: Connect to the server by AT+CCHOPEN.
Step 7: Send data to the server by AT+CCHSEND.
Step 8: Receive data from server by AT+CCHRECV in manual receive mode.
Step 9: Disconnect from the server by AT+CCHCLOSE.
Step 10: Deactivate the PDP context to stop SSL service by AT+CCHSTOP.
www.simcom.com
7 / 10
SIM7500_SIM7600_SIM7800 Series_SSL_Application Note_V2.00
3. AT Commands for SSL
Command
AT+CCHSTART
AT+CCHSTOP
AT+CCHOPEN
AT+CCHCLOSE
AT+CCHSEND
AT+CCHRECV
AT+CCHADDR
AT+CCHSSLCFG
AT+CCHCFG
AT+CCHSET
AT+CSSLCFG
AT+CCERTDOWN
AT+CCERTDELE
AT+CCERTLIST
Description
Start SSL Service
Stop SSL Service
Setup SSL Client Socket Connections
Destroy SSL Client Socket Connections
Send SSL Data
Retrieve SSL Buffer Data
Get IP Address of PDP Context
Set SSL Context Index of SSL Connections
Set Context of SSL Connections
Set Mode of Sending and Receiving SSL Data
Configure SSL Context
Download Certificate Files into Module
Delete Certificate Files of Module
List Certificate Files of Module
For detail information, please refer to “SIM7080 Series_AT Command Manual_V1.00”.
www.simcom.com
8 / 10