How it Works
SimCom
Loading...
SIM900B
Application Note
35 pgs303.67 Kb0
Command Manual
8 pgs111.82 Kb0
User Manual
21 pgs736.5 Kb0

SimCom SIM900B Application Note

Download
FTP HTTP AT Commands User Guide
AN_SIM900_FTP_HTTP_APP_V1.00
SIM900 IP APPLICATION
SIM900 IP APPLICATION
IP Application 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 IP APPLICATION
SIM900 IP APPLICATION
VERSION HISTORY
Now document: SIM900 IP Application Note” Version 1.00
Version
Chapter
What is new
V1.00 NEW
4
SIM900 IP APPLICATION
SIM900 IP APPLICATION
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 A T+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 A T+ FTPMOD ........................................................................................................................................16
2.3.3 A T+FTPTYPE.........................................................................................................................................17
2.3.4 A T+FTPPUTOPT....................................................................................................................................17
2.3.5 A T+FTPCID............................................................................................................................................18
2.3.6 A T+FTPREST.........................................................................................................................................19
2.3.7 A T+FTPSERV.........................................................................................................................................20
2.3.8 A T+FTPUN.............................................................................................................................................20
2.3.8 A T+FTPPW.............................................................................................................................................21
2.3.9 A T+ FTPGETNAME .............................................................................................................................. 22
2.3.10 A T+FTPGETPATH ...............................................................................................................................23
2.3.11 AT+FTPPUTNAME..............................................................................................................................23
2.3.12 A T+FTPPUTPATH................................................................................................................................24
2.3.13 A T+FTPGET.........................................................................................................................................25
2.3.14 A T+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 IP APPLICATION
SIM900 IP APPLICATION
3.11 FTP ERROR...........................................................................................................................................34
3.12 FTP OPERATION ERROR..................................................................................................................34
3.13 FTP READ AND WRITE ERROR......................................................................................................34
6
SIM900 IP APPLICATION
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 IP APPLICATION
7
SIM900 IP APPLICATION
SIM900 IP APPLICATION
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: open bearer 2: query bearer 3: set bearer parameters 4: get bearer parameters
< cid > bearer profile identifier
<Status> 0: bearer is connecting
1: bearer is connected 2: bearer is closing
3. bearer is closed
8
SIM900 IP APPLICATION
SIM900 IP APPLICATION
9
< ConParamTag > bearer parameter “CONTYPE” Type of Internet connection. Value refer to
< ConParamValue_ConType>
“APN” Access point name string: maximum 50 characters “USER” User name string: maximum 50 characters “PWD” Password string: maximum 50 characters
“PHONENUM” Phone number for CSD call
“RATE” CSD connection rate. value refer to
< ConParamValue_Rate >
< ConParamValue > bearer paramer value
< ConParamValue_ConType > “CSD” Circuit-switched data call.
“GPRS” GPRS connection.
< 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 IP APPLICATION
SIM900 IP APPLICATION
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 IP APPLICATION
SIM900 IP APPLICATION
11
If error is related to ME functionality:
ERROR
HTTPParamValue >
Parameters < HTTPParamTag > HTTP Parameter “CID” (Mandatory Parameter) bearer profile identifier refer to
AT+SAPBR
“URL” (Mandatory Parameter) HTTP client URL
"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” The user agent string must be set by the application to identify
the mobile. Usually operation system and software version
info is set with this browser identifier. “PROIP” The IP address of HTTP proxy server “PROPORT” The port of HTTP proxy server “REDIR” This flag controls the redirection mechanism of the SIM900
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 IP APPLICATION
SIM900 IP APPLICATION
2.2.4 AT+HTTPDATA
AT+HTTPDATA HTTP DATA WRITE
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 IP APPLICATION
SIM900 IP APPLICATION
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 IP APPLICATION
SIM900 IP APPLICATION
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 by AT+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+HTTP ACTION=0 or A T+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 IP APPLICATION
SIM900 IP APPLICATION
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 A T+ F TPPORT
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 IP APPLICATION
SIM900 IP APPLICATION
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 FTP ACTIVE 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 IP APPLICATION
SIM900 IP APPLICATION
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 FTP ASCII 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 IP APPLICATION
SIM900 IP APPLICATION
18
Response
OK
If error is related to ME functionality:
ERROR
Write command
AT+FTPPUTOPT =<value>
Parameters <value> “APPE”: for append file “STOU”: for store unique file “STOR”: for store file
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 IP APPLICATION
SIM900 IP APPLICATION
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 IP APPLICATION
SIM900 IP APPLICATION
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 FTP USER NAME
Response
OK
Test command
AT+FTPUN=?
Parameters
20
SIM900 IP APPLICATION
SIM900 IP APPLICATION
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 SET FTP PASSWORD
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
SIM900 IP APPLICATION
SIM900 IP APPLICATION
22
Parameters See Write Command
Reference
Note
2.3.9 AT+ FTPGETNAME
AT+FTPGETNAME SET DOWNLOAD FILE NAME
Response
OK
Test command
AT+FTPGETNAM E =?
Parameters
Response
OK
If error is related to ME functionality:
ERROR
Write command
AT+FTPGETNAM E =<value>
Parameters <value> Alphanumeric ASCII text string up to 99 characters
Response
+ FTPGETNAME: < value >
OK
Read command
AT+FTPGETNAM E?
Parameters See Write Command
Reference
Note
SIM900 IP APPLICATION
SIM900 IP APPLICATION
2.3.10 AT+FTPGETPATH
AT+FTPGETPATH SET DOWNLOAD FILE PATH
Response
OK
Test command
AT+FTPGETPATH =?
Parameters
Response
OK
If error is related to ME functionality:
ERROR
Write command
AT+FTPGETPATH =<value>
Parameters <value> Alphanumeric ASCII text string up to 99 characters
Response
+FTPGETPATH: < value >
OK
Read command
AT+FTPGETPATH ?
Parameters See Write Command
Reference
Note
2.3.11 AT+FTPPUTNAME
AT+FTPPUTNAME SET UPLOAD FILE NAME
Response
OK
Test command
AT+FTPPUTNAM E=?
Parameters
23
SIM900 IP APPLICATION
SIM900 IP APPLICATION
24
Response
OK
If error is related to ME functionality:
ERROR
Write command
AT+FTPPUTNAM E =<value>
Parameters <value> Alphanumeric ASCII text string up to 99 characters
Response
+FTPPUTNAME: < value >
OK
Read command
AT+FTPPUTNAM E?
Parameters See Write Command
Reference
Note
2.3.12 AT+FTPPUTPATH
AT+FTPPUTPATH SET UPLOAD FILE PATH
Response
OK
Test command
AT+FTPPUTPATH =?
Parameters
Response
OK
If error is related to ME functionality:
ERROR
Write command
AT+FTPPUTPATH =<value>
Parameters <value> Alphanumeric ASCII text string up to 99 characters
SIM900 IP APPLICATION
SIM900 IP APPLICATION
25
Response
+FTPPUTPATH: < value >
OK
Read command
AT+FTPPUTPATH ?
Parameters See Write Command
Reference
Note
2.3.13 AT+FTPGET
AT+FTPGET SET DOWNLOAD FILE
Response
OK
Test command
AT+FTPGET =?
Parameters
Write command
AT+FTPGET =<mode>,[< reqlength>]
Response If mode is 1, it is a successful FTP get session:
OK +FTPGET:1,1
If data transfer finished:
+FTPGET:1,0
If mode is 1, it is a failed FTP get session:
OK +FTPGET:1,<error>
If mode is 2:
+FTPGET:2,<cnflength> 012345678… OK
If error is related to ME functionality:
ERROR
SIM900 IP APPLICATION
SIM900 IP APPLICATION
26
Parameters < mode> 1: for open FTP get session 2: for read FTP download data. <reqlength> Requested number of data bytes (1-1460)to be read <cnflength> Confirmed number of data bytes to be read, which may be less than
<length>. 0 indicates that no data can be read.
<error>61 Net error 62 DNS error 63 connect error 64 timeout 65 server error 66 operation not allow 70 replay error 71 user error 72 password error 73 type error 74 rest error 75 passive error 76 active error 77 operate error 78 upload error
79 download error
Reference
Note
When “+FTPGET:1,1” is shown, then user can use AT+FTPGET:2,<reqlength> to read data. If the module still has unread data, “+FTPGET:1,1” will be shown again in a certain time.
2.3.14 AT+FTPPUT
AT+FTPPUT SET UPLOAD FILE
Response
OK
Test command
AT+FTPPUT=?
Parameters
SIM900 IP APPLICATION
SIM900 IP APPLICATION
27
Response If mode is 1, it is a successful FTP get session:
OK +FTPPUT:1,1,<maxlength>
If mode is 1, it is a failed FTP get session:
OK +FTPPUT:1,<error>
If mode is 2 and <reqlength> is not 0 +FTPPUT:2,<cnflength> …… //Input data OK
If mode is 2 and <reqlength> is 0, response OK, and FTP session will be closed
OK
If data transfer finished. +FTPPUT:1,0
If error is related to ME functionality:
ERROR
Write command
AT+FTPPUT =<mode>,[< reqlength>]
Parameters < mode> 1: for open FTP put session 2: for write FTP upload data. <reqlength> Requested number of data bytes(0-<maxlength>) to be transmitted <cnflength> Confirmed number of data bytes to be transmitted <maxlength>The max length of data can be sent at one time. It depends on the network
status.
<error> see AT+FTPGET
Reference
Note When “+FTPPUT:1,1,<maxlength>” is shown, then use AT+FTPPUT=2, <reqlength> to write data.
3. Examples
3.1 Bearer profile
SIM900 IP APPLICATION
SIM900 IP APPLICATION
28
Demonstration Syntax Expect Result
Configure bearer profile 1 AT+SAPBR=3,1,"Contype","GPRS"
AT+SAPBR=3,1,"APN","CMNET"
OK
OK
To open a GPRS context. AT+SAPBR =1,1 OK
To query the GPRS context.
AT+SAPBR=2,1
+SAPBR: 1,1,"10.89.193.1" OK
To close a GPRS context.
AT+SAPBR =0,1 OK
GPRS context is released by network
+SAPBR 1: DEACT
3.2 HTTP GET method
Demonstration Syntax Expect Result
Init http service AT+HTTPINIT OK
Set parameters for HTTP session AT+HTTPPARA = “CID”,1
AT+HTTPPARA=“URL”,”www.si m.com”
OK
OK
GET session start
AT+HTTPACTION=0 OK
GET successfully +HTTPACTION:0,200,1000
Read the data of HTTP server AT+HTTPREAD +HTTPREAD: 1000
…. //output the data to uart OK
Terminate http service AT+HTTPTERM OK
3.3 HTTP POST method
Demonstration Syntax Expect Result
Init http service AT+HTTPINIT OK
SIM900 IP APPLICATION
SIM900 IP APPLICATION
29
Set parameters for HTTP session AT+HTTPPARA = “CID”,1
AT+HTTPPARA=“URL”,”www.si m.com”
OK
OK
POST the data whose size is 100 Bytes and the maximum latency time for inputting is 10000 ms. It is recommended to set the latency time long enough to download all the data in the latency time.
AT+HTTPDATA=100,10000 DOWNLOAD
…… //It is ready to receive
data from uart , and DCD has been set to low. OK //All data has been received over, and DCD is set to high.
POST session start
AT+HTTPACTION=1 OK
POST successfully +HTTPACTION:1,200,0
Terminate http service AT+HTTPTERM OK
3.4 HTTP HEAD method
Demonstration Syntax Expect Result
Init http service AT+HTTPINIT OK
Set parameters for HTTP session AT+HTTPPARA = “CID”,1
AT+HTTPPARA=“URL”,”www.si m.com”
OK
OK
HEAD session start
AT+HTTPACTION=1 OK
HEAD successfully +HTTPACTION:1,200,0
Terminate http service AT+HTTPTERM OK
3.5 Set Proxy HTTP Server
Demonstration Syntax Expect Result
Init http service AT+HTTPINIT OK
SIM900 IP APPLICATION
SIM900 IP APPLICATION
30
Set parameters for HTTP session AT+HTTPPARA = “CID”,1
AT+HTTPPARA=“URL”,”www.si m.com”
OK
OK
Set proxy server IP address AT+HTTPPARA=“PROIP”,”10.0.0.
172”
OK
Set proxy server port AT+HTTPPARA = “PROPORT”,80 OK
GET session start
AT+HTTPACTION=0 OK
GET successfully +HTTPACTION:0,200,1000
Read the data of HTTP server AT+HTTPREAD +HTTPREAD: 1000
…. //output the data to uart OK
Terminate http service AT+HTTPTERM OK
3.6 Set HTTP Redirection Parameter
Demonstration Syntax Expect Result
Init http service AT+HTTPINIT OK
Set parameters for HTTP session AT+HTTPPARA = “CID”,1
OK
Set the redirection parameter AT+HTTPPARA = “REDIR”,1 OK
Set the wrong URL AT+HTTPPARA=“URL”,”www.si
m.com/abcde”
OK
GET session start
AT+HTTPACTION=0 OK
GET successfully +HTTPACTION:0,200,1000
Read the response of HTTP server AT+HTTPREAD +HTTPREAD: 1000
…. //output the data to uart OK
Terminate http service AT+HTTPTERM OK
SIM900 IP APPLICATION
SIM900 IP APPLICATION
3.7 Set HTTP Download Break Point Parameter
Demonstration Syntax Expect Result
Init http service AT+HTTPINIT OK
Set parameters for HTTP session AT+HTTPPARA = “CID”,1 OK
Set the URL, the size of gif is 16384 bytes
AT+HTTPPARA = “URL”,” http://www.sim.com/img/sim_logo_j r_1003_38.gif”
OK
Set the wrong URL AT+HTTPPARA = “BREAK”,2000 OK
GET session start, get data from 2000 to 16384
AT+HTTPACTION=0 OK
GET successfully +HTTPACTION:0, 200,14384
Read the data of HTTP server AT+HTTPREAD +HTTPREAD: 14384
…. //output the data to uart OK
Terminate http service AT+HTTPTERM OK
3.8 FTP GET
Demonstration Syntax Expect Result
Set parameters for FTP session AT + F T PCID=1
AT+FTPSERV="116.228.221.52"
AT+FTPUN="sim.cs1"
AT+FTPPW="******"
AT+FTPGETNAME="1K.txt"
AT+FTPGETPATH="/"
OK
OK
OK
OK
OK
OK
Open the FTP get session AT+FTPGET=1 OK
Data are available +FTPGET:1,1
31
SIM900 IP APPLICATION
SIM900 IP APPLICATION
32
Request to read 1024 bytes, but Only 50 bytes are now available.
AT+FTPGET=2,1024
+FTPGET:2,50 0123456789012345678901234 5678901234567890123456789 0 OK
Request to read 1024 bytes again. 0 bytes are now available, but it is not the end of session
AT+FTPGET=2,1024 +FTPGET:2,0
OK
If the module receives data but user do not input “AT+FTPGET:2, <reqlength>” to read data, “+FTPGE T:1,1” will be shown again in a certain time.
+FTPGET:1,1
Request to read 1024 bytes. 1024 bytes are now available.
AT+FTPGET=2,1024
+FTPGET:2,1024 0123456789012345678901234 5678901234567890123456789 0…..1234 OK
Data transfer finished. The connection to the FTP server is closed.
+FTPGET:1,0
3.9 FTP PUT
Demonstration Syntax Expect Result
Set parameters for FTP session AT + F T PCID=1
AT+FTPSERV="116.228.221.52"
AT+FTPUN="sim.cs1"
AT+FTPPW="******"
AT+FTPPUTNAME="1K.txt"
AT+FTPPUTPATH="/"
OK
OK
OK
OK
OK
OK
SIM900 IP APPLICATION
SIM900 IP APPLICATION
33
Open the FTP put session AT+ FTPPUT =1 OK
FTP session is ready for upload. 1280 is the max length of data which can be sent at a time. It depends on the network status.
+FTPPUT:1,1,1280
Client requests to send 100 bytes. Response will indicates that user must input 100 bytes for transferring now.
AT+FTPPUT=2,100 +FTPPUT:2,100
…… //It is ready to receive
data from uart , and DCD has been set to low. OK //All data has been received over, and DCD is set to high.
URC indicates that the FTP session is ready to transfer more data.
+FTPPUT:1,1,1280
No more data will be uploaded. the FTP session will be closed.
AT+FTPPUT=2,0 OK
Data transfer finished. The connection to the FTP server is closed.
+FTPPUT:1,0
3.10 FTP TIME OUT
Demonstration Syntax Expect Result
Open the FTP Get session AT+ FTPGET =1 OK
If the status of the network is poor, may be time out. The connection to the FTP server is closed
+FTPGET:1,64
Open the FTP Get session AT+ FTPGET =1 OK
Data are available +FTPGET:1,1
If costumer do not use “AT+FTPGET:2, <reqlength>” to read data, “+FTPGE T:1,1” will be shown again in a certain time.
+FTPGET:1,1
…….. +FTPGET:1,1
SIM900 IP APPLICATION
SIM900 IP APPLICATION
34
If the user do not read data for a
long time , the session will time out.
The connection to the FTP server is closed.
+FTPGET:1,64
3.11 FTP ERROR
Demonstration Syntax Expect Result
Set wrong password
AT+FTPPW="3214567" OK
Open the FTP Get session AT+ FTPGET =1 OK
FTP session password error. The connection to the FTP server is closed
+FTPPUT:1,72
Note : Another error ,you can see AT+FTPGET
3.12 FTP OPERATION ERROR
Demonstration Syntax Expect Result
Open the FTP Get session.
AT+ FTPGET =1 OK
The parameter of “get file name” is empty. Show ftp operation error
+FTPPUT:1,66
Open the FTP PUT session AT+ FTPPUT =1 OK
Open the FTP PUT session again. Show ftp operation error
AT+ FTPPUT =1 OK
+FTPPUT:1,66
3.13 FTP READ AND WRITE ERROR
Demonstration Syntax Expect Result
Open the FTP Get session.
AT+ FTPGET =1 OK
SIM900 IP APPLICATION
SIM900 IP APPLICATION
35
Read data before “+FTPGET:1,1” is shown
AT+FTPGET=2,1000 ERROR
Data are available +FTPGET:1,1
Read data after “+FTPGET:1,1” is shown
AT+ FTPGET =1 +FTPGET:2,50
0123456789012345678901234 5678901234567890123456789 0
OK Data transfer finished. The connection to the FTP server is closed.
+FTPGET:1,0
Read data after FTP session is stopped
AT+FTPGET=2,1000 ERROR
Open the FTP PUT session.
AT+ FTPPUT =1 OK
Write data before “+FTPPU T:1,1,1280” is shown
AT+FTPPUT=2,1000 ERROR
FTP session is ready for upload +FTPPUT:1,1,1280
Write data after “+FTPPU T:1,1,1280” is shown
AT+FTPPUT=2,100 +FTPPUT:2,100
……
OK No more data will be uploaded. the FTP session will be closed.
AT+FTPPUT=2,0 OK
Write data after FTP session is stopped
AT+ FTPPUT=2,100 ERROR
SIM900 IP APPLICATION
SIM900 IP APPLICATION
Contact us: Shanghai SIMCom Wireless Solutions Ltd.
Add: Building A, SIM Technology Building, No.633 Jinzhong Road, Changning District, Shanghai, P. R. China 200335 Tel: +86 21 3252 3300 Fax: +86 21 3252 3301 URL:
www.sim.com/wm
36
Loading...
Buy Points How it Works FAQ Contact Us Questions and Suggestions Privacy Policy Cookie Policy Terms of Use