Upload
donhan
View
285
Download
0
Embed Size (px)
Citation preview
WCDMA UGxx HTTP
AT Commands Manual
UMTS/HSPA Module Series
Rev. WCDMA_UGxx_HTTP_AT_Commands_Manual_V1.2
Date: 2015-04-01
www.quectel.com
http://www.quectel.com/
UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual
WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 1 / 30
Our aim is to provide customers with timely and comprehensive service. For any
assistance, please contact our company headquarters:
Quectel Wireless Solutions Co., Ltd.
Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233
Tel: +86 21 5108 6236
Mail: [email protected]
Or our local office, for more information, please visit:
http://www.quectel.com/support/salesupport.aspx
For technical support, to report documentation errors, please visit:
http://www.quectel.com/support/techsupport.aspx
Or Email: [email protected]
GENERAL NOTES
QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION
PROVIDED IS BASED UPON CUSTOMERS REQUIREMENTS. QUECTEL MAKES EVERY EFFORT
TO ENSURE THE QUALITY OF THE INFORMATION IT MAKES AVAILABLE. QUECTEL DOES NOT
MAKE ANY WARRANTY AS TO THE INFORMATION CONTAINED HEREIN, AND DOES NOT ACCEPT
ANY LIABILITY FOR ANY INJURY, LOSS OR DAMAGE OF ANY KIND INCURRED BY USE OF OR
RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO
CHANGE WITHOUT PRIOR NOTICE.
COPYRIGHT
THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF
QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS
DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS ARE FORBIDDEN WITHOUT
PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS
ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL
OR DESIGN.
Copyright Quectel Wireless Solutions Co., Ltd. 2015. All rights reserved.
Quect
el
Confide
ntial
mailto:[email protected]://www.quectel.com/support/salesupport.aspxmailto:[email protected]
UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual
WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 2 / 30
About the Document
History
Revision Date Author Description
1.0 2014-12-13 Chris PENG Initial
1.1 2015-03-04 Jessica GENG Changed the document name from
UG95 to UGxx.
1.2 2015-04-01 Jessica GENG Updated applicable modules.
Quect
el
Confide
ntial
UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual
WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 3 / 30
Contents
About the Document ................................................................................................................................... 2
Contents ....................................................................................................................................................... 3
Table Index ................................................................................................................................................... 4
1 Introduction .......................................................................................................................................... 5
1.1. The Process of Using HTTP AT Commands ........................................................................... 5
1.2. Description of HTTP Header ................................................................................................... 6
1.2.1. Customize HTTP Request Header .................................................................................. 6
1.2.2. Output HTTP Response Header ...................................................................................... 6
1.3. Description of Data Mode ........................................................................................................ 6
1.4. Error Handling ......................................................................................................................... 7
1.4.1. Executing HTTP AT Command Fails ............................................................................... 7
1.4.2. PDP Activation Fails ......................................................................................................... 7
1.4.3. DNS Parse Fails ............................................................................................................... 8
1.4.4. Sending GET/POST Request Fails.................................................................................. 8
1.4.5. Reading Response Fails .................................................................................................. 8
2 Description of AT Command .............................................................................................................. 9
2.1. AT+QHTTPCFG Configure Parameters for HTTP(S) Server ............................................... 9
2.2. AT+QHTTPURL Set HTTP(S) Server URL ........................................................................ 11
2.3. AT+QHTTPGET Send GET Request to HTTP(S) Server .................................................. 12
2.4. AT+QHTTPPOST Send POST Request to HTTP(S) Server by UART/USB ..................... 14
2.5. AT+QHTTPPOSTFILE Send POST Request to HTTP(S) Server by File .......................... 16
2.6. AT+QHTTPREAD Read Response from HTTP(S) Server by UART/USB ........................ 17
2.7. AT+QHTTPREADFILE Read Response from HTTP(S) Server by File ............................. 18
3 Example .............................................................................................................................................. 19
3.1. Access HTTP Server ............................................................................................................. 19
3.1.1. Send HTTP GET Request .............................................................................................. 19
3.1.2. Send HTTP POST Request ........................................................................................... 20
3.1.2.1. Post Body Obtained from UART/USB .................................................................... 20
3.1.2.2. Post Body Obtained from File System ................................................................... 21
3.2. Access HTTPS Server .......................................................................................................... 22
3.2.1. Send HTTP GET Request .............................................................................................. 22
3.2.2. Send HTTP POST Request ........................................................................................... 24
3.2.2.1. Post Body Obtained from UART/USB .................................................................... 24
3.2.2.2. Post Body Obtained from File System ................................................................... 25
4 Summary of ERROR Code ................................................................................................................ 27
5 Summary of HTTP Response Code ................................................................................................. 29
6 Appendix A Reference ....................................................................................................................... 30
Quect
el
Confide
ntial
UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual
WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 4 / 30
Table Index
TABLE 1: DIFFERENT CODING SCHEMES OF +CME ERROR: ....................................................... 27
TABLE 2: DIFFERENT CODING SCHEMES OF HTTP RESPONSE CODE ................................................... 29
TABLE 3: RELATED DOCUMENTS .................................................................................................................. 30
TABLE 4: TERMS AND ABBREVIATIONS ........................................................................................................ 30
Quect
el
Confide
ntial
UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual
WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 5 / 30
1 Introduction
The module supports HTTP operation to HTTP(s) Server. This document is a reference guide to all the AT
commands defined for UGxx HTTP.
This document is applicable to UGxx modules.
1.1. The Process of Using HTTP AT Commands
Through UGxx TCPIP AT command, you can configure PDP context, activate and deactivate PDP context,
query PDP context status (Please refer to Quectel_WCDMA_UGxx_TCPIP_AT_Commands_Manual),
and through UGxx HTTP AT command, you can send HTTP GET/POST request to HTTP server, and
read HTTP response from HTTP server. The general process is as follows:
Step 1: Configure the , , and other parameters of PDP context by
AT+QICSGP. If QoS settings need to