SIM7070_SIM7080_SIM7090
Series_HTTP(S)
_Application Note
LPWA 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
SIM7070_SIM7080_SIM7090 Series_HTTP(S)_Application Note_V1.02
SIM7070_SIM7080_SIM7090 Series_HTTP(S)_Application Note
1.02
2020.7.8
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 / 21
SIM7070_SIM7080_SIM7090 Series_HTTP(S)_Application Note_V1.02
About Document
Version History
Version Date
V1.00
V1.01
V1.02
2019.9.16
2019.11.7
2020.7.8
Owner
Jiangting.Ding
Jiangting.Ding
Wenjie.Lai
What is new
First Release
Change AT+SHBOD
All
Scope
This document applies to the following products
Name
SIM7080G
SIM7070G/SIM7070E
SIM7070G-NG
SIM7090G
Type
CAT-M/NB
CAT-M/NB/GPRS
NB/GPRS
CAT-M/NB
Size(mm)
17.6*15.7*2.3
24*24*2.4
24*24*2.4
14.8*12.8*2.0
Comments
N/A
N/A
N/A
N/A
www.simcom.com
3 / 21
SIM7070_SIM7080_SIM7090 Series_HTTP(S)_Application Note_V1.02
Contents
About Document.................................................................................................................................. 3
Version History.........................................................................................................................................................3
Scope........................................................................................................................................................................ 3
Contents................................................................................................................................................. 4
Introduction.................................................................................................................................... 5
1
Purpose of the document...........................................................................................................................5
1.1
Related documents.....................................................................................................................................5
1.2
Conventions and abbreviations................................................................................................................ 5
1.3
2 HTTP Introduction.........................................................................................................................6
Characteristic...............................................................................................................................................6
Request Method.......................................................................................................................................... 7
3 AT Commands for HTTP(S)........................................................................................................ 8
4 Bearer Configuration....................................................................................................................9
PDN Auto-activation....................................................................................................................................9
APN Manual Configuration......................................................................................................................10
5 HTTP(S) Examples......................................................................................................................12
HTTP Function.......................................................................................................................................... 12
HTTP GET..................................................................................................................................... 12
HTTP POST...................................................................................................................................13
HTTPS Function........................................................................................................................................16
HTTPS download and convert SSL certificate........................................................................ 16
HTTPS GET...................................................................................................................................17
HTTPS POST................................................................................................................................18
5.2.1
5.2.2
5.2.3
5.1.1
5.1.2
2.1
2.2
4.1
4.2
5.1
5.2
www.simcom.com
4 / 21
SIM7070_SIM7080_SIM7090 Series_HTTP(S)_Application Note_V1.02
1 Introduction
1.1 Purpose of the document
Based on module AT command manual, this document will introduce HTTP(S) application process.
Developers could understand and develop application quickly and efficiently based on this document.
1.2 Related documents
[1] SIM7070_SIM7080_SIM7090 Series_AT Command Manual
[2] SIM7070_SIM7080_SIM7090 Series_SSL_Application Note
[3] RFC2616
1.3 Conventions and abbreviations
In this document, the GSM engines are referred to as following term:
ME (Mobile Equipment);
MS (Mobile Station);
TA (Terminal Adapter);
DCE (Data Communication Equipment) or facsimile DCE (FAX modem, FAX board);
In application, controlling device controls the GSM engine by sending AT Command via its serial interface.
The controlling device at the other end of the serial line is referred to as following term:
TE (Terminal Equipment);
DTE (Data Terminal Equipment) or plainly "the application" which is running on an embedded system;
www.simcom.com
5 / 21
SIM7070_SIM7080_SIM7090 Series_HTTP(S)_Application Note_V1.02
2 HTTP Introduction
HTTP (HyperText Transfer Protocol) is an application layer protocol. When you browse a web page, the
browser and the web server will send and receive data on the Internet through the HTTP protocol. HTTP is
a stateless protocol based on request and response patterns. That
is what we usually call
Request/Response.
2.1 Characteristic
Support client/server mode;
Simple and fast
When a client requests a service from a server, it only needs to pass the request method and path. Because
the HTTP protocol is simple, the program size of the HTTP server is small, and the communication speed is
fast.
Flexible
HTTP allows the transfer of any type of data object. The type being transferred is marked by Content-Type.
No connection
No connection means limiting the processing of only one request per link. After the server processes the
client's request and receives the customer's response, the server disconnects the link. This way, the
transmission time can be saved.
Stateless
The HTTP protocol is a stateless protocol. Stateless means that the protocol has no memory for transaction
processing. A lack of state means that if subsequent processing requires the previous information, it must
be retransmitted, which may result in an increase in the amount of data transferred per connection. On the
other hand, it responds faster when the server does not need previous information.
www.simcom.com
6 / 21
SIM7070_SIM7080_SIM7090 Series_HTTP(S)_Application Note_V1.02
2.2 Request Method
According to the HTTP standard, HTTP requests can use a variety of request methods.
HTTP 1.0 defines three request methods: the GET, POST, and HEAD methods.
HTTP1.1 adds six new request methods: OPTIONS, PUT, PATCH, DELETE, TRACE, and CONNECT
methods.
No Method
1
GET
2
3
4
5
6
7
8
9
HEAD
POST
PUT
DELETE
CONNECT
OPTIONS
TRACE
PATCH
Description
Make a request to a specific resource.
Ask the server for a response that is consistent with the GET request, except
that the response body will not be returned. This method can obtain the meta
information contained in the response message header without having to
transmit the entire response content.
Submit data to a specified resource for processing requests (such as submitting
a form or uploading a file). The data is included in the request body. POST
requests may result in the creation of new resources and/or modifications to
existing resources.
Uploads its latest content to a specified resource location.
Requests the server to delete the resource identified by the Request-URI.
H The HTTP/1.1 protocol
connections to pipes.
Returns the HTTP request method supported by the server for a particular
resource. You can also test the functionality of
the server by sending a '*'
request to the web server.
Echoes requests received by the server, primarily for testing or diagnostics.
It is a supplement to the PUT method for local updating of known resources.
is reserved for proxy servers that can connect
The SIM7070_SIM7080_SIM7090 Series supports several methods: GET, POST, PUT, PATCH and HEAD.
www.simcom.com
7 / 21
SIM7070_SIM7080_SIM7090 Series_HTTP(S)_Application Note_V1.02
3 AT Commands for HTTP(S)
Command
AT+CSSLCFG
AT+SHCONF
AT+SHSSL
AT+SHCONN
AT+SHBOD
AT+SHAHEAD
AT+SHPARA
AT+SHCPARA
AT+SHCHEAD
AT+SHSTATE
AT+SHREQ
AT+SHREAD
AT+SHDISC
AT+HTTPTOFS
AT+HTTPTOFSRL
Description
Configure SSL parameters of a context identifier
Set HTTP(S) Parameter
Select SSL Configure
HTTP(S) Connection
Set Body
Add Head
Set HTTP(S) Para
Clear HTTP(S) Para
Clear Head
Query HTTP(S) Connection Status
Set Request Type
Read Response Value
Disconnect HTTP(S)
Download file to ap file system
State of download file to ap file system
For detail information, please refer to “SIM7070_SIM7080_SIM7090 Series_AT Command Manual“.
www.simcom.com
8 / 21