Page 1
Wireless GPRS-F4 Modems with IP Connectivity ® MultiModem GPRS (MTCBA-G-F4) MMCModem™ GPRS (MTMMC-G-F4) ® SocketModem GPRS (MTSMC-G-F4) IP Connectivity AT Commands Reference Guide...
Page 2
Furthermore, Multi-Tech Systems, Inc. reserves the right to revise this publication and to make changes from time to time in the content hereof without obligation of Multi-Tech Systems, Inc. to notify any person or organization of such revisions or changes. Revisions...
GPRS HTTP IPCP MSCHAP POP3 SMTP UART Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Access Point Name American Standard Code for Information Interchange ATtention Blind Carbon Copy Carbon Copy Challenge Handshake Authentication Protocol Card Holder Verification...
A host computer, which issues AT+WIP commands • Wavecom’s wireless CPU® • The rest of the Internet / Intranet Host UART AT Commands Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 1 – Introduction Wavecom INTERNET WCPU...
AT+WOPEN=1 Open the TCP/IP Stack If WOPEN is set to 0, the TCP/IP stack is not opened. In some instances, this may be the default setting. Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 1 – Introduction...
This is used to avoid a situation in which an undelivered datagram keeps circulating in the network. Range: 0-255 (default value: 64) Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 2 – General Configuration AT Commands Commands AT+WIPCFG=<mode>...
Page 8
Plug-in WIP Lib would not send any TCP segment having a length greater than 536 bytes without header. Range: 536-1460 (default value: 536) Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 2 – General Configuration AT Commands IP Stack Handling +WIPCFG Continued...
Page 9
Each unit in the range represents 100 msec. For example, value 10 for this option will give a wait time of 1sec (10 *100mesc). Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 2 – General Configuration AT Commands...
Page 10
The possible error message is displayed only if “AT+CMEE=1” is activated else “ERROR” is displayed. +CMEE AT error code Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 2 – General Configuration AT Commands IP Stack Handling +WIPCFG Continued WIP soft release version...
Page 11
Note: Store IP configuration parameters into FLASH AT+WIPCFG=4,0 Note: Free IP configuration parameters stored in FLASH Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 2 – General Configuration AT Commands IP Stack Handling +WIPCFG Continued Responses...
Page 12
• WIP_NET_OPT_SOCK_MAX • WIP_NET_OPT_BUF_MAX • WIP_NET_OPT_IP_ROUTE_MAX • WIP_NET_OPT_RSLV_QUERY_MAX • WIP_NET_OPT_RSLV_CACHE_MAX Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 2 – General Configuration AT Commands IP Stack Handling +WIPCFG Continued...
Parameters/ Defined Values: <cmd type> <bid> 11..14 21..24 <opt num> Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 2 – General Configuration AT Commands Response OK AT+WIPBR=<cmdtype>,<bid>,<opt num>,<value> Response OK AT+WIPBR=<cmdtype>,<bid>,<opt num> Response OK AT+WIPBR=<cmdtype>,<bid>,<mode>[,<login>,...
Page 14
<value>: <mode>: <state>: Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 2 – General Configuration AT Commands Bearers Handling +WIPBR continued WIP_BOPT_DIAL_PHONENB phone number (string) max: 32 characters WIP_BOPT_DIAL_RINGCOUNT Number of rings to wait before sending the...
Page 15
The possible error message is displayed only if “AT+CMEE=1” is activated else “ERROR” is displayed. +CMEE AT error code Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 2 – General Configuration AT Commands Bearers Handling +WIPBR Continued result of the connection process successful any other value: to be matched to error code value (e.g., “814”...
Page 16
AT+WIPBR=5,5 Note: Stop the GSM bearer AT+WIPBR=0,5 Note: Close the GSM bearer Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 2 – General Configuration AT Commands Bearers Handling +WIPBR Continued Responses Note: Bearer UART1 is open but not...
Page 17
"0.0.0.0". Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 2 – General Configuration AT Commands Bearers Handling +WIPBR Continued...
AT commands (except phonebooks, AOC, SMS), but is still in emergency mode. See Appendix A – GSM/GPRS +WIND AT Command. Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 3 – IP Protocol Services Closed...
Page 19
If <mode>=3 +WIPACCEPT: <server index>,<communication idx> If <mode>=5, 6 or 7 +WIPREADY: <mode>,<index> Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 3 – IP Protocol Services Service Creation +WIPCREATE Continued Connect request Client Socket...
Page 20
More pairs (name, value) of HTTP message header field can be added. Parameter Storage: None Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 3 – IP Protocol Services Service Creation +WIPCREATE Continued a string between quotes indicating an address either...
Page 21
Possible Errors: +CMEE” AT error code Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 3 – IP Protocol Services Service Creation +WIPCREATE Continued Description operation not allowed invalid option operation not allowed in the current WIP stack state...
Page 22
Client/1.0”,"Accept-Encoding","gzip","Accept- Language","en-US" AT+WIPCREATE=5,1,“proxyaddress“,,”user”,”pa ss” Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Service Creation +WIPCREATE Continued Responses Note: An unsolicited event +WIPREADY: 1,1 will be received once the UDP socket is ready for usage...
Page 23
SIM card is required only if FTP session is established through GSM or GPRS. An FTP session upon an UART will work without a SIM card. Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 3 – IP Protocol Services...
<idx>: Parameter Storage: None Possible Errors: “+CMEE” AT error code Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 3 – IP Protocol Services Closing a Service +WIPCLOSE TCP client TCP server HTTP SMTP POP3...
Page 25
FTP protocol, the closure of FTP session is indicated by +WIPEERCLOSE unsolicited response when +WIPCLOSE command is used for closing the session. Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 3 – IP Protocol Services...
<optnum>: <optval>: Parameter Storage: None Possible Errors: +CMEE AT error code Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 3 – IP Protocol Services Service Option Handling +WIPOPT AT+WIPOPT=<protocol>,<idx>,<action>,<optnum> Response OK AT+WIPOPT=<protocol>,<idx>,<action>,<optnum>,<optval> Response OK Displays the current values.
Page 27
Note: Get total mail size AT+WIPOPT=7,1,1,73 Note: Get mail listing AT+WIPOPT=7,1,2,74,10 Note: Delete mail ID 10 Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 3 – IP Protocol Services Service Option Handling +WIPOPT continued Responses +WIPOPT: 2,1,8,20...
Page 28
Caution: Option 54(WIP_COPT_HTTP_HEADER) is not implemented and hence attempt to read this option will result in +CME ERROR: 834. Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 3 – IP Protocol Services Service Option Handling +WIPOPT Continued...
Page 29
Not a POP3 WIP Option Not a POP3 WIP Option Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 3 – IP Protocol Services Service Option Handling +WIPOPT Continued Meaning code and associated...
Wireless CPU®. Data contains an [ETX] character escaped by a [DLE] character ([DLE] [ETX] sequence), then the [ETX] character is transmitted as data. Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 4 – Data Exchange for Protocol Services...
Page 31
[DLE] character when it is sent to host through the serial port. Command Syntax: If <protocol>=4: If <protocol>=5: If <protocol>=6: Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 4 – Data Exchange for Protocol Services File Exchange +WIPFILE continued Desktop PC2 Internet Data received from PC1: “abc[DLE]d”...
Page 32
Test Command: AT+WIPFILE=? Parameters/Defined Values: <protocol>: <idx>: <mode>: <filename>: Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 4 – Data Exchange for Protocol Services File Exchange +WIPFILE continued AT+WIPFILE=<protocol>,<index>,<mode>,<filename> Response: CONNECT … status reason>...
Page 33
Parameter Storage: None Possible Errors: “+CMEE” AT Error Code Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 4 – Data Exchange for Protocol Services File Exchange +WIPFILE continued User name in string format Password in string format...
Page 34
Note: Send data to the given filename AT+WIPFILE=5,1,1,”urlForGet”,”user name”,”password”,”Accept”,”text/html” Note: Send a HTTP GET request to Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 4 – Data Exchange for Protocol Services File Exchange +WIPFILE continued Responses CONNECT <data received terminated by...
Page 35
The [ETX] character is considered as an end of data. Hence, in case [ETX] character needs to be transmitted, it should be preceded by [DLE] character. Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 4 – Data Exchange for Protocol Services...
AT+WIPDATA=1, index, 0 on another UART, the currently unsent data are sent as a single datagram. Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 4 – Data Exchange for Protocol Services...
Page 37
Note that the behavior is symmetrical; i.e., it applies to both the transmitting and receiving side of the mapped UART. Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 4 – Data Exchange for Protocol Services...
Page 38
UDP sockets do not support this mode. Attempting to map an UART in this mode will result in a “+CME ERROR: 837”. Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 4 – Data Exchange for Protocol Services...
Page 39
Parameter Storage: None Possible Errors: “+CMEE” AT error code Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 4 – Data Exchange for Protocol Services Socket Data Exchange +WIPDATA Continued IP>,<peer port> Using +WIP AT commands, when receiving several UDP bytes>...
Page 40
This indicates that no more data can be sent from the host socket, but it can receive data. The following schematic shows the shutdown procedure for a TCP socket. Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 4 – Data Exchange for Protocol Services...
Page 41
Please note that the retransmission of the data to the peer TCP socket within the timeout period is managed by the Open AT Plug-in WIP Lib. Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 4 – Data Exchange for Protocol Services...
Page 42
In some scenarios, there might be a segmentation of data packets because of timer expiration, network problems etc. Thus a single packet of data may be received in more than one packet at the peer. Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E)
<response_time>: PING response time in millisecond Parameter Storage: None Possible Errors: “+CMEE” AT error code Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) host name or IP address string number of packets to send range: 1-65535 (default value:1)
Page 44
2000 ms (if ping responses time is more than 1000 ms then timeout expires) Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 5 – Ping Services PING Command +WIPPING Continued...
AT+WIPBR=4,6,0 AT+WIPCREATE=3,1,80,5,8 +WIPACCEPT: 1,5 AT+WIPDATA=2,5,1 CONNECT AT+WIPCLOSE=2,5 Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 6 – Application Examples //open TCP/IP stack //start IP stack //open GPRS bearer //set APN name of GPRS bearer //set user name (<login>)
+WIPREADY: 1,1 +WIPDATA: 1,1,25,"192.168.0.2",2397 AT+WIPDATA=1,1,1 CONNECT abcedghijklmnopqrstuvwxyz[ETX] Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 6 – Application Examples //open TCP/IP stack //start IP stack //open GPRS bearer //set APN name of GPRS bearer...
Page 50
AT+WIPDATA=1,1,1 CONNECT abcedghijklmnopqrstuvwxyzabced ghijklmnopqrstuvwxyz [ETX] Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 6 – Application Examples //type on this UART “+++” escape sequence or //unmap the UART on other control port (USB //UART) //here UART is back to AT command mode.
<user starts getting the mail with the UART in data mode and ends with an [ETX] > +WIPFILE: 5,1,1,255,”Found” Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 6 – Application Examples //open TCP/IP stack...
CONNECT <user starts sending mail with the UART in data mode and ends with an [ETX] character > Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 6 – Application Examples //Open TCP/IP stack //start IP stack...
CONNECT <user starts getting the mail with the UART in data mode and ends with an [ETX] > Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 6 – Application Examples //open TCP/IP stack //start IP stack...
AT+WIPCREATE=1,3,57,”192.168.0.1”,77 +WIPREADY: 1,3 AT+WIPCREATE=1,4,58,”192.168.0.1”,78 +WIPREADY: 1,4 AT+WIPCREATE=1,5,59,”192.168.0.1”,79 Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 6 – Application Examples //open TCP/IP stack //start IP stack //open GPRS bearer //set APN name of GPRS bearer...
Page 58
+WIPACCEPT: 1,1 +WIPACCEPT: 2,2 +WIPACCEPT: 3,3 Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 6 – Application Examples //unsolicited: the UDP client socket is “pseudo //”connected to the peer (no real connection is UDP) //create a UDP client towards peer IP device @ //“192.168.0.1”, port 80.
Page 59
AT+WIPCREATE=2,8,”192.168.0.1”,80 +CME ERROR: 840 AT+WIPCREATE=2,9,”192.168.0.1”,80 +CME ERROR: 830 Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 6 – Application Examples //unsolicited: the server index 4 accepted a //connection; resulting TCP client on idx 4 //create a TCP client towards peer IP device @ //“192.168.0.1”, port 80.
92.168.0.1”,76 +WIPREADY: 1,2 AT+WIPCREATE=1,3,57,”1 92.168.0.1”,77 +WIPREADY: 1,3 Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 6 – Application Examples //open TCP/IP stack //start IP stack //MAX_SOCK_NUM has been changed to 3 //save the changed configuration to flash...
Page 61
AT+WIPCREATE=1,4,58,”1 92.168.0.1”,78 +CME ERROR: 838 Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 6 – Application Examples //create a UDP client towards peer IP device @ //“192.168.0.1”, port 78. //maximum 3 sockets can be created as the //MAX_SOCK_NUM value has been changed to 3.
+WIPREADY: 1,2 AT+WIPCREATE=1,3,57,”192.168.0.1”,77 +WIPREADY: 1,3 AT+WIPCREATE=1,4,58,”192.168.0.1”,78 +WIPREADY: 1,4 Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 6 – Application Examples //open TCP/IP stack //start IP stack //open GPRS bearer //set APN name of GPRS bearer...
Page 63
+CME ERROR: 830 AT+WIPCREATE=2,1,”192.168.0.1”,83 +CME ERROR: 845 +WIPACCEPT: 1,1 Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 6 – Application Examples //create a UDP client towards peer IP device @ //“192.168.0.1”, port 79. //all parameters and IP stack behavior are OK //unsolicited: the UDP client socket is “pseudo...
Page 64
+CME ERROR: 840 AT+WIPCLOSE=4,1 +WIPPEERCLOSE: 4,1 Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 6 – Application Examples //unsolicited: the server index 2 accepted a //connection; resulting TCP client on idx 2 //unsolicited: the server index 3 accepted a //connection;...
Page 65
AT+WIPCREATE=7,1,”POP3 server”,,”user name”,”mail id” +WIPREADY: 7,1 Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 6 – Application Examples //create POP3 session using default port 110 //all parameters and IP stack behaviors are OK. //unsolicited: the POP3 session is created...
/* The customer can write here its own application based on other plug-ins or its specific application target. */ wip_ATCmdUnsubscribe(); else /* Error while subscribing to WIP Soft library */ Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 6 – Application Examples...
851-859 reserved for future use protocol undefined or internal error username rejected by server password rejected by server delete error Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 7 – Error Codes...
Page 68
SMTP CC recipient email address rejected by server SMTP BCC recipient email address rejected by server SMTP email body send request rejected by server Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Chapter 7 – Error Codes...
Product is ready to process all AT commands, end of phonebook init or swap (FDN to ADN) Call <idx> has been created (after ATD or +CCWA…) Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Appendix A – GSM/GPRS +WIND Command Command No unsolicited “+WIND: <IndNb>”...
Page 70
5: LSA identity • 6: Network Daylight Saving Time Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Appendix A – GSM/GPRS +WIND Command quarters of an hour, between the local time and GMT. format "yy/MM/dd,hh:mm:ss±zzz"...
Page 71
• +WIND: <event>[,1,"Full name>"][,2,"<Short name>"][,3,"<Local time zone>"][,4,"<Universal time and local time zone>"][,5,"<LSA identity>"][,6,"<Daylight Saving Time>"] Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Appendix A – GSM/GPRS +WIND Command Possible Responses +WIND: 0 +WIND: 0 Note :The SIM presence pin has been detected as “SIM...
PING ...51 POP3 ...55 SMTP ...54 Subscribe/Unsubscribe Commandsr...66 Multi-Tech Systems, Inc. IP Connectivity AT Commands for GPRS-F4 Wireless Modems (PN S000437E) Index TCP Client Socket Using GPRS Bearer ...47 TCP Client Socket Using GSM Bearer...48 TCP Server Socket Using GPRS Bearer ...45 TCP Server Socket Using GSM Bearer ...46...
Need help?
Do you have a question about the MTMMC-G-F4 and is the answer not in the manual?
Questions and answers