feat: 全量同步 254 个常用的 Arduino 扩展库文件
This commit is contained in:
119
arduino-libs/arduino-cli/libraries/EMailSender/README.md
Normal file
119
arduino-libs/arduino-cli/libraries/EMailSender/README.md
Normal file
@@ -0,0 +1,119 @@
|
||||
<div>
|
||||
<a href="https://www.mischianti.org/forums/forum/mischiantis-libraries/emailsender-send-email-with-attachments/"><img
|
||||
src="https://github.com/xreef/LoRa_E32_Series_Library/raw/master/resources/buttonSupportForumEnglish.png" alt="Support forum EMailSender English"
|
||||
align="right"></a>
|
||||
</div>
|
||||
<div>
|
||||
<a href="https://www.mischianti.org/it/forums/forum/le-librerie-di-mischianti/emailsender-invio-di-email-con-allegati/"><img
|
||||
src="https://github.com/xreef/LoRa_E32_Series_Library/raw/master/resources/buttonSupportForumItaliano.png" alt="Forum supporto EMailSender italiano"
|
||||
align="right"></a>
|
||||
</div>
|
||||
|
||||
|
||||
|
||||
#
|
||||
#
|
||||
|
||||
# Library to send EMail with attachments
|
||||
### Arduino (support W5100 like must be set, and ENC28J60 via UIPEthernet), esp8266 (SPIFFS and SD) (core <=2.4.2 must be set) and esp32 (SPIFFS and SD).
|
||||
|
||||
### Complete english tutorial
|
||||
#### [Send email with attachments (EMailSender v2.x library): Arduino Ethernet](https://www.mischianti.org/category/my-libraries/emailsender-send-email-with-attachments/)
|
||||
#### [Send email with attachments (EMailSender v2.x library): esp32 and esp8266](https://www.mischianti.org/category/my-libraries/emailsender-send-email-with-attachments/)
|
||||
|
||||
### Tutorial completo in italiano
|
||||
### [Inviare email con allegati (libreria v2.x): Arduino Ethernet](https://www.mischianti.org/it/category/le-mie-librerie/emailsender-inviare-email-con-allegati/)
|
||||
### [Inviare email con allegati (libreria v2.x): esp32 e esp8266](https://www.mischianti.org/it/category/le-mie-librerie/emailsender-inviare-email-con-allegati/)
|
||||
|
||||
## Installation Tutorial:
|
||||
|
||||
To download.
|
||||
click the DOWNLOADS button in the top right corner, rename the uncompressed folder EMailSender.
|
||||
Check that the EMailSender folder contains `EMailSender\\.cpp` and `EMailSender.h`.
|
||||
Place the EMailSender library folder your `<arduinosketchfolder>/libraries/` folder.
|
||||
You may need to create the libraries subfolder if its your first library.
|
||||
Restart the IDE.
|
||||
|
||||
# EMailSender library to send EMail.
|
||||
With this library you can send email with attach:
|
||||
Arduino
|
||||
Network supported
|
||||
- w5100 like shield with Ethernet library
|
||||
- enc28J60 with UIPLibrary
|
||||
Storage support
|
||||
- SD
|
||||
|
||||
esp8266
|
||||
you must pay attention, older core from 2.4.2 must be activated
|
||||
Storage supported
|
||||
- SD
|
||||
- SPIFFS
|
||||
|
||||
esp32
|
||||
Storage supported
|
||||
- SD
|
||||
- SPIFFS
|
||||
|
||||
Constructor:
|
||||
Default value is quite simple and use GMail as smtp server.
|
||||
```cpp
|
||||
EMailSender emailSend("smtp.account@gmail.com", "password");
|
||||
```
|
||||
|
||||
If you want use onother provider you can use more complex (but simple) contructor
|
||||
```cpp
|
||||
EMailSender(const char* email_login, const char* email_password, const char* email_from, const char* smtp_server, uint16_t smtp_port);
|
||||
|
||||
```
|
||||
|
||||
You must connect to WIFI :P.
|
||||
|
||||
Create a message with the structure EMailMessage
|
||||
```cpp
|
||||
EMailSender::EMailMessage message;
|
||||
message.subject = "Subject";
|
||||
message.message = "Hi, How are you<br>Fine.";
|
||||
```
|
||||
|
||||
Create array of attachments
|
||||
```cpp
|
||||
// Two file
|
||||
EMailSender::FileDescriptior fileDescriptor[2];
|
||||
fileDescriptor[1].filename = F("test.txt");
|
||||
fileDescriptor[1].url = F("/test.txt");
|
||||
fileDescriptor[1].storageType = EMailSender::EMAIL_STORAGE_TYPE_SD;
|
||||
|
||||
fileDescriptor[0].filename = F("logo.jpg");
|
||||
fileDescriptor[0].url = F("/logo.jpg");
|
||||
fileDescriptor[0].mime = "image/jpg";
|
||||
fileDescriptor[0].encode64 = true;
|
||||
fileDescriptor[0].storageType = EMailSender::EMAIL_STORAGE_TYPE_SD;
|
||||
|
||||
EMailSender::Attachments attachs = {2, fileDescriptor};
|
||||
```
|
||||
|
||||
Send message:
|
||||
```cpp
|
||||
EMailSender::Response resp = emailSend.send("account_to_send@gmail.com", message, attachs);
|
||||
```
|
||||
|
||||
Then check the response:
|
||||
```cpp
|
||||
Serial.println("Sending status: ");
|
||||
Serial.println(resp.code);
|
||||
Serial.println(resp.desc);
|
||||
Serial.println(resp.status);
|
||||
```
|
||||
|
||||
From version 2.1.1 new features distribution list to send CC and CCn email.
|
||||
|
||||
Example output:
|
||||
|
||||
```cpp
|
||||
Connection: ESTABLISHED
|
||||
Got IP address: 192.168.1.104
|
||||
Sending status:
|
||||
1
|
||||
0
|
||||
Message sent!
|
||||
```
|
||||
Reference in New Issue
Block a user