Vado ad introdurre la versione 2 della mia libreria EMailSender, una grande evoluzione rispetto alla versione 1, con supporto per Arduino con dispositivi ethernet w5100, w5200 e w5500 e dispositivi clone enc28J60, supporto per esp32 ed esp8266 ed infine (dalla versione 2.2.0 Arduino UNO WiFi Rev.2, Arduino NANO 33 IoT, Arduino MKR 1010 and Arduino MKR VIDOR 4000 WiFi ecc.).puoi anche aggiungere allegati , caricati da un dispositivo di archiviazione come SD o SPIFFS.
Puoi fare riferimento alla versione 1 in questo articolo Invi a email con esp8266 e Arduino
Un metodo semplice per notificare un problema è utilizzare la posta elettronica, quindi ho creato una libreria per farlo.
Send email with attachments Arduino library
Questa libreria utilizza il protocollo SMTP:
Simple Mail Transfer Protocol ( SMTP ) è un protocollo standard per la trasmissione di email. Inizialmente proposto nella RFC 778 nel 1981, poi aggiornato con RFC 821 nel 1982 ed ulteriormente modificato nel 2008 con l’introduzione di extended SMTP ( RFC 1869 e RFC 5321 ), che è il protocollo attualmente in uso. server di posta elettronica utilizzano SMTP per inviare e ricevere mail, i client mail a livello utente utilizzano SMTP solo per inviare il messaggio al server mail, il quale si occupa dell’invio del messaggio stesso. Per recuperare i messaggi, le applicazioni client usano solitamente protocolli come IMAP o POP3 . TCP sulla porta 25. I client mail , tuttavia, spesso inviano le mail in uscita al server sulla porta 587. Anche se deprecata, i provider mail e alcuni produttori come Apple, permettono ancora l’uso della porta non standard 465 per questa operazione. (Cit. Wiki)
Puoi trovare la mia libreria qui , oppure basta che cerchi EMailSender sul gestore delle librerie dell’Arduino IDE.
Per scaricare.
Clicca il bottone DOWNLOADS sull’angolo in alto a destra, e rinomina la cartella decompressa EMailSender.
Controlla che la cartella EMailSender contenga EMailSender.cpp e EMailSender.h.
Posizione la libreria EMailSender nella tua cartella /libraries/.
Potresti dover creare la sottocartella libraries se è la tua prima libreria.
Riavvia l’IDE.
Costruttore: il valore predefinito è abbastanza semplice e usa GMail come server smtp.
1
EMailSender emailSend("smtp.account@gmail.com", "password");
Se si desidera utilizzare un altro fornitore, è possibile utilizzare un costruttore più complesso (ma comunque semplice)
1
2
3
4
5
EMailSender(const char* email_login, const char* email_password, const char* email_from, const char* name_from, const char* smtp_server, uint16_t smtp_port );
EMailSender(const char* email_login, const char* email_password, const char* email_from, const char* smtp_server, uint16_t smtp_port);
EMailSender(const char* email_login, const char* email_password, const char* email_from, const char* name_from );
EMailSender(const char* email_login, const char* email_password, const char* email_from);
EMailSender(const char* email_login, const char* email_password);
email_login: login account smtpemail_password: password account smtpemail_from: email del mittentename_from: nome utente del mittentesmtp_server: server SMTPsmtp_port: porta SMTP
Questi parametri sono modificabili anche in realtime con questi metodi:
1
2
3
4
5
6
void setSMTPPort(uint16_t smtp_port);
void setSMTPServer(const char* smtp_server);
void setEMailLogin(const char* email_login);
void setEMailFrom(const char* email_from);
void setNameFrom(const char* name_from);
void setEMailPassword(const char* email_password);
Ora rispetto alla libreria v1.x puoi notare che il flag isSecure non esiste più
isSecure = false:false BearSSL permette una connessione insicura TLS
ma puoi continuare a gestirlo con
1
void setIsSecure(bool isSecure = false);
Altri parametri che è possibile impostare post costruttore sono
1
2
void setUseAuth(bool useAuth = true);
void setPublicIpDescriptor(const char *publicIpDescriptor = "mischianti");
Il primo permette di escludere l’handshake di autenticazione, il secondo modifica l’identificazione del messaggio HELO.
Aggiornamento: 02/01/2021 (v2.1.5)
Altre due configurazioni aggiuntive sono
1
2
void setEHLOCommand(bool useEHLO = false)
void setSASLLogin(bool isSASLLogin = false)
Il primo comando modifica HELO in EHLO, è necessario per i server SMTP Postfix.
Il secondo attiva la login SASL, quindi il login e la password vengono inviati tutti in una unica riga.
È necessario connettersi a ad internet :P.
Devi fare riferimento alla Parte 2 per configurare il tuo account GMail e controllare tutti i parametri.
Crea un messaggio con la struttura EMailMessage
1
2
3
EMailSender::EMailMessage message;
message.subject = "Subject";
message.message = "Hi, How are you<br>Fine.";
Invia messaggio:
1
EMailSender::Response resp = emailSend.send("account_to_send@gmail.com", message);
Quindi controlla la risposta:
1
2
3
4
Serial.println("Sending status: ");
Serial.println(resp.code);
Serial.println(resp.desc);
Serial.println(resp.status);
Esempio di output:
1
2
3
4
5
6
Connection: ESTABLISHED
Got IP address: 192.168.1.104
Sending status:
1
0
Message sent!
Puoi inviare a un elenco di email e selezionare un CC o CCn, ad esempio invia a 3 email
1
2
const char* arrayOfEmail[] = {"<FIRST>@gmail.com", "<SECOND>@yahoo.com", "<THIRD>@hotmail.com"};
EMailSender::Response resp = emailSend.send(arrayOfEmail, 3, message);
oppure a 3 email, la prima come A e le ultime come CC
1
2
const char* arrayOfEmail[] = {"<FIRST>@gmail.com", "<SECOND>@yahoo.com", "<THIRD>@hotmail.com"};
EMailSender::Response resp = emailSend.send(arrayOfEmail, 1, 2, message);
o il primo come A, il secondo come CC e il terzo come CCn
1
2
const char* arrayOfEmail[] = {"<FIRST>@gmail.com", "<SECOND>@yahoo.com", "<THIRD>@hotmail.com"};
EMailSender::Response resp = emailSend.send(arrayOfEmail, 1,1,1, message);
Arduino, normalmente, gestisce la rete con un dispositivo esterno, uno dei dispositivi “standard” come w5100 utilizza la libreria Ethernet i cloni ENC28J60 ha varie librerie da selezionare.
Per selezionare il tuo dispositivo devi andare sul file EMailSenderKey.h nella libreria e impostare quello corretto
1
#define DEFAULT_EMAIL_NETWORK_TYPE_ARDUINO NETWORK_ENC28J60 // Default
La libreria caricata per gestire questo tipo di dispositivo è UIPEthernet, è possibile trovare la libreria sul gestore librerie dell’IDE Arduino
o puoi selezionare
1
#define DEFAULT_EMAIL_NETWORK_TYPE_ARDUINO NETWORK_W5100
Questa è l’implementazione standard e usa la libreria Ethernet.
Una cosa importante da considerare è che gli shield Ethernet non supporta SSL o TLS, quindi è necessario trovare un provider SMTP che offre una connessione SMTP senza questo tipo di codifica.
Creo un argomento sul forum in cui sarà possibile aggiungere il provider che si utilizza, e sarà possibile trovare anche quelli che utilizzo io.
SMTP server da usare con la libreria EMailSender
Come ho già detto, utilizzo un ENC28J60 con Arduino Mega 2560, qui lo schema di connessione:
Arduino Mega And Enc28j60 Ethernet connection schema
Ecco qui un semplice esempio di invio email con il provider SendGrid.
“apikey” indica che stiamo per inviare un codice relativo a un modulo API.
“your_password_apikey” è la password fornita da Sendgrid quando si richiede una chiave SMTP Relay.
“your_mail” è l’indirizzo di accesso di Sendgrid.
Devi usare 587 come porta.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
#include "Arduino.h"
#include <SPI.h>
#include <UIPEthernet.h>
#include <EMailSender.h>
byte mac[] = { 0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED };
EMailSender emailSend("<YOUR-SENDGRID-API-KEY>", "<YOUR-SENDGRID-PASSWD>", "<FROM-EMAIL>", "smtp.sendgrid.net", 25);
void setup()
{
Serial.begin(115200);
delay(2000);
Serial.println("Starting!");
if (Ethernet.begin(mac) == 0) {
Serial.println("Failed to configure Ethernet using DHCP");
while(1);
}
Serial.print("IP address ");
Serial.println(Ethernet.localIP());
EMailSender::EMailMessage message;
message.subject = "Soggetto";
message.message = "Ciao come stai<br>io bene.<br>www.mischianti.org";
EMailSender::Response resp = emailSend.send("email_to_receive@gmail.com", message);
Serial.println("Sending status: ");
Serial.println(resp.status);
Serial.println(resp.code);
Serial.println(resp.desc);
}
void loop()
{
}
Send email with attachments Arduino esp8266 esp32 test with image and txt
Aggiungerò questo esempio solo per spiegare come fare, non ho trovato un provider SMTP senza SSL e TLS che supportano gli allegati, perciò andrà testato sul campo.
Naturalmente hai bisogno di un dispositivo di archiviazione in cui inserire i dati da allegare, io uso un normale adattatore SD collegato al pin CS 4.
Puoi trovare tutte le informazioni sul collegamento di una scheda SD su quest’articolo “Come usare la scheda SD con esp8266 e Arduino “.
Arduino Mega Enc28j60 SD connection schema EMailSender
Il core del codice è la generazione della struttura per trasmettere le informazioni relative agli allegati.
1
2
3
4
5
6
7
8
9
10
EMailSender::FileDescriptior fileDescriptor[1];
fileDescriptor[0].filename = F("test.txt");
fileDescriptor[0].url = F("/test.txt");
fileDescriptor[0].mime = MIME_TEXT_PLAIN;
fileDescriptor[0].encode64 = false;
fileDescriptor[0].storageType = EMailSender::EMAIL_STORAGE_TYPE_SD;
EMailSender::Attachments attachs = {1, fileDescriptor};
EMailSender::Response resp = emailSend.send("email_to_receive@gmail.com", message, attachs);
Il campi del EMailSender::FileDescriptiorsono abbastanza comprensibili, ma presta attenzione a encode64che specifica se vuoi codificare tutto il contenuto, questo è utile se ci sono alcuni caratteri speciali non supportati.
Ma attenzione, la codifica di file di grandi dimensioni richiede un po’ di tempo.
Il fiel mime specifica il tipo mime del file che si desidera allegare. Ecco alcuni esempi di tipi MIME esistenti.
Poi devi specificare lo storageType, in genere supportiamo solo SD e SPIFFS, ma per Arduino solo SD.
Il filenamee url sono rispettivamente il nome del file è il nome che apparirà al destinatario, l’URL è dove si trova il file nell’FS selezionato.
Poi in EMailSender::Attachmentssarà necessario specificare il numero di allegati e impostare l’array di EMailSender::FileDescriptior.
Il codice risultante sarà
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
#include "Arduino.h"
#include <SPI.h>
#include <UIPEthernet.h>
#include <SD.h>
#include <EMailSender.h>
byte mac[] = { 0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED };
EMailSender emailSend("<LOGIN>", "<PASSWD>", "<EMAIL-FROM>", "<SMTP-SERVER>", "<SMTP-SERVER-PORT>");
void printDirectory(File dir, int numTabs);
void setup()
{
Serial.begin(115200);
delay(2000);
Serial.println("Starting!");
Serial.print("Initializing SD card...");
if (!SD.begin(4)) {
Serial.println("initialization failed!");
while (1);
}
Serial.println("initialization done.");
File root = SD.open("/");
printDirectory(root, 0);
Serial.println("done!");
if (Ethernet.begin(mac) == 0) {
Serial.println("Failed to configure Ethernet using DHCP");
while(1);
}
Serial.print("IP address ");
Serial.println(Ethernet.localIP());
EMailSender::EMailMessage message;
message.subject = "Soggetto";
message.message = "Ciao come stai<br>io bene.<br>www.mischianti.org";
message.mime = MIME_TEXT_PLAIN;
EMailSender::FileDescriptior fileDescriptor[1];
fileDescriptor[0].filename = F("test.txt");
fileDescriptor[0].url = F("/test.txt");
fileDescriptor[0].mime = MIME_TEXT_PLAIN;
fileDescriptor[0].storageType = EMailSender::EMAIL_STORAGE_TYPE_SD;
EMailSender::Attachments attachs = {1, fileDescriptor};
EMailSender::Response resp = emailSend.send("email_to_receive@gmail.com", message, attachs);
Serial.println("Sending status: ");
Serial.println(resp.status);
Serial.println(resp.code);
Serial.println(resp.desc);
File root2 = SD.open("/");
printDirectory(root2, 0);
Serial.println("done!");
SD.end();
}
void loop()
{
}
void printDirectory(File dir, int numTabs) {
while (true) {
File entry = dir.openNextFile();
if (! entry) {
break;
}
for (uint8_t i = 0; i < numTabs; i++) {
Serial.print('\t');
}
Serial.print(entry.name());
if (entry.isDirectory()) {
Serial.println("/");
printDirectory(entry, numTabs + 1);
} else {
Serial.print("\t\t");
Serial.println(entry.size(), DEC);
}
entry.close();
}
}
Dalla versione 2.1.1 sono supportate le liste di distribuzione, quindi è possibile inviare e-mail a più account se si desidera inviare come A, CC o Cn.
Ecco un esempio
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
#include "Arduino.h"
#include <SPI.h>
#include <UIPEthernet.h>
#include <EMailSender.h>
byte mac[] = { 0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED };
EMailSender emailSend("<YOUR-SENDGRID-API-KEY>", "<YOUR-SENDGRID-PASSWD>", "<FROM-EMAIL>", "smtp.sendgrid.net", 25);
void setup()
{
Serial.begin(115200);
delay(2000);
Serial.println("Starting!");
if (Ethernet.begin(mac) == 0) {
Serial.println("Failed to configure Ethernet using DHCP");
while(1);
}
Serial.print("IP address ");
Serial.println(Ethernet.localIP());
EMailSender::EMailMessage message;
message.subject = "Soggetto";
message.message = "Ciao come stai<br>io bene.<br>www.mischianti.org";
const char* arrayOfEmail[] = {"<FIRST>@gmail.com", "<SECOND>@yahoo.com", "<THIRD>@hotmail.com"};
EMailSender::Response resp = emailSend.send(arrayOfEmail, 3, message);
Serial.println("Sending status: ");
Serial.println(resp.status);
Serial.println(resp.code);
Serial.println(resp.desc);
}
void loop()
{
}
Inviare email con allegati (libreria v2.x): Arduino Ethernet Inviare email con allegati (libreria v2.x): esp32 e esp8266 Inviare email con allegati (libreria v2.x): schede Arduino SAMD (WiFiNINA) GitHub library
