SimCom SIM900B EVB Installation and operating instructions

FTP HTTP AT Commands
User Guide
AN_SIM900_FTP_HTTP_APP_V1.00

SIM900 IPAPPLICATION
SIM900 IPAPPLICATION
Document Title: IPApplication Note
Version: 1.00
Date: 2010-07-06
Status: New
Document Control ID: AN_SIM900_FTP_HTTP_Application Note_V1.00_Beta
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
Limited., copying of this document and giving it to others and the using or communication of
the contents thereof, are forbidden without express authority. Offenders are liable to the
payment of damages. All rights reserved in the event of grant of a patent or the registration of
a utility model or design. All specification supplied herein are subject to change without
notice at any time.
Copyright © Shanghai SIMCom Wireless Solutions Ltd. 2004
3

SIM900 IPAPPLICATION
SIM900 IPAPPLICATION
VERSION HISTORY
Now document: SIM900 IPApplication Note” Version 1.00
Version Chapter What is new
V1.00 NEW
4

SIM900 IPAPPLICATION
SIM900 IPAPPLICATION
Contents
Version history 4
1. Introduction 7
1.1 Scope of the document.................................................................................................................................7
1.2 Related documents.......................................................................................................................................7
1.3 Conventions and abbreviations....................................................................................................................7
2. AT commands 8
2.1 AT+SAPBR..................................................................................................................................................8
2.2 Internet HTTP Service Commands ..............................................................................................................9
2.2.1 AT+HTTPINIT...............................................................................................................................9
2.2.2 AT+HTTPTERM..........................................................................................................................10
2.2.3 AT+HTTPPARA ..........................................................................................................................10
2.2.4 AT+HTTPDATA ..........................................................................................................................12
2.2.5 AT+HTTPACTION......................................................................................................................12
2.2.6 AT+HTTPREAD..........................................................................................................................14
2.3 FTP AT Commands...................................................................................................................................15
2.3.1 AT+ FTPPORT........................................................................................................................................15
2.3.2 AT+ FTPMOD ........................................................................................................................................16
2.3.3 AT+FTPTYPE.........................................................................................................................................17
2.3.4 AT+FTPPUTOPT....................................................................................................................................17
2.3.5 AT+FTPCID............................................................................................................................................18
2.3.6 AT+FTPREST.........................................................................................................................................19
2.3.7 AT+FTPSERV.........................................................................................................................................20
2.3.8 AT+FTPUN.............................................................................................................................................20
2.3.8 AT+FTPPW.............................................................................................................................................21
2.3.9 AT+ FTPGETNAME ..............................................................................................................................22
2.3.10 AT+FTPGETPATH ...............................................................................................................................23
2.3.11 AT+FTPPUTNAME..............................................................................................................................23
2.3.12 AT+FTPPUTPATH................................................................................................................................24
2.3.13 AT+FTPGET.........................................................................................................................................25
2.3.14 AT+FTPPUT .........................................................................................................................................26
3. Examples 27
3.1 Bearer profile ...........................................................................................................................................27
3.2 HTTP GET method .................................................................................................................................28
3.3 HTTP POST method ...............................................................................................................................28
3.4 HTTP HEAD method ..............................................................................................................................29
3.5 Set Proxy HTTP Server...........................................................................................................................29
3.6 Set HTTP Redirection Parameter...........................................................................................................30
3.7 Set HTTP Download Break Point Parameter........................................................................................31
3.8 FTP GET ..................................................................................................................................................31
3.9 FTP PUT...................................................................................................................................................32
3.10 FTP TIME OUT.....................................................................................................................................33
5

SIM900 IPAPPLICATION
SIM900 IPAPPLICATION
3.11 FTP ERROR...........................................................................................................................................34
3.12 FTP OPERATION ERROR..................................................................................................................34
3.13 FTP READ AND WRITE ERROR......................................................................................................34
6

SIM900 IPAPPLICATION
1. INTRODUCTION
1.1 Scope of the document
This document describes how to use AT commands for FTP and HTTP function.
1.2 Related documents
[1] SIM900 AT Commands Set.
[2] SIM900_TCPIP
1.3 Conventions and abbreviations
FTP File Transfer Protocol
HTTP Hypertext Transfer Protocol
APN Access Point Name
GPRS General Packet Radio Service
PDP Packet Data Protocol
SIM900 IPAPPLICATION
7

SIM900 IPAPPLICATION
SIM900 IPAPPLICATION
2. AT commands
2.1 AT+SAPBR
AT+SAPBR SIMCOM APPLICATION BEARER
Response
+SAPBR: (0-4), (1-3), “ConParamTag”, “ConParamValue”
OK
Test command
AT+SAPBR=?
Parameters
see Write Command
Response
OK
If<cmd_type> = 2
+SAPBR: <cid>,<Status>,<IP_Addr>
OK
If <cmd_type>=4
+SAPBR:
<ConParamTag>,<ConParamValue>
OK
Unsolicited Result Code
+SAPBR < cid >: DEACT
Write command
AT+SAPBR
=<cmd_type>,<cid>
,[<ConParamTag>,
<ConParamValue>]
Parameters
< cmd_type > 0: close bearer
1: openbearer
2: querybearer
3: setbearerparameters
4: getbearerparameters
< cid > bearer profile identifier
<Status> 0: bearer is connecting
1:bearerisconnected
2:bearerisclosing
3.bearerisclosed
8

SIM900 IPAPPLICATION
SIM900 IPAPPLICATION
9
<ConParamTag > bearer parameter
“CONTYPE” Type of Internet connection. Value refer to
<ConParamValue_ConType>
“APN” Accesspointnamestring:maximum50characters
“USER” Usernamestring:maximum50characters
“PWD” Passwordstring:maximum50characters
“PHONENUM” Phone number for CSD call
“RATE” CSDconnectionrate.valuereferto
<ConParamValue_Rate >
<ConParamValue > bearer paramer value
< ConParamValue_ConType >
“CSD” Circuit-switched data call.
“GPRS” GPRSconnection.
<ConParamValue_Rate >
0: 2400
1: 4800
2: 9600
3: 14400
<IP_Addr>: the IP address of bearer
Reference
Note
2.2 HTTP AT Commands
2.2.1 AT+HTTPINIT
AT+HTTPINIT HTTP Service Initialize
Test command
AT+HTTPINIT=?
Response
OK
Write command
AT+HTTPINIT
Response
OK

SIM900 IPAPPLICATION
SIM900 IPAPPLICATION
10
If error is related to ME functionality:
ERROR
Parameters
Reference
Note
Before using HTTP service, HTTPINIT should be executed to initialize the HTTP stack
firstly.
2.2.2 AT+HTTPTERM
AT+HTTPTERM HTTP Service Terminate
Test command
AT+HTTPTERM=
?
Response
OK
Response
OK
If error is related to ME functionality:
ERROR
Write command
AT+ HTTPTERM
Parameters
Reference
Note
2.2.3 AT+HTTPPARA
AT+HTTPPARA SET HTTP Parameters
Response
+HTTPPARA: “HTTPParamTag”,” HTTPParmValue”
OK
Test command
AT+HTTPPARA=?
Parameters
Write command
AT+ HTTPPARA
=< HTTPParamTag
>,<
Response
OK

SIM900 IPAPPLICATION
SIM900 IPAPPLICATION
11
If error is related to ME functionality:
ERROR
HTTPParamValue
>
Parameters
< HTTPParamTag > HTTP Parameter
“CID” (MandatoryParameter)bearerprofileidentifierreferto
AT+SAPBR
“URL” (MandatoryParameter)HTTPclientURL
"http://'server'/'path':'tcpPort' "
"server": FQDN or IP-address
"path": path of file or directory
"tcpPort": If parameter is omitted, the service connects to HTTP
default port 80.
Refer to "IETF-RFC 2616".
“UA” Theuseragentstringmustbesetbytheapplicationtoidentify
the mobile. Usually operation system and software version
info is set with this browser identifier.
“PROIP” TheIPaddressofHTTPproxyserver
“PROPORT”TheportofHTTPproxyserver
“REDIR” ThisflagcontrolstheredirectionmechanismoftheSIM900
acting as HTTP client (numeric).
If the flag is set (1) the client automatically sends a new
HTTP request if the server answers with a redirect code
(range 30x). Default value is 0 (no redirection).
“BREAK” Parameter for HTTP method "GET".
Get partly data range, breakPoint to the end.
Note:
Not all the HTTP Server support <BREAK> parameter
< HTTPParamValue > HTTP Parameter value .
Type and supported content depend on related parameters
< HTTPParamTag >.
Response
+ HTTPPARA: < HTTPParamTag >,< HTTPParamValue >
OK
Read command
AT+HTTPPARA?
Parameters
Reference
Note

SIM900 IPAPPLICATION
SIM900 IPAPPLICATION
2.2.4 AT+HTTPDATA
AT+HTTPDATA HTTP DATAWRITE
Response
+HTTPDATA: (1-60416), (1000-120000)
OK
Test command
AT+HTTPDATA=?
Parameters
Response
DOWNLOAD
OK
If error is related to ME functionality:
+CME ERROR: <err>
Write command
AT+HTTPDATA=<
size>,<time>
Parameters
<size> Size in bytes for the data which is put by the command of “POST”.
<time> Maximum time in milliseconds for inputting data.
Reference
Note
It is strongly recommended to set the time as long as enough to input all data and that the
real size of the downloaded file is no more than the value of <size>.
2.2.5 AT+HTTPACTION
AT+HTTPACTION HTTP method Action
Test command
AT+HTTPACTION
=?
Response
+HTTPACTION: (0-2)
OK
Write command
AT+HTTPACTION
=<Method>
Response
OK
If error is related to ME functionality:
+CME ERROR: <err>
Unsolicited Result Code
+HTTPACTION: <Method>< StatusCode >,<DataLen>
12

SIM900 IPAPPLICATION
SIM900 IPAPPLICATION
13
Parameter
< Method > HTTP method specification:
0: GET
1: POST
2: HEAD
<StatusCode> HTTP status code responded by remote server, its identifier refer to
HTTP1.1(RFC2616)
100 Continue
101 Switching Protocols
200 OK
201 Created
202 Accepted
203 Non-Authoritative Information
204 No Content
205 Reset Content
206 Partial Content
300 Multiple Choices
301 Moved Permanently
302 Found
303 See Other
304 Not Modified
305 Use Proxy
307 Temporary Redirect
400 Bad Request
401 Unauthorized
402 Payment Required
403 Forbidden
404 Not Found
405 Method Not Allowed
406 Not Acceptable
407 Proxy Authentication Required
408 Request Time-out
409 Conflict
410 Gone
411 Length Required
412 Precondition Failed
413 Request Entity Too Large
414 Request-URI Too Large
415 Unsupported Media Type
416 Requested range not satisfiable

SIM900 IPAPPLICATION
SIM900 IPAPPLICATION
14
417 Expectation Failed
500 Internal Server Error
501 Not Implemented
502 Bad Gateway
503 Service Unavailable
504 Gateway Time-out
505 HTTP Version not supported
600 Not HTTP PDU
601 Network Error
602 No memory
603 DNS Error
604 Stack Busy
<DataLen> the length of data got
Reference
Note
2.2.6 AT+HTTPREAD
AT+HTTPREAD Read the HTTP server response
Execution command
AT+HTTPREAD
Response
+HTTPREAD
<data>
OK
Read all the data response byAT+HTTPACTION=0 or AT+HTTPDATA
If error is related to ME functionality:
+CME ERROR: <err>
Write command
AT+ HTTPREAD
=<start_address><b
yte_size>
Response
+HTTPREAD: <date_len>
<data>
OK
Read part of the data response by AT+HTTPACTION=0 or AT+HTTPDATA
If the value of <byte_size> is bigger than the received data size, data will only return
actually data size.
If error is related to ME functionality:
+CME ERROR: <err>

SIM900 IPAPPLICATION
SIM900 IPAPPLICATION
15
Parameters
<data> The data of HTTP server response by AT+ HTTPACTION=0
<start_address> The starting point for data output
<byte_size> The length for data output
<data_len> The actual length for data output
Test command
AT+HTTPREAD=?
Response
+HTTPREAD: (1- 318976), (1- 318976)
OK
Reference
Note
The execution is used to send the HTTP server response to UART or the data ready to
POST the server.
2.3 FTP AT Commands
2.3.1 AT+ FTPPORT
AT+FTPPORT SET FTP CONTROL PORT
Response
OK
Test command
AT+FTPPORT =?
Parameters
Response
OK
If error is related to ME functionality:
ERROR
Write command
AT+FTPPORT
=<value>
Parameters
<value> The value of FTP Control port, from 1 to 65535.
Default value is 21

SIM900 IPAPPLICATION
SIM900 IPAPPLICATION
16
Response
+FTPPORT: < value >
OK
Read command
AT+ FTPPORT?
Parameters
See Write Command
Reference
Note
Numbers above 65535 are illegal as the port identification fields are 16 bits long in the
TCP header.
2.3.2 AT+ FTPMODE
AT+FTPMODE SET FTPACTIVE OR PASSIVE MODE
Response
OK
Test command
AT+FTPMODE =?
Parameters
Response
OK
If error is related to ME functionality:
ERROR
Write command
AT+FTPMODE
=<value>
Parameters
<value> 0 : Ftp active mode
1 : Ftp passive mode
Default value is 1
Response
+FTPMODE: < value >
OK
Read command
AT+FTPMODE?
Parameters
See Write Command
Reference
Note

SIM900 IPAPPLICATION
SIM900 IPAPPLICATION
2.3.3 AT+FTPTYPE
AT+FTPTYPE SET THE TYPE OF DATA TO BE TRANSFERRED
Response
OK
Test command
AT+FTPTYPE =?
Parameters
Response
OK
If error is related to ME functionality:
ERROR
Write command
AT+FTPTYPE
=<value>
Parameters
<value> “A” : for FTPASCII sessions
“I” : for FTP Binary sessions
Default value is “I”
Response
+FTPTYPE: < value >
OK
Read command
AT+FTPTYPE?
Parameters
See Write Command
Reference
Note
When this value is set to A, all the data sent by the stack to the FTP server is made of 7
bits characters (NVT-ASCII: the MSB is set to 0). As a consequence binary data
containing 8 bits characters will be corrupted during the transfer if the FTPTYPE is set
to A.
2.3.4 AT+FTPPUTOPT
AT+FTPPUTOPT SET FTP PUT TYPE
Response
OK
Test command
AT+FTPPUTOPT
=?
Parameters
17

SIM900 IPAPPLICATION
SIM900 IPAPPLICATION
18
Response
OK
If error is related to ME functionality:
ERROR
Write command
AT+FTPPUTOPT
=<value>
Parameters
<value> “APPE”: for append file
“STOU”:forstoreuniquefile
“STOR”:forstorefile
Default value is “STOR”
Response
+FTPPUTOPT: < value >
OK
Read command
AT+FTPPUTOPT?
Parameters
See Write Command
Reference
Note
2.3.5 AT+FTPCID
AT+FTPCID SET FTP BEARER PROFILE IDENTIFIER
Response
OK
Test command
AT+FTPCID=?
Parameters
Response
OK
If error is related to ME functionality:
ERROR
Write command
AT+FTPCID=<valu
e>
Parameters
<value> bearer profile identifier refer to AT+SAPBR
Read command
AT+FTPCID?
Response
+ FTPCID: < value >

SIM900 IPAPPLICATION
SIM900 IPAPPLICATION
19
OK
Parameters
See Write Command
Reference
Note
2.3.6 AT+FTPREST
AT+FTPREST RESUME BEOKEN DOWNLOADS
Response
OK
Test command
AT+ FTPREST =?
Parameters
Response
OK
If error is related to ME functionality:
ERROR
Write command
AT+FTPREST=<va
lue>
Parameters
<value> broken point to be resumed
Response
+ FTPREST: < value >
OK
Read command
AT+ FTPREST?
Parameters
See Write Command
Reference
Note

SIM900 IPAPPLICATION
SIM900 IPAPPLICATION
2.3.7 AT+FTPSERV
AT+FTPSERV SET FTP SERVER ADDRESS
Response
OK
Test command
AT+FTPSERV =?
Parameters
Response
OK
If error is related to ME functionality:
ERROR
Write command
AT+FTPSERV
=<value>
Parameters
<value> 32-bit number in dotted-decimal notation (i.e. xxx.xxx.xxx.xxx) or
alphanumeric ASCII text string up to 49 characters if DNS is available
Response
+FTPSERV: < value >
OK
Read command
AT+FTPSERV?
Parameters
See Write Command
Reference
Note
2.3.8 AT+FTPUN
AT+FTPUN SET FTPUSER NAME
Response
OK
Test command
AT+FTPUN=?
Parameters
20

SIM900 IPAPPLICATION
SIM900 IPAPPLICATION
21
Response
OK
If error is related to ME functionality:
ERROR
Write command
AT+FTPUN=<value
>
Parameters
<value> Alphanumeric ASCII text string up to 49 characters.
Response
+FTPUN: < value >
OK
Read command
AT+FTPUN?
Parameters
See Write Command
Reference
Note
2.3.8 AT+FTPPW
AT+FTPPW SETFTPPASSWORD
Response
OK
Test command
AT+FTPPW =?
Parameters
Response
OK
If error is related to ME functionality:
ERROR
Write command
AT+FTPPW
=<value>
Parameters
<value> Alphanumeric ASCII text string up to 49 characters.
Read command
AT+FTPPW?
Response
+FTPPW: < value >
OK