Multi-Tech Systems iCell GPRS (MTSMC-G2-IP #PUTMAIL Send Mail to Recipient with Interactive Mode

Page 24

Part 1 – AT Commands for All Universal IP Devices

Chapter 2 – SMTP AT Commands

#PUTMAIL – Send Mail to Recipient with Interactive Mode

Description: This command allows the attached host to send an email message containing body text passed to the TCP/IP stack over the serial port. Once an IP link is established, the attached host can send an email message at any time (except when the TCP/IP stack software is already in a process using TCP resources).

The header of this email is built using the REC1, CCREC1 and SUBJ1 parameters.

This command is similar to a “send email” operation issued by a standard messaging client on a PC.

Syntax: AT#PUTMAIL

IMPORTANT NOTE:

You must issue the <CR><LF> bytes (binary value: 0D 0A) as the first data bytes if a header is NOT being constructed in order to finish the internal headers correctly. This mechanism is in place to allow for the addition of custom headers such as MIME data.

Command

Possible Responses

AT#PUTMAIL

Ok_Info_WaitingForData

Note: You have to configure only

Notes: An SMTP session has been successfully opened

receiver address1, copy address1, and

with the remote SMTP server.

subject1 before or during the session,

Once the TCP/IP stack has displayed this message,

but content (body) of the email is typed

all the data received on the serial port is sent within

when the TCP/IP session is

the email body.

established. Content is not echoed.

The (CR)(LF)(.)(CR)(LF) sequence sent by the

 

attached host indicates the TCP/IP stack the end of

 

the email body.

<CR><LF>

 

Note: See Important Note above.

 

<content>

 

Note: Content is not written when

 

typing

 

<CR><LF> . <CR><LF>

OK

Note: Termination sequence

Note: The mail has been successfully sent.

<CR> = <Enter>, <LF> = <Ctrl Enter>

 

AT#PUTMAIL

#CME ERROR: 38027

 

Notes: The address of the SMTP server has not been

 

resolved by the secondary DNS server.

 

TCP/IP stack is not able to reach the primary or

 

secondary DNS servers or a wrong SMTP server

 

address has been entered.

AT#PUTMAIL

#CME ERROR: <value>

 

Notes: An error has occurred during the communication with

 

the remote SMTP server. It may also happen during

 

the data transfer (after the OK message).

 

This error can be due to one of the following

 

reasons:

 

- DNS servers are not able to resolve the SMTP

 

server address.

 

- SMTP server is temporarily out of service.

 

- Authentication (SMTPUN, SMTPPW) is not valid.

 

- An email address specified in REC1 or CCREC1

 

is not valid.

 

- n = inactivity period of 50 seconds on the serial

 

port.

 

See section ‘Response messages and error codes’

To view parameters, use #VMAIL and #VSMTP. They are also listed in #VMAILi (where i = 1, 2, or 3)

Universal IP AT Commands Reference Guide (Document S000457K)

24

Image 24
Contents Universal IP Product Number of This Document S000457K, Version K CopyrightContents Display Command Ping AT Commands for All Universal IP Devices Set Commands #VTELNET View Telnet Settings Incoming Call Management Commands 103 104105 106Part AT Commands for All Universal IP Devices Set Commands AT Command ModeTurn Echo ON/OFF IdentificationDefault Configuration Reset Factory DefaultsRlsd DCD Option Turn On or Off DTR OptionStore Factory Defaults to NVM +ICF DTE-DCE Character Framing+IFC Set Flow Control +IPR Set Serial Speed#DELFLASH Erase Flash Memory Parameter Values Display#LEGACYMODE Legacy Mode Enable/Disable #RESET Reset Main Processor or Internal Modem#SHIELDCHAR Configure the Shielding Character for Dlemode Display Commands #ESCAPECHAR Configure the Escape Character for DlemodeAT#ESCAPECHAR=parameter1 AT#VSHOWSERIAL#VVERSION Display Software Version #VSTATE Display Current State of Physical ConnectionAT#VSHOWUPTIME AT#VSHOWUPTIMES#VALL Display All Parameters Syntax AT#VALL Possible Responses MT100SEM-IPSyntax AT#VALL Possible Responses Applies to All Except MT100SEM-IPSmtp AT Commands for All Universal IP Devices #SENDERNAME Set Sender Name#SENDERADDR Set Sender Address #CCRECi Set Additional Recipient CC#DOMAIN Set Domain Name of the Sender #RECiADD Set Email Address#SUBJi Set Email Pre-Defined Subject Text Syntax AT#DOMAIN=value Syntax AT#SMTPNETWORKTIMER=parameter1 #BODYi Set Pre-Defined Email Combinations #SMTPPORT Set Smtp Server Port Syntax AT#SMTPPORT=value#SMTPPW Set Smtp Password #SMTPSERV Set Smtp Server Address#SMTPUN Set Smtp User Name #SENDMAILi Send Mail without Interactive Mode AT#SENDMAILi#SENDMAIL3 #PUTMAIL Send Mail to Recipient with Interactive Mode Command Possible ResponsesSyntax AT#PUTMAIL #SMTPAUTH Authentication on or OFF #VSMTP Display Smtp Parameters#VMAILi Display Email Parameters for Respective Mail ID OFFPOP3 AT Commands for All Universal IP Devices #POP3PW Set POP3 Password#POP3HEADERMODE POP3 Header #POP3PORT Set POP3 Server PortDisplay Command #POP3UN Set POP3 User Name#GETMAIL Retrieve Host Mail #VPOP3 POP3 Module ParametersFTP AT Commands for All Universal IP Devices #FTPMODE Enter FTP Mode#FTPPORT Enter FTP Server Port #FTPTYPE Specify Data Type#FTPPW Set FTP Password #FTPSERV Specify FTP Server Address#FTPUN Set FTP User Name #FTPGETFILENAME Set FTP Download File Name#FTPGET Download Files from FTP Server #FTPPUT Upload Files to FTP ServerAT#FTPGET AT#FTPPUT#FTPGETPATH Set Path to Get a File from FTP Server #FTPPUTPATH Set Path to Send Files to FTP Server#FTPAPPEND Append Data to Server #VFTP Display FTP Parameters Syntax AT#VFTP Values FtpservTCP AT Commands for All Universal IP Devices #DLEMODE Set DLE ModeDefaults 0,1 #PERSISTENTSOCKET Persistent Socket#TCPTXDELAY Time Delay #TCPPORT Set TCP Port for Remote Peer#TCPSERV Set Address of Remote TCP Server AT#TCPPORT=id,TCP Port number for remote peer value#TCPPACKETMIN TCP Client Transmit Packet Minimum Size #TCPPACKETMAX TCP Client Transmit Packet Maximum SizeAT#TCPPACKETMIN=parameter1, parameter2 Parameter#TCPINACTIVITYTIMER TCP Client Inactivity Timeout Value AT#TCPINACTIVITYTIMER=parameter1, parameter2AT#TCPNETWORKTIMER=parameter1, parameter2 #TCPTELNETMODE Enable/Disable TCP Client Telnet Protocol Line feed character not just any keyAT#TCPTELNETMODE=parameter1, parameter2 AT#TCPTELNETPW=parameter1, parameter2#LTCPSTART Open Listening Mode #TCPTELNETUN Set the TCP Client Telnet Protocol User NameAT#TCPTELNETUN=parameter1, parameter2 Syntax AT#LTCPSTART=id#LTCPSTOP Close TCP Listening Mode #OUTPORT UDP/TCP Local Port Number#OTCP Open a TCP Connection Dlemode Value NotesExample Command Possible Responses Tcptxdelay 2#VTCP Display TCP Parameters AT#VTCP=id or AT#VTCPUDP AT Commands for All Universal IP Devices Defaults Example#UDPPACKETMIN UDP Client Transmit Packet Minimum Size Result Codes#UDPINACTIVITYTIMER UDP Client Inactivity Timeout Value AT#UDPINACTIVITYTIMER=parameter1Command Examples #UDPPACKETMAX UDP Client Transmit Packet Maximum SizeDefault Responses #UDPIGNORESRCPORT Ignore Send Source Port#UDPREMOTEPORT Remote Port Number #UDPPORT UDP Port Number#UDPTXDELAY Delay before Sending UDP Datagram Syntax AT#UDPTXDELAY=ValueDefault Value #UDPSERV UDP Server Address#UDPDLEMODE Set DLE Mode #LUDPSTART Initiate the UDP Session in Listen ModeUdpsesrv Udptxdelay AT#UDPDLEMODE=parameter1#LUDPSTOP Close UDP Listening Mode #OUDP Initiate UDP Session in Active Mode#VUDP Display UDP Module Configuration Syntax AT#VUDPPing AT Commands for All Universal IP Devices #PINGDELAY Ping Delay Time#PINGNUM Number of Ping Requests #PINGREMOTE IP Address of Ping RequestPingnum Pingremote Pingenable Pingdelay #VPING Display Ping ParametersSyntax AT#VPING Values DisplayedPart AT Commands for SocketEthernet IP General AT Commands for SocketEthernet IP #DHCP Dhcp On or Off#IPADDR Set Static IP Address #IPGATEWAY Set Gateway Address#IPNETMASK Set Subnet Mask #DNSSERV1 Set DNS Server IP Address#DNSSERV2 Set Secondary DNS Server #EMACSPD Set Ethernet Connection#HOSTNAME Configure the Dhcp Client Host Name #ETHIFSTATUS View Network Interface Settings#VDNS Display Configuration of DNS Servers Values None Display Example Interface UP#VIP View Address Settings Syntax AT#VIP Values NoneAuto Discovery AT Commands for the SocketEthernet IP #AUTODISCTIMER Auto Discovery Timer#AUTODISC Auto Discovery On/Off #AUTODISCPORT Auto Discovery Port#AUTODISCPASSWORD Sets Auto Discover Password #VAUTODISC Display Auto Discovery Commands#AUTODISCUSERNAME Set Auto Discover User Name Part AT Commands for SocketWireless Wi-Fi Devices IP AT Commands for SocketWireless Wi-Fi #IPDNSSERV Configure the DNS Server Disables DNSEnable DNS AT#IPDNSSERV#IPRELEASE Release a Dhcp Address Assigned by the Server #IPRENEW Renew the Dhcp Information from the Server#IPQUERY Give a Domain Name #IPRESOLV Is There a Connection with DNS or Not#IPDNSTABLE Display DNS Table AT#IPDNSTABLEResponse Values Syntax AT#VDNSGeneral AT Commands for SocketWireless Wi-Fi Previous CommandManual Answer of TCP or UDP Connection S2 Escape Sequence#BOOTMSG Enable/Disable Boot Message #WATCHDOG Enable/Disable Watchdog#WATCHDOGTIMER Watchdog Timer AT#BOOTMSG=0,1Values Default #TELNET Start/Stop Telnet Session#TELNETPORT- Set Telnet Port #TELNETUSER Set Telnet User#TELNETPASSWORD Set Telnet Password #VTELNET View Telnet SettingsAT# Telnetpassword = 64 char string AT#TELNETPASSWORD?Wlan AT Commands for SocketWireless Wi-Fi #WLANSECURITYMODE Security Mode of Wlan Module#WLANNETWORKMODE Wlan Network Mode #WLANCOUNTRYCODE Country Code#WLANSCANMODE Scanning Mode #WLANIBSSCHANNEL Channel for Ad-Hoc Mode#WLANSSID Ssid of Wlan #WLANDATARATE Wlan Transmission Data Rate#WLANENABLE Auto Connect Module with AP #WLANDOZE= Moves Module into or out of Power Save#WLANCONNECT Connect with AP #WLANDISCONNECT Disconnect with AP#WLANSCAN Scan Wireless Networks #WLANPROFILEn=n Change the Wlan ProfileKeyindex = Syntax AT#WLANSCAN#WLANGETRSSI Received Signal Strength #WLANACTIVATE Move Module out of Power Save#WLANROAM Enable/Disable Roaming #WEP64KEY Keys for WEP64 Security Mode#WEP128KEY Keys for WEP128 Security Mode #WPAPSKKEY Keys for WPA PSK Security Mode#WPA2PSKKEY Keys for WPA2 PSK Security Mode #WEPKEYID Set the Default TX Key Index#WEP? See the Value of the WEP Keys #WLANPROFILE Display the Wlan ProfileAT#WEP? AT#WLANSETPROFILEvalue?#WLAN? Wlan Module #WLANASSOCINFO Display Association InformationAT#WLAN? AT#WLANASSOCINFOAT Commands for the Following Devices AT Commands for +WOPEN Set IP Mode or Modem Mode#AUTHENT Authentication Type #ANSWERMODE Set Answering Mode #SMSPHRASE Set Incoming SMS PhraseAT#ANSWERMODE=value AT#SMSPHRASE=parameter1#CALLBACKTIMER Set Automatic Call-Back Wait #CALLSCREENNUM Set Caller ID Service#KEEPALIVEMODE Keep-Alive Mode Default Example#KEEPALIVEDELAY Keep-Alive Delay #KEEPALIVEPORT Keep-Alive Port Number#KEEPALIVESERV Keep-Alive Server Address #ATCMD Customize Dial-Up Commands #REDIALDELAY Set Call Retry Delay#PHYTIMEOUT Set Inactivity Time #REDIALCOUNT Set Connection Attempts Allowed#RINGCOUNT Set Number of Rings/Automatic Operation #DIALN1 Set Primary Dial-Up Number#DIALN2 Set Secondary Dial-Up Number #ISPPW Set ISP Password #DIALSELECT Set Internet Connection Number#ISPUN Set ISP User Name Incoming Call Management Commands #ACCEPT Answer Incoming Call#CONNECTIONSTOP Stop Communication AT#ACCEPT#CONNECTIONSTART Start Communication AT#CONNECTIONSTART#PPPMYIP Set IP Address When Using PPP #AUTOCONNECT Automatically Connect the PPP Link#PPPMODE Set TCP/IP Behavior #PPPPEERIP Set IP Address for Remote PPP#PPPSERVPW Set Remote PPP Client Password #APNPW Set Access Point Name Password#APNSERV Set Access Point Name #APNUN Set Access Point User Name#GPRSMODE Activate Switching Between GSM and Gprs #GPRSCID Set PDP Context Identifier#DISPLAYIP Display IP Addresses #VPPP Display PPP Parameters #VPHY Display Physical ParametersAT#VPPP AT#VPHYPart Gpio AT Commands Gpio AT CommandsGpio AT Commands About GpioValues Gpio Function Trigger LevelAT#GPIOR=parameter Gpio Port\r\n#GPIOR VALUE1,VALUE2\r\n Send AT#GPIOR=1\r#GPIOTRIGGER Configure the Gpio pin and trigger type Description Configure the Gpio pin and trigger typeSyntax AT#GPIOTRIGGER=parameter1,parameter2 Part AT Commands for GPS-Enabled Device Commands for GPS-Enabled DeviceAT Commands for GPS Enable Products #GPSSERV Set GPS Host Server Address#GPSPORT Set GPS Host Port #GPSPROTO Set GPS Host Protocol#GPSPW Set GPS Host Login Password #GPSGPGGA Enable/Disable Gpgga Message#GPSURAIS Set GPS Unique Remote Asset Identification String #GPSINTERVAL Set GPS Server Transmission Interval#GPSGPGLL Enable/Disable Gpgll Message #GPSGPGSA Enable/Disable Gpgsa Message#GPSGPGSV Enable/Disable Gpgsv Message #GPSGPRMC Enable/Disable Gprmc Message#GPSGPVTG Enable/Disable Gpvtg Message #GPSINTERVALLOC GPS Local Transmission Interval#GPSGETMESSAGE Get Queued GPS Message GPS Message Syntax GPS Message ExamplesGpsprefixgpsuraisnmeamessagecrlf WhereGPS Configuration Examples Application Note GPS Nmea Messages Introduction Nmea Protocol OverviewGGA Global Positioning System Fix Data StructureExample GLL Latitude/Longitude GSA Gnss DOP and Active SatellitesGSV Gnss Satellites in View $GPGSVSNR RMC Recommended Minimum Specific Gnss Data VTG Course Over Ground and Ground Speed$GPRMC $GPVTGPart Appendixes Appendix a Response Messages Error Codes Response MessagesStandard AT Messages Numeric Verbose Description RingError Codes Error CodesNumeric Description Sending an Email AT#PUTMAIL Commands Responses Appendix B Response Message ExamplesResponse Messages Examples Sending/Retrieving Email Response MessagesRetrieving an Email AT#GETMAIL Commands Responses AT#POP3PORT=110 AT#GETMAILUpload a file to an FTP Server AT#FTPPUT Commands Responses FTP Download / Upload Files Response MessagesAT#FTPPUTPATH= AT#FTPPUTAct as a TCP Server AT#LTCPSTART Commands Responses Act as a TCP Client AT#OTCP Commands ResponsesTCP Socket Response Messages Index #FTPAPPEND Append Data to Server#UDPTXDELAY Delay before Sending UDP Datagram Close TCP Listening Mode #LTCPSTOP #LTCPSTART Open Listening Mode #PINGNUM Number of Ping Requests Commands for SocketModem IP Commands for SocketWireless Wi-Fi #PERSISTENTSOCKET Delay before Sending UDP Initiate the UDP Session in Listen Mode 119