Quectel EC2x&EG9x&EM05 AT Commands Manual V1.0 Copy
User Manual: Pdf
Open the PDF directly: View PDF 
.
Page Count: 37
| Download | |
| Open PDF In Browser | View PDF |
EC2x&EG9x&EM05 HTTP(S) AT Commands Manual LTE Module Series Rev. EC2x&EG9x&EM05_HTTP(S)_AT_Commands_Manual_V1.0 Date: 2017-11-20 Status: Released www.quectel.com LTE Module Series EC2x&EG9x&EM05 HTTP(S) AT Commands Manual Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. 7th Floor, Hongye Building, No.1801 Hongmei Road, Xuhui District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://quectel.com/support/technical.htm Or email to: support@quectel.com GENERAL NOTES QUECTEL OFFERS THE 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 THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF QUECTEL WIRELESS SOLUTIONS CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT 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. 2017. All rights reserved. EC2x&EG9x&EM05_HTTP(S)_AT_Commands_Manual 1 / 36 LTE Module Series EC2x&EG9x&EM05 HTTP(S) AT Commands Manual About the Document History Revision 1.0 Date 2017-11-20 Author Duke XIN/ Haley HUANG EC2x&EG9x&EM05_HTTP(S)_AT_Commands_Manual Description Initial 2 / 36 LTE Module Series EC2x&EG9x&EM05 HTTP(S) AT Commands Manual Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index ................................................................................................................................................... 5 1 Introduction .......................................................................................................................................... 6 1.1. The Process of Using HTTP(S) AT Commands ...................................................................... 6 1.2. Description of HTTP(S) Header .............................................................................................. 7 1.2.1. Customize HTTP(S) Request Header ............................................................................. 7 1.2.2. Output HTTP(S) Response Header ................................................................................. 7 1.3. Description of Data Mode ........................................................................................................ 8 2 Description of HTTP(S) AT Commands ............................................................................................. 9 2.1. AT+QHTTPCFG Configure Parameters for HTTP(S) Server ............................................... 9 2.2. AT+QHTTPURL Set URL of HTTP(S) Server .................................................................... 12 2.3. AT+QHTTPGET Send GET Request to HTTP(S) Server .................................................. 13 2.4. AT+QHTTPGETEX Send Range GET Request to HTTP(S) Server.................................. 14 2.5. AT+QHTTPPOST Send POST Request to HTTP(S) Server via UART/USB .................... 15 2.6. AT+QHTTPPOSTFILE Send POST Request to HTTP(S) Server via File ......................... 17 2.7. AT+QHTTPREAD Read Response from HTTP(S) Server via UART/USB ........................ 18 2.8. AT+QHTTPREADFILE Read Response from HTTP(S) Server via File ............................ 19 2.9. AT+QHTTPSTOP Cancel HTTP(S) Request ..................................................................... 20 3 Examples ............................................................................................................................................ 21 3.1. Access to HTTP Server ......................................................................................................... 21 3.1.1. Send HTTP GET Request and Read the Response ..................................................... 21 3.1.2. Send HTTP POST Request and Read the Response ................................................... 22 3.1.2.1. Post Body Obtained from UART/USB ................................................................... 22 3.1.2.2. Post Body Obtained from File System .................................................................. 23 3.2. Access to HTTPS Server ...................................................................................................... 24 3.2.1. Send HTTPS GET Request and Read the Response ................................................... 24 3.2.2. Send HTTPS POST Request and Read the Response ................................................ 26 3.2.2.1. Post Body Obtained from UART/USB ................................................................... 26 3.2.2.2. Post Body Obtained from File System .................................................................. 28 Error Handling .................................................................................................................................... 30 4.1. Executing HTTP(S) AT Commands Fails .............................................................................. 30 4.2. PDP Activation Fails .............................................................................................................. 30 4.3. DNS Parse Fails .................................................................................................................... 30 4.4. Entering Data Mode Fails ...................................................................................................... 31 4.5. Sending GET/POST Requests Fails .................................................................................. 31 4.6. Reading Response Fails ....................................................................................................... 31 4 5 6 Summary of ERROR Codes .............................................................................................................. 33 Summary of HTTP(S) Response Codes .......................................................................................... 35 EC2x&EG9x&EM05_HTTP(S)_AT_Commands_Manual 3 / 36 LTE Module Series EC2x&EG9x&EM05 HTTP(S) AT Commands Manual 7 Appendix A References..................................................................................................................... 36 EC2x&EG9x&EM05_HTTP(S)_AT_Commands_Manual 4 / 36 LTE Module Series EC2x&EG9x&EM05 HTTP(S) AT Commands Manual Table Index TABLE 1: SUMMARY OF ERROR CODES ...................................................................................................... 33 TABLE 2: SUMMARY OF HTTP(S) RESPONSE CODES ................................................................................ 35 TABLE 3: RELATED DOCUMENTS .................................................................................................................. 36 TABLE 4: TERMS AND ABBREVIATIONS ........................................................................................................ 36 EC2x&EG9x&EM05_HTTP(S)_AT_Commands_Manual 5 / 36 LTE Module Series EC2x&EG9x&EM05 HTTP(S) AT Commands Manual 1 Introduction EC2x&EG9x&EM05 modules provide HTTP(S) application to HTTP(S) server. This document is a reference guide to all the AT commands defined for HTTP(S). This document is applicable to following Quectel modules. EC2x (including EC25, EC21, EC20 R2.0 and EC20 R2.1) EG9x (including EG91 and EG95) EM05 1.1. The Process of Using HTTP(S) AT Commands Through EC2x&EG9x&EM05 TCP/IP AT commands, customers can configure a PDP context, activate/deactivate the PDP context and query the PDP context status. And through EC2x&EG9x&EM05 HTTP(S) AT commands, customers can send HTTP(S) GET/POST requests to HTTP(S) server, and read HTTP(S) response from HTTP(S) server. The general process is as follows: Step 1: Configure, , and other parameters of a PDP context by AT+QICSGP. Please refer to Quectel_EC2x&EG9x&EM05_TCP(IP)_AT_Commands_Manual for details. If QoS settings need to be updated, configure them by AT+CGQMIN, AT+CGEQMIN, AT+CGQREQ and AT+CGEQREQ commands. For more details, please refer to Quectel_EC25&EC21_AT_Commands_Manual, Quectel_EG9x_AT_Commands_Manual and Quectel_EM05_AT_Commands_Manual. Step 2: Activate the PDP context by AT+QIACT, then the assigned IP address can be queried by AT+QIACT?. Please refer to Quectel_EC2x&EG9x&EM05_TCP(IP)_AT_Commands_Manual for details. Step 3: Configure the PDP context ID and SSL context ID by AT+QHTTPCFG command. Step 4: Configure SSL context parameters by AT+QSSLCFG command. For more details, please refer to Quectel_EC2x&EG9x&EM05_SSL_AT_Commands_Manual. Step 5: Set HTTP(S) URL by AT+QHTTPURL command. Step 6: Send HTTP(S) request. AT+QHTTPGET command can be used for sending HTTP(S) GET request, and AT+QHTTPPOST or QHTTPOSTFILE command can be used for sending HTTP(S) POST request. EC2x&EG9x&EM05_HTTP(S)_AT_Commands_Manual 6 / 36 LTE Module Series EC2x&EG9x&EM05 HTTP(S) AT Commands Manual Step 7: Read HTTP(S) response information by AT+QHTTPREAD or QHTTPREADFILE command. Step 8: Deactivate the PDP context by AT+QIDEACT command. For more details, please refer to Quectel_EC2x&EG9x&EM05_TCP(IP)_AT_Commands_Manual. 1.2. Description of HTTP(S) Header 1.2.1. Customize HTTP(S) Request Header HTTP(S) request header is filled by the module automatically. HTTP(S) request header can be customized by configuring as 1 via AT+QHTTPCFG command, and then inputting HTTP(S) request header according to the following requirements: 1. 2. 3. Follow HTTP(S) header syntax. The value of URI in HTTP(S) request line and the “Host:” header must be in line with the URL configured by AT+QHTTPURL command. The HTTP(S) request header must end with . The following example shows a valid HTTP(S) POST request header: POST /processorder.php HTTP/1.1 Host: 220.180.239.212:8011 Accept: */* User-Agent: QUECTEL_MODULE Connection: Keep-Alive Content-Type: application/x-www-form-urlencoded Content-Length: 48 Message=1111&Appleqty=2222&Orangeqty=3333&find=1 1.2.2. Output HTTP(S) Response Header HTTP(S) response header will not be outputted automatically. HTTP(S) response header information can be obtained by configuring to 1 via AT+QHTTPCFG command, and then HTTP(S) response header will be outputted with HTTP(S) response body after executing AT+QHTTPREAD or AT+QHTTPREADFILE command. EC2x&EG9x&EM05_HTTP(S)_AT_Commands_Manual 7 / 36 LTE Module Series EC2x&EG9x&EM05 HTTP(S) AT Commands Manual 1.3. Description of Data Mode The COM port of EC2x&EG9x&EM05 module has two working modes: AT command mode and data mode. In AT command mode, the inputted data via COM port will be treated as AT command. While in data mode, it will be treated as data. Inputting “+++” or pulling up DTR (AT&D1 should be set first) can make the COM port exit from data mode. To prevent the “+++” from being misinterpreted as data, the following sequence should be followed: 1) 2) 3) Do not input any character within 1s or longer before inputting “+++”. Input “+++” within 1s, and no other characters can be inputted during the time. Do not input any character within 1s after “+++” has been inputted. When AT+QHTTPURL, AT+QHTTPOST and AT+QHTTPREAD are executed, the COM port will enter data mode. If customers are using “+++” or DTR to make the port exit from data mode, the executing procedure of these commands will be interrupted before the response is returned. In such case, the COM port cannot reenter data mode by executing ATO command. EC2x&EG9x&EM05_HTTP(S)_AT_Commands_Manual 8 / 36 LTE Module Series EC2x&EG9x&EM05 HTTP(S) AT Commands Manual 2 Description of HTTP(S) AT Commands 2.1. AT+QHTTPCFG Configure Parameters for HTTP(S) Server The command is used to configure the parameters for HTTP(S) server, including configuring a PDP context ID, customizing HTTP(S) request header, outputting HTTP(S) response header and querying SSL settings. If the Write Command only executes one parameter, it will query the current settings. AT+QHTTPCFG Configure Parameters for HTTP(S) Server Test Command AT+QHTTPCFG=? Response +QHTTPCFG: "contextid",(1-16) +QHTTPCFG: "requestheader",(0,1) +QHTTPCFG: "responseheader",(0,1) +QHTTPCFG: "sslctxid",(0-5) +QHTTPCFG: "contenttype",(0-3) +QHTTPCFG: "rspout/auto",(0,1) +QHTTPCFG: "closed/ind",(0,1) OK Write Command AT+QHTTPCFG="contextid"[, ] Response If is not omitted: OK Or +CME ERROR: If is omitted, query the current settings: +QHTTPCFG: "contextid", OK Write Command AT+QHTTPCFG="requestheader"[, ] Response If is not omitted: OK Or +CME ERROR: If is omitted , query the current settings: EC2x&EG9x&EM05_HTTP(S)_AT_Commands_Manual 9 / 36 LTE Module Series EC2x&EG9x&EM05 HTTP(S) AT Commands Manual +QHTTPCFG: "requestheader", OK Write Command AT+QHTTPCFG="responseheader"[, ] Response If is not omitted: OK Or +CME ERROR: If is omitted , query the current settings: +QHTTPCFG: "responseheader", OK Write Command AT+QHTTPCFG="sslctxid"[, ] Response If is not omitted: OK Or +CME ERROR: If is omitted, query the current settings: +QHTTPCFG: "sslctxid", OK Write Command AT+QHTTPCFG="rspout/auto"[, ] Response If is not omitted: OK Or +CME ERROR: If is omitted, query the current settings: +QHTTPCFG: "rspout/auto", OK Write Command AT+QHTTPCFG="closed/ind"[, ] Response If is not omitted: OK Or +CME ERROR: If is omitted, query the current settings: +QHTTPCFG: "closed/ind", OK EC2x&EG9x&EM05_HTTP(S)_AT_Commands_Manual 10 / 36 LTE Module Series EC2x&EG9x&EM05 HTTP(S) AT Commands Manual Read Command AT+QHTTPCFG? Response +QHTTPCFG: "contextid", +QHTTPCFG: "requestheader", +QHTTPCFG: "responseheader", +QHTTPCFG: "sslctxid", +QHTTPCFG: "contenttype", +QHTTPCFG: "rspout/auto", +QHTTPCFG: "closed/ind", OK Parameter Numeric type. PDP context ID. The range is 1-16, and the default value is 1. Numeric type. Disable or enable to customize HTTP(S) request header. 0 Disable 1 Enable Numeric type. Disable or enable to output HTTP(S) response header. 0 Disable 1 Enable Numeric type. SSL context ID used for HTTP(S). The range is 0-5, and the default value is 1. Customers should configure the SSL parameters by AT+QSSLCFG. For details, please refer to Quectel_EC2x&EG9x&EM05_ SSL_AT_ Commands_Manual. Numeric type. Data type of HTTP(S) body. 0 application/x-www-form-urlencoded 1 text/plain 2 application/octet-stream 3 multipart/form-data Numeric type. Disable or enable auto output of HTTP(S) response data. If auto output of HTTP(S) response data is enabled, then the execution of AT+QHTTPREAD and AT+QHTTPREADFILE commands will be failed. 0 Disable 1 Enable Numeric type. Disable or enable report indication of closed HTTP(S) session. 0 Disable 1 Enable Integer type. The error code of the operation. Please refer to Chapter 5. NOTE AT+QHTTPCFG="rspout/auto"[, ] not supported on EM05 module currently. and AT+QHTTPCFG="closed/ind"[, ] are EC2x&EG9x&EM05_HTTP(S)_AT_Commands_Manual 11 / 36 LTE Module Series EC2x&EG9x&EM05 HTTP(S) AT Commands Manual 2.2. AT+QHTTPURL Set URL of HTTP(S) Server URL must begin with “http://” or “https://”, which indicates the access to an HTTP or HTTPS server. AT+QHTTPURL Set URL of HTTP(S) Server Test Command AT+QHTTPURL=? Response +QHTTPURL: (1-2048),(1-65535) OK Write Command AT+QHTTPURL= [, ] Response a) If the parameter format is correct, and it is not sending HTTP(S) GET/POST requests: CONNECT TA switches to transparent access mode, and the URL can be inputted. When the total size of the inputted data reaches , TA will return to command mode and report the following code: OK If the has reached, but the received length of URL is less than , TA will return to command mode and report the following code: +CME ERROR: b) If the parameter format is incorrect or other errors occur: +CME ERROR: Read Command AT+QHTTPURL? Response [+QHTTPURL: ] OK Parameter Numeric type. The length of URL. The range is 1-2048. Unit: byte. Numeric type. The maximum time for inputting URL. The range is 1-65535, and the default value is 60. Unit: second. Integer type. The error code of the operation. Please refer to Chapter 5. EC2x&EG9x&EM05_HTTP(S)_AT_Commands_Manual 12 / 36 LTE Module Series EC2x&EG9x&EM05 HTTP(S) AT Commands Manual 2.3. AT+QHTTPGET Send GET Request to HTTP(S) Server According to the configured parameter in AT+QHTTPCFG="requestheader"[, ] command, AT+HTTPGET Write Command has two different formats. If is set to 1, after AT+QHTTPGET command has been sent, "CONNECT" may be outputted in 125s to indicate that the connection is successful. If it is not outputted during the time, then "+CME ERROR: " will be outputted. After AT+HTTPGET Write Command has been sent, it is recommended to wait for a specific period of time (refer to the maximum response time below) for "+QHTTPGET: [, [, ]]" to be outputted after "OK" is reported. In "+QHTTPGET: [, [, ]]", the parameter can only be reported when equals 0. If HTTP(S) response header contains "CONTENT-LENGTH" information, then information will be reported. AT+QHTTPGET Send GET Request to HTTP(S) Server Test Command AT+QHTTPGET=? Response +QHTTPGET: (1-65535),(1-2048),(1-65535) OK If equals 0 (disable to customize HTTP(S) request header) Write Command AT+QHTTPGET[= ] Response a) If the parameter format is correct and no other errors occur: OK When the module has received response from HTTP(S) server, it will report the following URC: +QHTTPGET: [, [, ]] b) If the parameter format is incorrect or other errors occur: +CME ERROR: If equals 1 (enable to customize HTTP(S) request header) Write Command AT+QHTTPGET= , [, ] Response a) If HTTP(S) server is connected successfully: CONNECT TA switches to transparent access mode, and the HTTP(S) GET request header can be inputted. When the total size of the inputted data reaches , TA will return to command mode and report the following code: OK When the module has received response from HTTP(S) server, it will report the following URC: EC2x&EG9x&EM05_HTTP(S)_AT_Commands_Manual 13 / 36 LTE Module Series EC2x&EG9x&EM05 HTTP(S) AT Commands Manual +QHTTPGET: [, [, ]] If the has reached, but the length of received data is less than , TA will return to command mode and report the following code: +CME ERROR: b) If the parameter format is incorrect or other errors occur: +CME ERROR: Determined by Maximum Response Time Parameter Numeric type. The range is 1-65535, and the default value is 60. Unit: second. It is used to configure the timeout for the HTTP(S) GET response "+QHTTPGET: [, , ]" to be outputted after "OK" is returned. Numeric type. The length of HTTP(S) request information, including HTTP(S) request header and HTTP(S) request body. The range is 1-2048. Unit: byte. Numeric type. The maximum time for inputting HTTP(S) request information. The range is 1-65535, and the default value is 60. Unit: second. Integer type. The error code of the operation. Please refer to Chapter 5. Please refer to Chapter 6. Please refer to Chapter 2.1. Numeric type. The length of HTTP(S) response body. Unit: byte. 2.4. AT+QHTTPGETEX Send Range GET Request to HTTP(S) Server Like read files, MCU can get data from HTTP(S) server with specified position and specified length by AT+HTTPGETEX command, and this command is only executable in the condition of AT+QHTTPCFG="requestheader",0. After that, HTTP(S) server will always respond to Range GET Request with "206" code. AT+QHTTPGETEX Send Range GET Request to HTTP(S) Server Test Command AT+QHTTPGETEX=? Response +QHTTPGETEX: (1-65535), , OK Write Command AT+QHTTPGET= , , Response a) If the parameter format is correct and no other errors occur: OK EC2x&EG9x&EM05_HTTP(S)_AT_Commands_Manual 14 / 36 LTE Module Series EC2x&EG9x&EM05 HTTP(S) AT Commands Manual When the module has received response from HTTP(S) server, it will report the following URC: +QHTTPGET: [, [, ]] b) If the parameter format is incorrect or other errors occur: +CME ERROR: Maximum Response Time Determined by Parameter Numeric type. The range is 1-65535, and the default value is 60. Unit: second. It is used to configure the timeout for the HTTP(S) GET response "+QHTTPGET: [, , ]" to be outputted after "OK" is returned. Numeric type. The start position of the data that the HTTP(S) client wants to GET. Numeric type. The length of the data that the HTTP(S) client wants to GET. Integer type. The error code of the operation. Please refer to Chapter 5. Please refer to Chapter 6. Numeric type. The length of HTTP(S) response body. Unit: byte. NOTE AT+QHTTPGETE command is not supported on EM05 module currently. 2.5. AT+QHTTPPOST Send POST Request to HTTP(S) Server via UART/USB The command is used to send HTTP(S) POST request. According to the configured parameter in AT+QHTTPCFG="requestheader"[, ] command, the AT+QHTTPPOST Write Command has two different formats. If is set to 0, post body should be inputted via UART/USB port. If is set to 1, then both post header and body should be inputted via UART/USB port. After AT+QHTTPPOST command has been sent, "CONNECT" may be outputted in 125s to indicate the connection is successful. If it is not received during the time, "+CME ERROR: " will be outputted. It is recommended to wait for a specific period of time (refer to the maximum response time below) for "+QHTTPPOST: [, [, ]]" to be outputted after "OK" is reported. EC2x&EG9x&EM05_HTTP(S)_AT_Commands_Manual 15 / 36 LTE Module Series EC2x&EG9x&EM05 HTTP(S) AT Commands Manual AT+QHTTPPOST Send POST Request to HTTP(S) Server via UART/USB Test Command AT+QHTTPPOST=? Response +QHTTPPOST: (1-1024000),(1-65535),(1-65535) OK If equals 0 (disable to customize HTTP(S) request header) Write Command AT+QHTTPPOST= [, , ] Response a) If the parameter format is correct and HTTP(S) server is connected successfully and HTTP(S) request header is sent completely, it will prompt to input body: CONNECT TA switches to transparent access mode, and the HTTP(S) POST body can be inputted. When the total size of the inputted data reaches , TA will return to command mode and report the following code: OK When the module has received response from HTTP(S) server, it will report the following URC: +QHTTPPOST: [, [, ]] If the has reached, but the received length of data is less than , TA will return to command mode and report the following code: +CME ERROR: b) If the parameter format is incorrect or other errors occur: +CME ERROR: If equals 1 (enable to customize HTTP(S) request header) Write Command AT+QHTTPPOST= [, , ] Response a) If the parameter format is correct and HTTP(S) server is connected successfully: CONNECT TA switches to the transparent access mode, and the HTTP(S) POST header and body can be inputted. When the total size of the inputted data reaches , TA will return to command mode and report the following code: OK When the module has received response from HTTP(S) server, it will report the following URC: +QHTTPPOST: [, [, ]] EC2x&EG9x&EM05_HTTP(S)_AT_Commands_Manual 16 / 36 LTE Module Series EC2x&EG9x&EM05 HTTP(S) AT Commands Manual If the has reached, but the length of received data is less than , TA will return to command mode and report the following code: +CME ERROR: b) If the parameter format is incorrect or other errors occur: +CME ERROR: Maximum Response Time Determined by network and Parameter Numeric type. If is 0, it indicates the length of post body, and if is 1, it indicates the length of HTTP(S) request information, including HTTP(S) request header and HTTP(S) request body. The range is 1-1024000. Unit: byte. Numeric type. The maximum time for inputting post body or HTTP(S) request information. The range is 1-65535, and the default value is 60. Unit: second. Numeric type. The range is 1-65535, and the default value is 60. Unit: second. It is used to configure the timeout for the HTTP(S) POST response "+QHTTPPOST: [, [, ]]" to be outputted after "OK" is returned. Integer type. The error code of the operation. Please refer to Chapter 5. Please refer to Chapter 6. Please refer to Chapter 2.1. Numeric type. The length of HTTP(S) response body. Unit: byte. 2.6. AT+QHTTPPOSTFILE Send POST Request to HTTP(S) Server via File The command can be used to send HTTP(S) POST request via file. According to the in AT+QHTTPCFG="requestheader"[, ] command, the file operated by AT+HTTPPOSTFILE command has two different formats. If is set to 0, the file in file system will be post body. If is set to 1, the file in file system will be post header and body. The module will report "+QHTTPPOSTFILE: [, [, ]]" information to indicate the executing result of AT+QHTTPPOSFILE command. The parameter can only be reported when equals 0. EC2x&EG9x&EM05_HTTP(S)_AT_Commands_Manual 17 / 36 LTE Module Series EC2x&EG9x&EM05 HTTP(S) AT Commands Manual It is recommended to wait for a specific period of time (refer to the maximum response time below) for "+QHTTPPOSTFILE: [, [, ]]" to be outputted after "OK" is reported. AT+QHTTPPOSTFILE Send POST Request to HTTP(S) Server by File Test Command AT+QHTTPPOSTFILE=? Response +QHTTPPOSTFILE: ,(1-65535) OK Write Command AT+QHTTPPOSTFILE= [,< rsptime>] If equals 1, the specified file must contain HTTP(S) request header information. Response a) If parameter format is correct and HTTP(S) server is connected successfully: OK When the module has received response from HTTP(S) server, it will report the following URC: +QHTTPPOSTFILE: [, , ] b) If parameter format is incorrect or other errors occur: +CME ERROR: Determined by Maximum Response Time Parameter String type. File name. The max length of file name is 80 bytes. Numeric type. The range is 1-65535, and the default value is 60. Unit: second. It is used to configure the timeout for the HTTP(S) POST response "+QHTTPPOSTFILE: [, , ]" to be outputted after "OK" is returned. Integer type. The error code of the operation. Please refer to Chapter 5. Please refer to Chapter 6. Please refer to Chapter 2.1. Numeric type. The length of HTTP(S) response body. Unit: byte. 2.7. AT+QHTTPREAD Read Response from HTTP(S) Server via UART/USB After sending HTTP(S) GET/POST requests, customers can retrieve HTTP(S) response information from HTTP(S) server via UART/USB port by AT+QHTTPREAD command. And "+QHTTPGET: [, [, ]]", "+QHTTPPOST: [, [, ]]" or EC2x&EG9x&EM05_HTTP(S)_AT_Commands_Manual 18 / 36 LTE Module Series EC2x&EG9x&EM05 HTTP(S) AT Commands Manual "+QHTTPPOSTFILE: [, , ]" information must be received before executing AT+QHTTPREAD command. AT+QHTTPREAD Read Response from HTTP(S) Server via UART/USB Test Command AT+QHTTPREAD=? Response +QHTTPREAD: (1-65535) OK Write Command AT+QHTTPREAD[= ] Response a) If the parameter format is correct and read successfully: CONNECT