background image

 

 

 
 
 
 
 

 

Wireless GPRS-F1/F2 Modems 

with IP Connectivity 

 

 

 
 
 
 

MultiModem

®

 GPRS 

(MTCBA-G)

 

ModemModule

 GPRS 

(MTMMC-G)

 

SocketModem

®

 GPRS 

(MTSMC-G)

 

 
 
 
 
 
 
 
 
 
 
 
 

AT Commands  

and 

Application Examples 

 

Reference Guide 

 
 
 
 
 
 
 
 
 
 
 
 
 

Summary of Contents for ModemModule GPRS

Page 1: ...Wireless GPRS F1 F2 Modems with IP Connectivity MultiModem GPRS MTCBA G ModemModule GPRS MTMMC G SocketModem GPRS MTSMC G AT Commands and Application Examples Reference Guide...

Page 2: ...Asia Africa support multitech co uk 44 118 959 7774 U S Canada all others support multitech com 800 972 2439 or 763 717 5863 Revision History Revision Level Date Description A 03 18 04 Initial releas...

Page 3: ...PPP Client Password 10 APNPW Sets Access Point Name Password 10 APNSERV Sets Access Point Name 11 APNUN Sets Access Point User Name 11 GPRSCID Sets PDP Context Identifier 11 GPRSMODE Activates Switch...

Page 4: ...FTP Path 27 FTPPUTFILENAME Set FTP Upload File Name 27 FTPPUTPATH 27 FTPGET Get Data from Server 28 FTPPUT Put Data to Server 29 VFTP Display FTP Parameters 29 Chapter 5 TCP Socket Services 30 Parame...

Page 5: ...ernet 45 Sending Retrieving Email 46 FTP Download Upload Files 47 TCP Socket 48 Appendix B Detailed Examples 49 Serial Communication 49 Configuring the TCP IP Stack through the Serial Port 53 Configur...

Page 6: ...ervice Provider POP Post Office Protocol PPP Point to Point Protocol PSTN Public Switched Telephone Network SMTP Simple Mail Transfer Protocol Stack Low Level Software TCP Transmission Control Protoco...

Page 7: ...by the network Syntax Set Value AT ANSWERMODE value Get Value AT ANSWERMODE or AT VPHY AT VALL CALLBACKTIMER Set Automatic Call Back Wait Definition This parameter defines the number of seconds the TC...

Page 8: ...ween the Internet and the TCP IP stack software or between the TCP IP stack software and the attached equipment This timer prevents the telephone line from being connected indefinitely for any reason...

Page 9: ...acters No default Syntax Set Value AT ISPPW value Get Value AT ISPPW or AT VPPP AT VALL ISPUN Set ISP User Name Definition This parameter sets the user name of the ISP account When communication is in...

Page 10: ...te accepts this address the IP link is then established This parameter defines the IP address to be attributed to the remote PPP peer when the PPP Server mode is running Values 32 bit number in dotted...

Page 11: ...es Alphanumeric ASCII text string up to 120 characters No default Syntax Set Value AT APNUN value Get Value AT APNUN or AT VGPRS AT VALL GPRSCID Sets PDP Context Identifier Definition GPRSCID is the P...

Page 12: ...PSENDUN Syntax AT ACCEPT Command Possible Responses AT ACCEPT Note Manual acceptance of an incoming call OK Note Beginning of the call setting process CONNECT speed Note Modem speed negotiated between...

Page 13: ...the Internet The AT CONNECTIONSTOP command closes the GSM or GPRS connection by going on hook Values Read Parameters for GSM Mode DIALN1 DIALN2 DIALSELECT ISPPW ISPUN REDIALCOUNT REDIALDELAY If PPPMO...

Page 14: ...DIALCOUNT has been reached AT CONNECTIONSTART CME ERROR 37120 CME ERROR 37121 CME ERROR 28980 CME ERROR 28981 Note only one response at a time The PPP negotiation has failed check ISPUN ISPPW PPPMODE...

Page 15: ...eer parameter values AT DISPLAYIP Note Request for local and remote IP addresses CME ERROR 35867 Note No IP addresses have been attributed no active connection or PPP IPCP negotiation not yet complete...

Page 16: ...VGPRS GPRSCID 1 APNPW access APNSERV a2myoperator com APNUN a2b OK VPHY Display Physical Parameters Definition This command directs the TCP IP stack to display all the AT parameters related to the ph...

Page 17: ...dress must be provided in literal format for instance xxxxxxx web zyx No default Syntax Set Value AT SENDERADDR value Get Value AT SENDERADDR or AT VSMTP AT VALL CCREC1 CCREC2 CCREC3 Set Additional Re...

Page 18: ...dress enter the CRLF pair To end the setting enter the following character 1A in ASCII code generated in a keyboard by CTRL Z escape sequence Note1 This command overwrites all previously set email add...

Page 19: ...Default 110 Syntax Set Value AT POP3PORT value Get Value AT POP3PPORT or AT VPOP3 AT VALL POP3PW Set POP3 Password Definition Password for POP3 account To retrieve email messages sent to a specified e...

Page 20: ...lue AT SMTPPW or AT VSMTP AT VALL SMTPSERV Set SMTP Server Address Definition To send email messages the TCP IP stack software must know the address of the SMTP server that is to be used In most cases...

Page 21: ...aging client on a PC Values Read Parameters POP3HEADERMODE POP3PORT POP3UN POP3PW POP3SERV Syntax AT GETMAIL Command Possible Responses AT GETMAIL Note Retrieve mail OK_Info_Mail mail content Notes Th...

Page 22: ...NDERNAME DOMAIN SMTPPORT SMTPSERV SMTPPW SMTPUN Syntax AT SENDMAILi Command Possible Responses AT SENDMAIL1 Note Send predefined mail 1 OK Note Mail 1 has been successfully sent AT SENDMAIL2 Note Send...

Page 23: ...otes An SMTP session has been successfully opened with the remote SMTP server Once the TCP IP stack has displayed this message all the data received on the serial port is sent within the email body Th...

Page 24: ...predefined nb 1 mail header elements REC1 CCREC1 SUBJ1 OK VPOP3 Display POP3 Parameters Definition Directs the TCP IP stack to display all the AT parameters related to the email retriever configurati...

Page 25: ...IP Connectivity S000333D 25 VDNS Display DNS Parameters Definition Directs the TCP IP stack to display all the AT parameters related to the DNS servers configuration Values Read Parameters DNSSERV1 D...

Page 26: ...t Value AT FTPMODE value Get Value AT FTPMODE or AT VFTP AT VALL FTPTYPE Specify Data Type Definition Before transferring files from a specified FTP server the TCP IP stack software must specify the t...

Page 27: ...FTP Path Definition In order for the TCP IP stack software to get a file from the FTP server the TCP IP stack software must know the path of the relevant file For example it could be list Values Alpha...

Page 28: ...as DLE DLE The attached host must then decode the FTP flow to remove these escape characters Values Read Parameters FTPGETFILENAME FTPGETPATH FTPPORT FTPSERV FTPTYPE FPTMODE FTPPW FTPUN Syntax AT FTP...

Page 29: ...ses AT FTPPUT Note Start sending data OK_WaitingForData Note TCP IP stack is ready to send data from the serial port to the remote FTP server TCP IP stack then immediately transfers all the data sent...

Page 30: ...Internet are sent to the host through the serial port preceded by a DLE character Default id 1 2 Syntax Set Value AT DLEMODE id value Get Value AT DLEMODE id or AT VTCP id AT VALL TCPPORT Set TCP Por...

Page 31: ...DLEMODE parameter is set to 1 the TCP IP stack will interpret an ETX character only as a close request if a DLE character does not precede it As a consequence the attached host must send ETX characte...

Page 32: ...DLE DLE Similarly each ETX character present in the payload data of the TCP frame will be coded by the TCP IP stack on the serial port as DLE ETX Each DLE character will be coded as DLE DLE The attach...

Page 33: ...ion This command directs the TCP IP stack to display all the AT parameters related to the TCP socket configuration Values Read Parameters DLEMODE TCPPORT TCPSERV TCPTXDELAY id 1 2 Syntax AT VTCP id wi...

Page 34: ...e remote must have a defined UDPSERV IP address If the UDP session is initiated in active mode use the remote IP address Note No IP filter is applied if the parameter value is 255 255 255 255 Values 3...

Page 35: ...host is to issue an ETX character Note The TCP IP stack will only interpret an ETX character as a close request if it is not preceded by a DLE character As a consequence an ETX character must be sent...

Page 36: ...ning of UDP socket OK_Info_WaitingForData Notes This message signals that the UDP socket has been opened All data from the attached host remote UDP peer is immediately transferred by the TCP IP stack...

Page 37: ...NGDELAY or AT VPING AT VALL PINGNUM Number of PING Requests Definition This command sets the number of PING echo requests to issue to PINGREMOTE Values From 1 to 255 inclusive Default value is 4 Synta...

Page 38: ...wavecom com wavecom com is alive time 900 ms wavecom com is alive time 800 ms wavecom com is alive time 900 ms wavecom com is alive time 900 ms OK Note TCP IP stack sends PINGNUM 10 requests AT PING C...

Page 39: ...connected AT VSTATE STATE AUTHENTICATING OK Note Connection Not yet PPP negotiated PPP OK message AT VSTATE STATE CONNECTED OK Note Connected to Internet An IP address has been attributed to the TCP I...

Page 40: ...FTPUN mylogin FTPPW mypassword FTPTYPE 1 FTPGETFILENAME FTPGETPATH FTPPUTFILENAME Testseb3 txt FTPPUTPATH POP3HEADERMODE 1 POP3PORT 110 POP3PW POP3SERV POP3UN DOMAIN a2bouygtel com SENDERADDR toto bou...

Page 41: ...This command erases the contents of parameter flash memory Used prior to a hard reset of the modem it results in the default values being written into the parameter memory Note The current parameter v...

Page 42: ...eved on server 3077 OK_Info_PPP PPP connection successful 3086 OK_Info_GPRSActivation GPRS connection successful Error Codes Error Codes Numeric Description 34817 Bad command Unknown command 34819 Bad...

Page 43: ...nswer from DNS servers or the domain name resolution could not be completed by the server 38028 Distant Sender email address rejected by server 38029 Distant Recipient email address rejected by server...

Page 44: ...sion AT VVERSION Note Check the TCP IP stack software version VERSION eDsoft W302_V01 00 67826 Mar 18 2003 18 42 19 AT PPPMODE Set Parameter Value Command Responses AT PPPMODE 1 Note Set a parameter v...

Page 45: ...IALING 0860000000 Note The remote modem answers a call CONNECT 9600 213 30 30 30 Note Dynamic IP address attributed by the network OK_Info_PPP Note The PPP link is established AT CONNECTIONSTOP Note W...

Page 46: ...end sequence OK_Info_WaitingForData Note The software is ready to receive incoming data not echoed At the end of date the CR LF CR LF sequence ends the email This sequence can be sent by a keyboard u...

Page 47: ...command to data mode The host can send the data that will compose the file Data not echoed To notify the end of data the host has to send the ETX character CTRL C on the keyboard This character is ec...

Page 48: ...in the IP address Data Note Data flow is bidirectional Data Note Data flow is bidirectional Note The socket can be closed locally by the attached host sending an ETX character CTRL C on the keyboard...

Page 49: ...d by the software numeric or alpha numeric responses ATV parameter Note Data format is 8 data bits no parity 1 stop bit Output Viewing a parameter After typing AT Mnemonic The modem sends the followin...

Page 50: ...ase of a positive result or if an error occurs 2 It s not possible for host to exit DATA mode Command Mode Data Mode for FTP FTP service FTP through AT FTPPUT ENTRY FLOW Enter in DATA mode The Ok_Info...

Page 51: ...e host This data will be sent to the remote TCP peer Exit DATA mode 1 The host ends the DATA mode by sending the ETX character not preceded by DLE on the serial port 2 The modem ends the DATA mode if...

Page 52: ...e host this message is not preceded by the ETX character Socket TCP service TCP socket through AT LTCPSTART or AT OTCP OUTPUT FLOW Enter in DATA mode The Ok_Info_WaitingForData message sent to the hos...

Page 53: ...thout quotes after the For example AT FTPPORT 21 Note CR is a carriage return ASCII 13 character signaling the end of the command line It is possible to set parameter values while either Offline i e n...

Page 54: ...currently offer the possibility to get this address during PPP negotiation AT DNSSERV1 Secondary DNS The IP address of the secondary backup DNS server must be stored in dotted decimal notation xxx xx...

Page 55: ...arameters Registration on the network AT command The product has to be registered on the GSM network AT CREG 1 GSM mode Deactivate the GPRS mode to switch in the GSM mode AT GPRSMODE 0 ISP Primary Num...

Page 56: ...PP Connection for an outgoing call AT CONNECTIONSTART CONNECT 9600 1 2 3 4 Ok_Info_Ppp CME ERROR 38980 CME ERROR 38981 CME ERROR 37120 CME ERROR 37121 CME ERROR 35865 Remote Response Network Available...

Page 57: ...l PPP server The user must specify these values when creating the PPP client on his computer like for a standard ISP AT PPPSERVUN PPPSERVPW PPP server IP address Once the negotiation is successfully c...

Page 58: ...LLSCREENNUM number if ANSWERMODE is set to 3 by internally issuing an AT CONNECTIONSTART command if the associated CLI Calling Line Identity matches the CALLSCREENNUM parameter AT ANSWERMODE 2 call ba...

Page 59: ...ty S000333D 59 Automatic Call Back to Incoming Calls Continued Process diagram ANSWERMODE 0 N Automatic AT ACCEPT AT CONNECTIONSTART CLIP xxxxxxxx RINGCOUNT Reached Y N ANSWERMODE 1 Y N CALLSCREENNUM...

Page 60: ...r need the caller line identity service from the operator and the AT CLIP 1 command sent to the software RINGCOUNT and ANSWERMODE must be configured in accordance with the ATS0 configuration for not i...

Page 61: ...vity S000333D 61 Automatic Answer of Incoming Calls Continued Process diagram ANSWERMODE 0 N Automatic AT ACCEPT AT CONNECTIONSTART CLIP xxxxxxxx RINGCOUNT Reached Y N ANSWERMODE 1 Y N CALLSCREENNUM a...

Page 62: ...y service from the operator and the AT CLIP 1 command sent to the software Automatic answer deactivation When the ANSWERMODE parameter is set to 0 the modem lets the attached host decide whether the i...

Page 63: ...odems with IP Connectivity S000333D 63 Process diagram ANSWERMODE 0 N Automatic AT ACCEPT AT CONNECTIONSTART CLIP xxxxxxxx RINGCOUNT Reached Y N ANSWERMODE 1 Y N CALLSCREENNUM authorized Y CALLBACKTIM...

Page 64: ...GprsActivation message as a response code to the attached equipment via the serial port The modem will then wait for commands from the attached equipment AT command AT CONNECTIONSTART Related Paramete...

Page 65: ...000333D 65 Connecting to the Internet through GPRS Continued Process diagram GPRS Connection for an outgoing call AT CONNECTIONSTART CME ERROR 35865 Opening GPRS Context Network Available 1 2 3 4 Ok_I...

Page 66: ...witch from command mode to data mode At the end of the data flow the sequence CR LF CR LF notifies the host to switch from data mode to command mode When there is no mail waiting in the POP3 account t...

Page 67: ...OK_Info_Mail CR LF CR LF POP3 server address solved Authentication successfull POP3 server responding Y N Y N Y N Y N N Y N Resolution made on primary DNS server Resolution made on secondary DNS serv...

Page 68: ...host over the serial port is not echoed Note When using this command the software will use the following parameters to compose the email header SUBJ1 for the email subject REC1 for the recipient email...

Page 69: ...tion AT SMTPPW Domain Domain name of the sender AT DOMAIN Sender name The sender s name which appears in the email header in the field From AT SENDERNAME Sender email address Email address of the send...

Page 70: ...ingForData OK SMTP server address solved SMTP login required SMTP server responding Authentication successfull Y N Y N Y N Y N N Y N Resolution made on primary DNS server Resolution made on secondary...

Page 71: ...TIONSTART before sending this command After the sending process the modem will keep the communication established If the RECn SENDERADDR and DOMAIN parameters are empty the response from the modem to...

Page 72: ...dress solved SMTP login required SMTP server responding Authentication successfull Y N Y N Y N Y N N Y N Resolution made on primary DNS server Resolution made on secondary DNS server CME ERROR 38027 Y...

Page 73: ...shed this command instructs the modem to logon to the remote FTP server and then to start the download of the specified file by issuing a standard GET command AT FTPGET Data flow The modem response co...

Page 74: ...oading an FTP File Continued Process diagram AT FTPGET CR Ok_Info_DataBegin FTP server address solved Y N Y N Authentication successfull N Y FTP server responding Y N Resolution made on primary DNS se...

Page 75: ...er and then to start the upload of the specified file by issuing a standard PUT command AT FTPPUT Data flow The modem returns the Ok_Info_WaitingForData message for indicating to the attached host tha...

Page 76: ...Process diagram AT FTPPUT CR Ok_Info_WaitingForData FTP server address solved Y N Y N Authentication successfull N Y FTP server responding Y N Resolution made on primary DNS server Data not echoed ETX...

Page 77: ...ally opens the TCP session and issues an Ok_Info_WaitingForData message over the serial port Data flow Once the TCP socket has been successfully opened all the data received from this session is sent...

Page 78: ...if ETX characters received on the serial port must be interpreted by the modem as a close command When the DLEMODE parameter is set to 0 an open TCP session can only be closed by the remote TCP server...

Reviews: