smtp_connect

#include <rtl.h>

BOOL smtp_connect (
    U8*   ipadr,                   /* IP address of the SMTP server. */
    U16   port,                    /* Port number of SMTP server. */
    void (*cbfunc)(U8 event) );    /* Function to call when the SMTP session ends. */

The smtp_connect function starts the SMTP client on the TCPnet system. This causes the SMTP client to then start an SMTP session by connecting to an SMTP server on the TCP port specified in the function argument.

The argument ipadr points to an array of 4 bytes containing the dotted-decimal notation of the IP address of the SMTP server to connect to.

The argument cbfunc points to a function that the SMTP client running on TCPnet calls when the SMTP session ends. The cbfunc is an event callback function that uses the event argument of the cbfunc function to signal one of the following SMTP events:

The smtp_connect function is in the RL-TCPnet library. The prototype is defined in rtl.h.

note

• The standard SMTP port is TCP port 25.
• Your application, running on TCPnet, can call the smtp_connect function to connect to an SMTP server to send emails.

The smtp_connect function returns __TRUE if the SMTP client has been successfully started. Otherwise it returns __FALSE.

• __TRUE = client started successfully
• __FALSE = failure

smtp_cbfunc

static void smtp_cback (U8 event);

void send_email (void) {
  U8 smtpip[4] = {192,168,2,253};

  if (smtp_connect (smtpip, 25, smtp_cback) == 0) {
    printf("E-mail not sent, SMTP Client not ready.\n");
  }
  else {
    printf("SMTP Client started.\n");
  }
}

static void smtp_cback (U8 event) {
  switch (event) {
    case SMTP_EVT_SUCCESS:
      printf ("Email successfully sent\n");
      break;
    case SMTP_EVT_TIMEOUT:
      /* Timeout, try again. */
      printf ("Mail Server timeout.\n");
      break;
    case SMTP_EVT_ERROR:
      /* Error, try again. */
      printf ("Error sending email.\n");
      break;
  }
}