Email (SMTP/POP3) Application Note
Email (SMTP/POP3) Application Note
Email (SMTP/POP3) Application Note
Application Note
Email(SMTP/POP3) Application Note
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.
SIM7100_Email_Application_Note_V0.01 1 2015-02-10
Email(SMTP/POP3) Application Note
Version History
Version Chapter Comments
V0.01 New Version
SIM7100_Email_Application_Note_V0.01 2 2015-02-10
Email(SMTP/POP3) Application Note
Contents
V e r s i o n H i s t o r y .................................................................................................................................. 2
C o n t e n t s ................................................................................................................................................... 3
Email(SMTP/POP3) Application Note ........................................................................................................ 4
1. Overview ................................................................................................................................................ 4
2. Call Commands ..................................................................................................................................... 6
3. SMTP Application ................................................................................................................................. 8
3.1 Parameter Configuration ..................................................................................................................... 8
3.2 Write/Send Email ................................................................................................................................. 8
3.3 Abort Email Application ...................................................................................................................... 9
4. POP3 Application .................................................................................................................................. 9
4.1 Parameter Configuration ..................................................................................................................... 9
4.2 Inquire New Email ............................................................................................................................... 9
4.3 Peek At New Email ............................................................................................................................. 10
4.4 Retrieve Email Without Delete ...........................................................................................................11
4.5 Retrieve Email With Delete ............................................................................................................... 12
4.6 Abort POP3 Application .................................................................................................................... 13
4.7 Read Email In File System................................................................................................................. 14
5. Conflict AT Commands....................................................................................................................... 15
Contact Us .................................................................................................................................................... 16
SIM7100_Email_Application_Note_V0.01 3 2015-02-10
Email(SMTP/POP3) Application Note
1. Overview
Simple Mail Transfer Protocol (SMTP) is an internet standard for electronic mail (e-mail) transmission
across Internet Protocol (IP) networks, and it is a text-based protocol.
To sending an e-mail successfully, TE must set some mandatory parameters for SMTP client correctly,
such as SMTP server address, sender and recipient address. After the process of sending an e-mail is started,
SMTP Client will initiates a Transmission Control Protocol (TCP) session with the SMTP server to send
e-mail.
SMTP features:
Support SMTP authentication basing on SMTP server.
Multi-recipient: TO, CC and BCC.
ASCII test as e-mail subject, up to 512 characters.
ASCII test as e-mail body, up to 5120 characters.
E-mail attachments from File System: total size up to 10MB or maximal number up to 10 files.
Stop SMTP application and close TCP session directly.
SIM7100_Email_Application_Note_V0.01 4 2015-02-10
Email(SMTP/POP3) Application Note
Post Office Protocol – Version 3 (POP3) is an application-layer internet standard protocol used by
local e-mail client (POP3 client) to retrieve and delete e-mail from a remote POP3 server over a TCP/IP
connection.
POP3 features:
POP3 server authentication.
Number and total size of new e-mails.
Get e-mail ID size of each e-mail.
Peek at e-mail’s header.
Get and delete e-mail from POP3 server.
Save e-mail and attachment basing on File System (Local storage or storage card).
Read the latest e-mail directly, or read e-mail from File System.
Stop POP3 application and close TCP session directly.
SIM7100_Email_Application_Note_V0.01 5 2015-02-10
Email(SMTP/POP3) Application Note
2. Call Commands
This section only lists e-mail(SMTP/POP3) related commands. Please refer to AT command document
to get detailed descriptions.
AT+SMTPSRV
Configure SMTP server, including server address and its port number.
E.g. AT+SMTPSRV="smtp.server.com",25
AT+SMTPAUTH
Configure if SMTP client provides user name and password SMTP server when access SMTP server.
If SMTP server requests authentication but SMTP client does not provide, Email will be sent with a
failed result.
E.g. AT+SMTPAUTH=0 >> No authentication reques.t
AT+SMTPAUTH=1,"un","pwd" >> SMTP server requests authentication.
AT+SMTPFROM
Configure sender’s mail address and present name, they are used to construct email header.
E.g. AT+SMTPFROM="[email protected]","mike"
AT+SMTPFROM="[email protected]" >> Only configure mail address.
AT+SMTPRCPT
Configure recipients’ mail address and name for each email.
E.g. AT+SMTPRCPT=0,0,"[email protected]","toname" >> First normal recipient
AT+SMTPRCPT=0,1,"[email protected]" >> Second normal recipient without name
AT+SMTPRCPT=0,0 >> Clear the first normal recipient
AT+SMTPRCPT=0 >> Clear all normail recipient
AT+SMTPRCPT=1,0,"[email protected]","ccname" >> First CC recipient
AT+SMTPRCPT=2,0,”[email protected]","bccname" >> Frist BCC recipient
AT+SMTPSUB
Write the subject for each mail.
E.g. AT+SMTPSUB="First email"
AT+SMTPBODY
Write the content for each mail.
E.g. AT+SMTPBODY="This is the first email!"
AT+SMTPFILE
Select files from current directory in file system (local space or storage card) as email’s attachments.
E.g. AT+SMTPFILE=1,"file1" >> Select "file1" as the first attachment
AT+SMTPFILE=2,"file2" >> Select "file2" as the second attachment
AT+SMTPFILE=1 >> Delete the first attachment
AT+SMTPFILE >> Delete all attachments (no attachment)
SIM7100_Email_Application_Note_V0.01 6 2015-02-10
Email(SMTP/POP3) Application Note
AT+SMTPSEND
Establish TCP session between SMTP client and server, construct and send email. URC "+SMTP:
SUCCESS" indicates a successful result. Command +SMTPSEND? can be used to inquire if SMTP client
is in idle state.
AT+SMTPSTOP
Force to stop the TCP session and then SMTP client is in idle state.
AT+POP3SRV
Configure POP3 server and access account.
E.g. AT+POP3SRV="pop3.server.com","un","pwd",110
AT+POP3IN
Establish TCP session and access POP3 server.
AT+POP3NUM
Inquire the number of unread emails and the total size of these unread emails.
AT+POP3LIST
List each email’s ID(from 1 to unread emails’ number) and size, or list specified email’s ID and size.
AT+POP3HDR
Get specified email’s header from POP3 server.
AT+POP3GET
Get specified email and save email’s attachments into directory "C:/Email" or “D:/Email” (depending
on the value of command +FSLOCA)
AT+POP3DEL
Mark the email and after POP3 client finishs the session normally, POP3 server will delete the
specified email.
AT+POP3OUT
Finish the session normally.
AT+POP3STOP
Force to finish the session.
AT+POP3READ
Return last or specified email’s header and content.
SIM7100_Email_Application_Note_V0.01 7 2015-02-10
Email(SMTP/POP3) Application Note
3. SMTP Application
3.1 Parameter Configuration
Host must configure mandatory parameters for SMTP client before SMTP application. The mandatory
parameters include <socket PDP context>, <server address>, <server port>, <authentication or not>,
<sender address> and <sender name>.
NOTE Only configure mandatory parameters once correctly, until reboot.
AT+CGSOCKCONT=1,"IP","3GNET","0.0.0.0",0,0
OK
AT+SMTPSRV="smtp.server.com",25
OK
AT+SMTPAUTH=1,"UserName","password"
OK
AT+SMTPFROM="[email protected]","PresentName"
OK
AT+SMTPRCPT=0,0,"[email protected]","ToName"
OK
AT+SMTPRCPT=1,0,"[email protected]","CcName"
OK
AT+SMTPSUB="First Email"
OK
AT+SMTPBODY="This is the first Email!"
OK
AT+FSCD=C:/Picture
+FSCD: C:/Picture/
OK
AT+FSLS
+FSLS: FILES:
20100202_100006.jpg
20100202_100016.jpg
OK
SIM7100_Email_Application_Note_V0.01 8 2015-02-10
Email(SMTP/POP3) Application Note
AT+SMTPFILE=1,"20100202_100006.jpg"
OK
AT+SMTPFILE=2,"20100202_100016.jpg"
OK
AT+SMTPSEND
+SMTP: OK
OK
+SMTP: SUCCESS
OK
AT+SMTPSTOP
OK
4. POP3 Application
4.1 Parameter Configuration
Host must configure mandatory parameters for POP3 client before POP3 application. The mandatory
parameters include <socket PDP context>, <server address>, <server port>, <access user name>, <access
password> and <email location>.
NOTE Only configure mandatory parameters once correctly, until reboot.
AT+CGSOCKCONT=1,"IP","3GNET","0.0.0.0",0,0
OK
AT+POP3SRV="pop3.server.com","un","pwd",110
OK
SIM7100_Email_Application_Note_V0.01 9 2015-02-10
Email(SMTP/POP3) Application Note
AT+POP3IN
+POP3: SUCCESS
OK
AT+POP3NUM
+POP3: 0, 0
OK
AT+POP3OUT
+POP3: SUCCESS
OK
AT+POP3IN
+POP3: SUCCESS
OK
AT+POP3NUM
+POP3: 2 2134
OK
AT+POP3LIST=1
+POP3: 1, 1050
OK
AT+POP3HDR=1
From: "FromName" <[email protected]>
Date: Tue, 9 Mar 2010 17:11:30 +0800
Subject: First Test Email
OK
AT+POP3LIST=2
+POP3: 2, 1084
OK
SIM7100_Email_Application_Note_V0.01 10 2015-02-10
Email(SMTP/POP3) Application Note
AT+POP3HDR=2
From: "FromName" <[email protected]>
Date: Tue, 9 Mar 2010 17:16:27 +0800
Subject: Second Test Email
OK
AT+POP3OUT
+POP3: SUCCESS
OK
AT+POP3IN
+POP3: SUCCESS
OK
AT+POP3NUM
+POP3: 2 2134
OK
AT+POP3LIST=1
+POP3: 1, 1050
OK
AT+POP3HDR=1
From: "FromName" <[email protected]>
Date: Tue, 9 Mar 2010 17:11:30 +0800
Subject: First Test Email
OK
AT+POP3LIST=2
+POP3: 2, 1084
OK
AT+POP3HDR=2
From: "FromName" <[email protected]>
Date: Tue, 9 Mar 2010 17:16:27 +0800
Subject: Second Test Email
OK
SIM7100_Email_Application_Note_V0.01 11 2015-02-10
Email(SMTP/POP3) Application Note
AT+FSLOCA=0
OK
AT+POP3GET=1
OK
+POP3: SUCCESS
C:/Email/100202110457/, EMAIL000.TXT
AT+POP3READ
Date: Tue, 9 Mar 2010 17:11:30 +0800
From: "FromName" <[email protected]>
To: "ToName" <[email protected]>
Subject: First Test Email
OK
AT+POP3OUT
+POP3: SUCCESS
OK
AT+POP3IN
+POP3: SUCCESS
OK
AT+POP3NUM
+POP3: 2 2134
OK
AT+POP3LIST=1
+POP3: 1, 1050
OK
AT+POP3HDR=1
From: "FromName" <[email protected]>
Date: Tue, 9 Mar 2010 17:11:30 +0800
Subject: First Test Email
OK
SIM7100_Email_Application_Note_V0.01 12 2015-02-10
Email(SMTP/POP3) Application Note
AT+POP3LIST=2
+POP3: 2, 1084
OK
AT+POP3HDR=2
From: "FromName" <[email protected]>
Date: Tue, 9 Mar 2010 17:16:27 +0800
Subject: Second Test Email
OK
AT+FSLOCA=0
OK
AT+POP3GET=1
OK
+POP3: SUCCESS
C:/Email/100202113456/, EMAIL000.TXT
AT+POP3READ
Date: Tue, 9 Mar 2010 17:11:30 +0800
From: "FromName" <[email protected]>
To: "ToName" <[email protected]>
Subject: First Test Email
OK
AT+POP3DEL=1
+POP3: SUCCESS
OK
AT+POP3OUT
+POP3: SUCCESS
OK
AT+POP3IN
+POP3: SUCCESS
OK
SIM7100_Email_Application_Note_V0.01 13 2015-02-10
Email(SMTP/POP3) Application Note
AT+POP3NUM
+POP3: 2 2134
OK
AT+POP3LIST=1
+POP3: 1, 1050
OK
AT+POP3HDR=1
From: "FromName" <[email protected]>
Date: Tue, 9 Mar 2010 17:11:30 +0800
Subject: First Test Email
OK
AT+POP3LIST=2
+POP3: 2, 1084
OK
AT+POP3HDR=2
From: "FromName" <[email protected]>
Date: Tue, 9 Mar 2010 17:16:27 +0800
Subject: Second Test Email
OK
AT+FSLOCA=0
OK
AT+POP3GET=1
OK
AT+POP3STOP
OK
AT+FSCD=C:/Email
+FSCD: C:/Email/
OK
AT+FSLS
+FSLS: SUBDIRECTORIES:
100202110457
SIM7100_Email_Application_Note_V0.01 14 2015-02-10
Email(SMTP/POP3) Application Note
100202113456
OK
AT+POP3READ=0,"100202110457/EMAIL000.TXT"
Date: Tue, 9 Mar 2010 17:11:30 +0800
From: "FromName" <[email protected]>
To: "FromName" <[email protected]>
Subject: First Test Email
OK
5. Conflict AT Commands
Following AT commands cannot be used with SMTP/POP3 AT commands together:
TCP/IP AT commands
MMS AT commands
GPS AT commands
SIM7100_Email_Application_Note_V0.01 15 2015-02-10
Email(SMTP/POP3) Application Note
Contact Us
Shanghai SIMCom Wireless Solutions Ltd.
Add: Building A, SIM Technology Building, No.633, Jinzhong Road, Changning District
200335
Tel: +86 21 3252 3300
Fax: +86 21 3252 3301
URL: http:/www.sim.com/wm/
SIM7100_Email_Application_Note_V0.01 16 2015-02-10