RL-ARM User's Guide

SMTP Client

Simple Mail Transfer Protocol (SMTP) is a widely used protocol for the delivery of e-mails between TCP/IP systems and users. All steps in the e-mail system use SMTP with the exception of the final retrieval step by an e-mail recipient.

An Embedded SMTP Client can send e-mails to various recipients. A typical use is to send automated e-mail notifications to different e-mail addresses.

E-mail content can be a static predefined e-mail message or a real dynamic message. An example of a real dynamic email is one that contains the measurement results from a log file or an email with current measurement values.

SMTP Client interface functions are in the user interface module SMTP_uif.c, which is in the \Keil\ARM\RL\TCPnet\User folder. You must copy it to your project directory and add it to your project. Customize this module by changing the From address, the To address, and the body of the email message.

The following functions are in the module:

• smtp_cbfunc() - callback function to compose the e-mail.
• smtp_accept_auth() - callback function to accept/deny the authentication advertised by SMTP Server.

The following system functions are in the RL-TCPnet library:

• smtp_connect() - connect to SMTP Server and send an e-mail.

• In order to use an Embedded SMTP Client, you must enable and configure it in the configuration file.