GSM_HTTP_ATC_V1.00

Quectel Cellular EngineHTTP Service AT Commands GSM_HTTP_ATC_V1.00 system validation of this product designed by Quectel within a larger electronic system remains the responsibility of Q den the customer or the customer’s system integrator.00 Date 2009-07-06 Status Release Document Control ID GSM_HTTP_ATC_V1. C Copyright © Shanghai Quectel Wireless Solutions Co. All specifications supplied herein are subject to change..HTTP Service AT Commands Document Title HTTP Service AT Commands Version 1. Copyright i This document contains proprietary technical information which is the property of Quectel f Limited. Offenders are liable to the n payment of damages.00 t el General Notes Quectel offers this information as a service to its customers.00 -1- . to support application and c l engineering efforts that use the products designed by Quectel. Quectel has not e i a undertaken any independent search for additional relevant information. copying of this document and giving it to others and the using or communication of the contents thereof.. All specification supplied herein are subject to change without notice at any time. The information provided is based upon requirements specifically provided to Quectel by the customers. are forbidden without express authority. 2009 GSM_HTTP_ATC_V1. Ltd. including any u t information that may be in the customer’s possession. All rights reserved in the event of grant of a patent or the registration of o a utility model or design. Furthermore. ............................6 l 2....... AT+QHTTPURL Set HTTP Server URL.. Detailed Description of AT Commands for HTTP Service ...............................................................................................................................................................2.................................................................................................................................................................................................. Summary of CME ERROR Codes ............... AT Commands for HTTP Service .........................10 4........................................................... Introduction..........................................1.........7 c l 2.........2 Table Index.....2.................................................6 e 2........ Examples............... AT+QHTTPPOST Send HTTP POST Request.................................................................. Send HTTP POST Request ............. Reference........................2............................ Overview of AT Commands for HTTP Service.........................................8 e a 3...... Revision history ..............5 2.................3 0.....1.............4 1.................................................4........9 u t 4.......... Send HTTP GET Request .................................................2......................................HTTP Service AT Commands Contents Contents ...............3.............. 11 n fi C o GSM_HTTP_ATC_V1......................................9 i 3................................................................................................... AT+QHTTPGET Send HTTP GET Request................. Supported unsolicited result codes....................................................................00 -2- .....................................2.....6 2...........................................2.......1........................................................................................................7 2....................2...........6 t 2..1........................................... AT+QHTTPREAD Read HTTP Server Response .5 1.....................1..........................10 Q den 4............................... ........5 t el e c i al u Q den t n fi C o GSM_HTTP_ATC_V1.......HTTP Service AT Commands Table Index TABLE 1: REFERENCE..............................00 -3- ............................................................................... 00 -4- .00 2009-07-06 Jay XIN Initial t el e c i al u Q den t n fi C o GSM_HTTP_ATC_V1.HTTP Service AT Commands 0. Revision history Revision Date Author Description of change 1. This document is a reference guide to all the AT commands and responses defined for HTTP Service. FTP service and HTTP service.pdf TCPIP Application Notes [2] RFC 2616 Q den n fi C o GSM_HTTP_ATC_V1. The advantage of this solution is that it eliminates the need for the application manufacturer to implement own HTTP protocol.HTTP Service AT Commands 1. thus minimizing cost and time to integrate Internet connectivity into a new or existing host application. Introduction Quectel Module has an internal TCP/IP stack that is driven by AT commands and enables the host application to easily access the Internet service. It includes TCP service. el 1.00 -5- . UDP service. Reference c t l Table 1: Reference e i a SN Document name Remark u t [1] GSM_TCPIP_AN.1. etc. 1. <input_time> Maximum time in seconds to input URL. To switch back to AT mode. AT Commands for HTTP Service 2. Detailed Description of AT Commands for HTTP Service fi 2. AT+QHTTPURL Set HTTP Server URL n AT+QHTTPURL Set HTTP Server URL Test Command Response o AT+QHTTPURL=? +QHTTPURL: (1-200).<input_ti CONNECT me> If error is related to ME functionality: ERROR +CME ERROR: <err> Parameter <url_len> the length in bytes of the URL. The e a interval time between the first “+” and the character before the first “+” MUST NOT be less than i 500 ms and the interval time between the last “+” and the character next to the last “+” MUST u t NOT be less than 500 ms and the interval time between each “+” MUST be less than 1000 ms. for example. Overview of AT Commands for HTTP Service Command Description AT+QHTTPURL Set HTTP Server URL l AT+QHTTPGET Send HTTP GET Request AT+QHTTPREAD Read HTTP Server Response e AT+QHTTPPOST Send HTTP POST Request c t l Execution of above HTTP related AT commands will switch to data mode.2. Reference If send HTTP GET Request.(1-65535) C OK Parameter See Write Command Write Command Response AT+QHTTPURL=<url_len>. Q den 2.00 -6- . input URL path: GSM_HTTP_ATC_V1. you can input “+++” and this will terminate the current HTTP AT command.2.HTTP Service AT Commands 2.1. 1.efxnow. AT+QHTTPREAD C will be invalid if the idle time after AT+QHTTPGET is longer then to <to_read_time>. t el AT+QHTTPGET Send HTTP GET Request c l AT+QHTTPGET Send HTTP GET Request e Test Command Response i a AT+QHTTPGET=? +QHTTPGET: (1-65536) u t OK Q den Parameter See Write Command Write Command Response AT+QHTTPGET=<to_read_time> OK fi If error is related to ME functionality: n ERROR +CME ERROR: <err> o Parameter <to_read_time> time in seconds.2.efxnow.com/DEMOWebServices2. input URL path: http://api.1”) or as server address names resolvable by a DNS server(e.xom”). AT+QHTTPREAD Read HTTP Server Response AT+QHTTPREAD Read HTTP Server Response Test Command Response AT+QHTTPREAD=? +QHTTPREAD: (1-65535) OK Parameter See Write Command Write Command Response GSM_HTTP_ATC_V1.2.3. 2.8/Service. asmx/Echo Server address must be provided as IP address in standard dot-format(e. “api.com/DEMOWebServices2.g.efxnow. for example.HTTP Service AT Commands http://api.8/Service. asmx/Echo?Message=helloquectel If send HTTP POST Request. Reference 2.168. “192.00 -7- .g.2. e Reference c t l 2.2.HTTP Service AT Commands AT+QHTTPREAD=<wait_time> CONNECT <data> OK If error is related to ME functionality: ERROR +CME ERROR: <err> Parameter <wait_time> time in seconds. <to_read_time> time in seconds. AT+QHTTPPOST Send HTTP POST Request e i a AT+QHTTPPOST Send HTTP POST Request u t Test Command Response AT+QHTTPPOST=? +QHTTPPOST: (1-29696). <input_time> Maximum time in seconds to input the body data.<to_read_time> <body_data> OK o If error is related to ME functionality: C ERROR +CME ERROR: <err> Parameter <body_size> size in bytes of the body data to POST. It will close http session when timeout.4. Reference GSM_HTTP_ATC_V1.00 -8- . AT+QHTTPREAD will be invalid if the idle time after AT+QHTTPGET is longer then to <to_read_time> <body_data> input the body data to POST from UART. l <data> the data of HTTP server response.(1-65535).<in CONNECT n put_time>.(1-65535) Q den OK Parameter See Write Command fi Write Command Response AT+QHTTPPOST=<body_size>. Supported unsolicited result codes 3. please refer to [1]. The operation is similar to ERROR result code. About other <err> codes. Summary of CME ERROR Codes Final result code +CME ERROR: <err> indicates an error related to mobile equipment or network. t e <err> values used by common messaging commands: Code of <err> Meaning c l 3801 http time out e a 3802 http busy i 3803 http uart busy u t 3804 http no getreq Q den 3805 http network busy 3806 http network open failed 3807 http network no config 3808 http network deactive i 3809 http network error f 3810 http url error 3811 http empty url n 3812 http ip addr error o 3813 http dns error 3814 http socket create error C 3815 http socket connect error 3816 http socket read error 3817 http socket write error 3818 http socket close 3819 http data encode error 3820 http data decode error 3821 http toread timeout 3822 http reponse failed GSM_HTTP_ATC_V1.HTTP Service AT Commands 3.1. The l following <err> is just the new <err> code for HTTP. None of the following commands in the same Command line is executed. Neither ERROR nor OK result code shall be returned.00 -9- . 3">Message ='helloquectel' ASCII:104 101 108 108 111 113 117 101 99 116 101 108 </string> OK GSM_HTTP_ATC_V1.8/Service. Send HTTP GET Request AT+QIFGCNT=0 OK AT+QICSGP=1.com/DEMOWebServices2.30 //set the URL.0" encoding="utf-8"?> <string xmlns="https://api.1.efxnow."CMNET" //set APN l OK t e AT+QIREGAPP //optional OK e c l AT+QIACT //optional i a OK u t AT+QHTTPURL=79.10 - .efxnow.as f mx/Echo?Message=helloquectel n OK o AT+QHTTPGET=60 //Send HTTP GET Request C OK AT+QHTTPREAD=30 //read the response of HTTP server. Examples 4.00 . //for example. input 79 bytes: i http://api. UART outputs: <?xml version="1.com/webservices2. CONNECT …. //for example. //output the response data of HTTP server to UART. Q den CONNECT ….HTTP Service AT Commands 4. 8/Service. Receive data from UART and not echo. input 18 bytes: Message=helloworld OK //This means all data has been received over. GSM_HTTP_ATC_V1. AT+QHTTPREAD=30 //read the response of HTTP server. It is recommended to set the latency time as long as enough to download all the data in the latency time.com/DEMOWebServices2. //for example.10 C // POST the data whose size is 18 Bytes and the maximum latency time for inputting is 50 s. input 58 bytes: f http://api.as mx/Echo n OK o AT+QHTTPPOST=18.50. i //for example. CONNECT …. And DCD has been set to low.11 - . Send HTTP POST Request AT+QIFGCNT=0 OK l AT+QICSGP=1."CMNET" //set APN OK t e AT+QIREGAPP //optional c l OK e a AT+QIACT //optional i OK u Q den t AT+QHTTPURL=58.HTTP Service AT Commands AT+QIDEACT //deactivate GPRS PDP connect. CONNECT //This means it is ready to receive data from UART.30 //set the URL. DEACT OK 4.00 .2. and DCD is set to high.efxnow. 12 - .3">Message ='helloworld' ASCII:104 101 108 108 111 119 111 114 108 100 </string> OK l AT+QIDEACT //deactivate GPRS PDP connect.HTTP Service AT Commands CONNECT …. e DEACT OK c t l u e t i a Q den n fi C o GSM_HTTP_ATC_V1.com/webservices2.0" encoding="utf-8"?> <string xmlns="https://api. UART outputs: <?xml version="1.00 . //output the response data of HTTP server to UART //for example.efxnow. 1618. Yishan Road. China 201103 Tel: +86 21 5108 2965 Mail: [email protected] . Shanghai Quectel Wireless Solutions Co. Shanghai.. Room 801. Ltd. Building E. No.