软件包大赏第12期 | SMTP软件包,让你的设备实现“书信往来”

小伙伴们,好久不见!不知不觉软件包栏目已经连载了11期,通过「软件包大赏」栏目大家也认识了不少来自社区的牛人,热爱探索的学生马龙伟/郭永超 、总是创意满满的留洋博士阿嘉、风趣幽默的“杀猪哥”,玄乎其神的吴博~(回看往期,请点击此处)受了他们的影响,有很多新朋友陆续参与到了软件包的贡献中。未来,我们的软件包大赏栏目,除了分享更多更高质量的软件包,谈谈这些软件包背后的“奇闻轶事”,还将增加软件包制作/使用专题访谈,欢迎大家的关注!

软件包大赏第12期 | SMTP软件包,让你的设备实现“书信往来”

大四时候的实习公司(也是我目前就任的公司)安排我学习RTT,这时候我才发现,RTT就是我一直以来追求的那个目标。RTT不仅仅是一个操作系统,它更是一个集成了底层操作系统、中层设备驱动以及上层应用软件的嵌入式开发平台。其强大的组件与驱动将不同硬件平台完全统一了起来,使上层应用真正做到不同硬件平台的无缝移植。与此同时,其独有的嵌入式软件包生态让开发者能够具备更强大、更灵活的开发能力,同时也能从优秀的软件包中学习到更多的编程知识与技巧。这也是我最爱RTT的部分,因此,我也积极参与到了软件包生态的建设中来。同时也希望越来越多的开发者入驻RT-Thread,共同为RTT的发展出一份力!

怎么会想到做这样一个软件包呢/p>

哈哈,这个就要从使用背景说起:

软件包使用背景:

随着物联网的迅速发展,越来越多的电子设备实现了智能化,从前都是人与人之间的交流,而如今更多的人希望自己的设备也能和自己进行“交流”。而最简单的交流方式,即通过“邮件交流”。SMTP即简单邮件传输协议,我们平时通过邮箱软件发送邮件就是基于这个协议。

 

本软件包基于嵌入式平台实现了SMTP协议,使设备能够自动给指定的收件人发送邮件。可用于电力监控、智能家居等领域。该软件包不仅支持普通的25端口,还支持465/587这两个加密端口,进一步拓宽使用场景。其使用方法也非常简单,使用者无需关注SMTP的具体实现,当你设置好一些基本参数后,仅需调用一个接口,便可实现邮件的发送!想与你的设备实现“书信往来”吗就赶快来试试这个软件包吧!

SMTP_CLIENT的使用

简介


这是一个基于RT-Thread的SMTP软件包,其支持普通的25端口,同时也支持465和587这两个加密端口。该软件包的使用非常简单方便,如果是基于RT-Thread操作系统,则无需进行任何移植操作即可使用,且仅需调用几个简单的接口即可实现不同端口的邮件发送功能。

特性


★支持25端口

★支持加密功能,支持465,587端口。(有些邮件服务器可能不支持其中的某个端口,用户使用前需了解自己所选用的邮件服务器支持哪个端口的smtp功能)

★使用简单,无需了解SMTP协议,设置好一些必要参数后仅需一个接口即可实现邮件发送。

软件包使用说明



准备工作

Env 配置说明

首先需要下载 SMTP_CLIENT 软件包,并将软件包加入到项目中。在 BSP 目录下使用 menuconfig 命令打开 Env 配置界面,在  中选择 SMTP_CLIENT 软件包,具体路径如下:

◢ Version: 配置软件版本

◢ use 465/587 port(encrypted port): 使用加密端口,选中后会将 mbedtls 软件包加入编译,同时开启 465和587 两个加密端口的支持。

◢ enable debug log information: 使能调试打印信息

◢ smtp client example: 加入示例文件

注意:加入示例文件后不能直接下载使用,默认示例中缺少SMTP的个人参数,需要用户补全自己的用户名密码及接收方邮箱等信息!

注意事项

◢ 开启加密功能后会占用比较大的RAM空间,请根据自己使用的硬件平台决定是否选用加密。并且适当调大调用发送功能的线程的堆栈大小。(推荐大于4096)

◢ 有些邮件服务器不支持某个加密端口或者默认关闭,使用者需要确认自己选用的邮件服务器所支持的端口,并且确认已经打开邮件服务器的SMTP功能。

◢ 若用户在使用的过程中出现加密有关的错误,请参照 RT-Thread mbedtls 软件包的说明文档。

使用说明


使用步骤

  1. 调用  函数初始化 smtp_client 客户端

  2. 调用  函数设置服务器的地址及端口

  3. 调用  函数设置服务器认证信息

  4. 调用  函数发送邮件

API详解

1、初始化SMTP客户端

该函数主要用于初始化 smtp 会话结构。

2、设置SMTP服务器地址及端口

软件包大赏第12期 | SMTP软件包,让你的设备实现“书信往来”

该函数用于设置 smtp 服务器地址及端口,地址类型为域名类型和IP类型,分别对应宏 ADDRESS_TYPE_DOMAIN 与 ADDRESS_TYPE_IP .需要注意的是,由于时间仓促及其需求不是很大,目前仅支持域名连接,但如果有需求,在后续版本中会加入IP连接。当然程序中已预留接口,需求紧的用户可使用接口进行拓展。

3、设置 smtp 服务器认证信息

软件包大赏第12期 | SMTP软件包,让你的设备实现“书信往来”

该函数用于设置 smtp 服务器的认证信息,需要注意有些服务器需要用 凭据 而非用户登录邮箱时的密码进行认证,用户在连接服务器时需要确认自己所用服务器的认证方式。

4、发送邮件

软件包大赏第12期 | SMTP软件包,让你的设备实现“书信往来”

该函数为邮件发送函数,在用户设置好服务器的连接参数后,可以直接调用该函数进行邮件的发送。需要注意的是,发送者邮箱地址必须和登录用户名相同。

宏配置说明


若用户在使用过程中发现默认的配置无法满足自身的使用需求,用户可以进入 smtp_client_private.h 文件对相关宏定义参数进行配置:

软件包大赏第12期 | SMTP软件包,让你的设备实现“书信往来”

立即报名

2、RT-Thread能力认证考前线上培训,将于2019年10月21号正式开始,如果您有晋升、求职、寻找更好机会的需要,有深入学习和掌握RT-Thread的需求,请尽快垂询/报考!学生优惠价:168/人 

软件包大赏第12期 | SMTP软件包,让你的设备实现“书信往来”

立即报名(非学生)

#题外话# 喜欢RT-Thread不要忘了在GitHub上留下你的

软件包大赏第12期 | SMTP软件包,让你的设备实现“书信往来”哦,你的star对我们来说非常重要!链接地址:https://github.com/RT-Thread/rt-thread

你可以添加微信17775983565为好友,注明:公司+姓名,拉进 RT-Thread 官方微信交流群

软件包大赏第12期 | SMTP软件包,让你的设备实现“书信往来”

点击“阅读原文”进入GitHub

文章知识点与官方知识档案匹配,可进一步学习相关知识Java技能树首页概览91749 人正在系统学习中

来源:RT-Thread物联网操作系统

声明:本站部分文章及图片转载于互联网,内容版权归原作者所有,如本站任何资料有侵权请您尽早请联系jinwei@zod.com.cn进行处理,非常感谢!

上一篇 2019年9月20日
下一篇 2019年9月20日

相关推荐