1. 项目概述为什么要在Edison上做邮件通知几年前当我在一个工业物联网项目里第一次把邮件通知功能塞进一块小小的Edison开发板时团队里不少人觉得这有点“杀鸡用牛刀”。一块主打物联网边缘计算的板子安安静静地采集数据、控制设备就好了干嘛非要让它去折腾SMTP协议、处理邮件编码这些“上层应用”的活儿但实际跑起来后效果立竿见影。产线上某台关键设备的温度传感器读数一旦超过阈值现场工程师的手机在几秒内就能收到告警邮件附带详细的时间戳和设备ID省去了他们频繁刷新监控后台的麻烦。这个看似简单的“邮件通知”功能恰恰是Edison这类边缘计算节点从“数据采集器”升级为“智能决策终端”的关键一步。简单来说在Intel Edison上开发邮件通知程序核心目标就是赋予这个边缘设备主动“说话”的能力。它不再被动地等待上位机来查询数据而是能在预设条件触发时比如传感器异常、定时任务完成、系统启动成功主动向指定的邮箱发送信息。这对于无人值守的远程监控站、智能家居的安防报警、自动化测试设备的结果回传等场景价值巨大。你不需要一直守着个屏幕设备自己会在关键时刻“喊”你。适合做这件事的人可能你已经玩转了Edison的GPIO能读取温湿度、控制继电器但感觉项目还缺点“灵魂”或者你正在做一个需要远程状态反馈的小型装置但觉得接入复杂的云平台比如一些物联网PaaS过于臃肿想用一个更轻量、更直接的方式。那么用Python在Edison上实现邮件通知就是一个非常务实且高效的选择。它不依赖特定的云服务商只要板子能联网就能把消息送出去自主权完全在你手里。2. 核心思路与方案选型为什么是Python SMTP在Edison上实现邮件通知路径不止一条。你可以用C直接怼Socket编程去实现SMTP协议也可以用Node.js借助丰富的npm包。但我几乎在所有生产环境下都首选Python。原因很直接开发效率极高生态成熟且Edison的官方Yocto Linux镜像对Python支持友好。用Python你可以在半小时内从一个能点亮LED的程序升级成一个能发送告警邮件的“智能终端”这种快速迭代的能力在原型验证阶段至关重要。具体到邮件发送Python标准库里的smtplib和email就是我们的“瑞士军刀”。smtplib负责与邮件服务器建立连接、进行身份验证和发送指令而email库则用来构建一封结构正确的邮件包括发件人、收件人、主题、正文、附件等。这个组合非常经典和稳定。这里有一个关键的方案选型点使用哪个邮件服务商的SMTP服务器常见的有以下三种各有优劣使用企业或个人邮箱的SMTP服务如QQ邮箱、163邮箱、Gmail、公司邮箱优点最通用无需额外注册尤其适合个人项目或内部系统。配置相对简单。缺点通常有发送频率限制防垃圾邮件且可能需要开启“SMTP服务”并获取授权码而非登录密码。对于Gmail可能需要配置“应用专用密码”或允许“不够安全的应用”访问。适用场景低频次、非商业用途的通知例如每天几条的设备状态报告、异常告警。使用第三方邮件发送服务如SendGrid、Mailgun优点专为程序发送邮件设计API友好提供详细的发送统计、投递追踪发送限额高专业可靠。缺点通常有免费额度超出需付费。需要注册并获取API Key。适用场景需要高可靠性、高发送量或需要邮件投递分析的商业项目或重要应用。自建邮件服务器如Postfix优点完全自主控制无发送限制。缺点配置和维护极其复杂需要处理IP信誉、反垃圾邮件策略SPF、DKIM、DMARC等问题极易被收件方判为垃圾邮件。适用场景不推荐在资源有限的Edison上或对邮件投递率要求不高的场景中使用除非你非常熟悉邮件系统运维。对于绝大多数Edison上的物联网、创客项目我强烈推荐第一种方案使用一个常见的免费邮箱如QQ邮箱的SMTP服务。它平衡了易用性、可靠性和成本免费。我们接下来的实操也将基于此进行。注意无论选择哪种服务都必须妥善保管你的登录凭证密码或授权码。在代码中硬编码密码是极不安全的行为特别是在你可能将代码上传到公开仓库时。稍后我们会介绍如何安全地管理这些敏感信息。3. 环境准备与依赖安装在开始写代码之前我们需要确保Edison上的Python环境是就绪的。Edison默认的Yocto系统通常已经预装了Python 2.7。但为了更好的兼容性和功能我建议使用Python 3。同时我们还需要确保系统有可用的网络连接。3.1 检查与更新系统首先通过SSH连接到你的Edison开发板。然后更新软件包列表并升级现有软件包这是一个好习惯。opkg update opkg upgrade3.2 安装Python 3及pip检查是否已安装Python 3python3 --version如果未安装使用opkg进行安装opkg install python3 python3-pippip3是Python 3的包管理工具后续如果需要安装额外的第三方库比如用于读取特定传感器的库会用到它。但发送邮件仅用标准库所以这一步主要是为了环境完整。3.3 验证网络连通性邮件发送依赖于网络确保Edison可以访问互联网。可以尝试ping一个外网地址ping -c 4 8.8.8.8如果无法ping通你需要检查Edison的网络配置是通过USB共享网络、连接Wi-Fi还是使用有线网络。确保其网关和DNS设置正确。3.4 准备邮箱并获取SMTP授权信息以QQ邮箱为例你需要开启SMTP服务并获取授权码登录QQ邮箱网页版。进入“设置” - “账户”。找到“POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务”部分。开启“POP3/SMTP服务”或“IMAP/SMTP服务”开启一个即可。根据提示发送短信验证后你会获得一个16位的授权码。请务必复制保存好这个授权码它就是你代码中用来登录SMTP服务器的密码。记下以下关键信息我们稍后会在代码中使用SMTP服务器地址smtp.qq.comSSL端口465(推荐加密传输)TLS端口587(也可用STARTTLS方式)你的QQ邮箱地址例如123456789qq.com你的授权码刚才获取的那串字符其他邮箱服务商如163、Gmail的配置类似只需查找其官方文档提供的SMTP服务器地址和端口即可。4. 核心代码实现与逐行解析现在我们来编写最核心的Python脚本。我将创建一个名为send_mail_from_edison.py的文件并逐部分解释。4.1 基础邮件发送脚本#!/usr/bin/env python3 # -*- coding: utf-8 -*- import smtplib from email.mime.text import MIMEText from email.mime.multipart import MIMEMultipart from email.header import Header import sys def send_email(subject, body, to_addr): 从Edison发送邮件的主函数 :param subject: 邮件主题字符串 :param body: 邮件正文字符串 :param to_addr: 收件人邮箱地址字符串 # 1. 邮件服务器配置 (以QQ邮箱为例请替换为你自己的信息) mail_host smtp.qq.com # SMTP服务器地址 mail_port 465 # SSL端口 mail_user your_qqqq.com # 发件人邮箱 mail_pass your_authorization_code # 邮箱授权码注意保密 # 2. 发件人、收件人 from_addr mail_user # 收件人地址由参数传入可以是单个字符串也可以是列表 to_addrs [to_addr] if isinstance(to_addr, str) else to_addr # 3. 创建邮件对象 # 使用MIMEMultipart可以方便后续添加附件即使现在不用也保留扩展性 message MIMEMultipart() message[From] Header(fEdison设备 {from_addr}, utf-8) # 设置发件人昵称 message[To] Header(,.join(to_addrs), utf-8) # 设置收件人 message[Subject] Header(subject, utf-8) # 主题 # 4. 添加邮件正文 # 第一个参数是正文内容第二个参数是正文格式plain为纯文本html为HTML body_part MIMEText(body, plain, utf-8) message.attach(body_part) try: # 5. 连接服务器并发送 # 使用SSL加密连接对应465端口 smtp_obj smtplib.SMTP_SSL(mail_host, mail_port) # 调试模式会在终端打印与服务器的交互信息正式使用可设为0关闭 smtp_obj.set_debuglevel(0) # 登录服务器 smtp_obj.login(mail_user, mail_pass) # 发送邮件 smtp_obj.sendmail(from_addr, to_addrs, message.as_string()) print(f[成功] 邮件已发送至 {to_addrs}) return True except smtplib.SMTPException as e: print(f[失败] 邮件发送失败: {e}) return False finally: # 6. 关闭连接 try: smtp_obj.quit() except: pass if __name__ __main__: # 测试发送一封简单的邮件 test_subject 【Edison测试】邮件功能正常 test_body f 这是一封来自Intel Edison开发板的测试邮件。 发送时间{sys.argv[1] if len(sys.argv) 1 else 未知} 板载信息邮件通知模块运行正常。 test_to recipientexample.com # 替换为你的收件邮箱 success send_email(test_subject, test_body, test_to) sys.exit(0 if success else 1)4.2 关键代码段解析与注意事项关于端口的选择465 vs 587代码中使用了SMTP_SSL和465端口这是一种“隐式SSL”连接一上来就建立加密通道非常直接。如果你的邮箱服务商不支持465或者你遇到连接问题可以尝试使用587端口和STARTTLS方式# 替代465端口的SSL连接方式 smtp_obj smtplib.SMTP(mail_host, 587) # 使用587端口 smtp_obj.starttls() # 启动TLS加密 smtp_obj.login(mail_user, mail_pass)选择建议优先尝试465SMTP_SSL如果不行再换587STARTTLS。QQ邮箱两者都支持。关于邮件头Header和编码Header(subject, utf-8)这行代码至关重要。它确保了邮件主题Subject和发件人昵称等包含中文或其他非ASCII字符时能够被正确编码和解码避免出现乱码。这是处理中文邮件时必须的一步。安全警告密码硬编码问题上面的示例为了清晰把授权码直接写在了代码里mail_pass “...”。这在实践中是极其危险的尤其是当你使用Git等版本控制系统时很容易不小心把密码提交到公开仓库。我们必须解决它。5. 进阶实践安全配置与项目集成一个健壮的邮件通知模块必须解决身份凭证的安全存储问题并能灵活地集成到你的主项目中。5.1 使用配置文件管理敏感信息我们将敏感信息移出代码放入一个单独的配置文件如config.ini并确保该文件不被提交到版本库。创建config.ini[EMAIL] host smtp.qq.com port 465 user your_qqqq.com password your_actual_authorization_code_here sender_name Edison监控器修改Python代码读取配置import configparser import os def load_config(): config configparser.ConfigParser() # 假设config.ini与脚本在同一目录 config_path os.path.join(os.path.dirname(__file__), ‘config.ini’) if not os.path.exists(config_path): raise FileNotFoundError(f“配置文件 {config_path} 未找到”) config.read(config_path, encoding‘utf-8’) return config # 在send_email函数中替换硬编码部分 config load_config() mail_host config[‘EMAIL’][‘host’] mail_user config[‘EMAIL’][‘user’] mail_pass config[‘EMAIL’][‘password’] # ... 其他代码重要操作将config.ini添加到你的.gitignore文件中确保它不会被上传。5.2 封装为可调用的模块一个好的实践是将邮件发送功能封装成一个独立的模块或类方便在主程序中调用。我们创建一个mail_sender.py文件# mail_sender.py import smtplib from email.mime.text import MIMEText from email.mime.multipart import MIMEMultipart from email.header import Header import configparser import os class EdisonMailSender: def __init__(self, config_path‘config.ini’): self.config self._load_config(config_path) self.host self.config[‘EMAIL’][‘host’] self.port int(self.config[‘EMAIL’][‘port’]) self.user self.config[‘EMAIL’][‘user’] self.password self.config[‘EMAIL’][‘password’] self.sender_name self.config[‘EMAIL’].get(‘sender_name’, ‘Edison Device’) def _load_config(self, path): config configparser.ConfigParser() abs_path os.path.join(os.path.dirname(__file__), path) if not os.path.exists(abs_path): raise FileNotFoundError(f“Config file not found: {abs_path}”) config.read(abs_path, encoding‘utf-8’) return config def send(self, subject, body, to_addrs, is_htmlFalse): “”” 发送邮件 :param to_addrs: 可以是单个邮箱字符串或邮箱列表 “”” if isinstance(to_addrs, str): to_addrs [to_addrs] msg MIMEMultipart() msg[‘From’] Header(f“{self.sender_name} {self.user}”, ‘utf-8’) msg[‘To’] Header(“,”.join(to_addrs), ‘utf-8’) msg[‘Subject’] Header(subject, ‘utf-8’) # 根据参数决定正文格式 body_type ‘html’ if is_html else ‘plain’ msg.attach(MIMEText(body, body_type, ‘utf-8’)) try: if self.port 465: server smtplib.SMTP_SSL(self.host, self.port) else: server smtplib.SMTP(self.host, self.port) if self.port 587: # STARTTLS server.starttls() server.login(self.user, self.password) server.sendmail(self.user, to_addrs, msg.as_string()) server.quit() print(f“邮件发送成功 - {to_addrs}”) return True except Exception as e: print(f“邮件发送失败: {e}”) return False # 提供一个便捷的全局发送函数 _sender_instance None def send_mail(subject, body, to_addrs, is_htmlFalse): global _sender_instance if _sender_instance is None: _sender_instance EdisonMailSender() return _sender_instance.send(subject, body, to_addrs, is_html)这样在你的主程序比如一个传感器监控循环main.py中调用就变得非常简洁# main.py from mail_sender import send_mail import time from your_sensor_lib import read_temperature # 假设的传感器读取函数 ALERT_EMAIL “your-alert-emailexample.com” ALERT_THRESHOLD 60.0 # 温度阈值 while True: temp read_temperature() print(f“当前温度: {temp:.2f}°C”) if temp ALERT_THRESHOLD: subject f“【高温告警】温度超标: {temp:.2f}°C” body f“设备检测到温度过高。\n当前值: {temp:.2f}°C\n阈值: {ALERT_THRESHOLD}°C\n时间: {time.ctime()}” send_mail(subject, body, ALERT_EMAIL) print(“已发送告警邮件。”) time.sleep(60) # 每分钟检查一次5.3 添加附件支持有时你可能需要随邮件发送日志文件或图片比如摄像头抓拍的异常画面。email.mime模块让这变得简单。在EdisonMailSender类中添加一个方法# 在 mail_sender.py 的 EdisonMailSender 类中添加 def send_with_attachment(self, subject, body, to_addrs, file_paths, is_htmlFalse): “”” 发送带附件的邮件 :param file_paths: 附件文件路径列表 “”” if isinstance(to_addrs, str): to_addrs [to_addrs] msg MIMEMultipart() # ... 设置 From, To, Subject (同上) ... # 添加正文 body_part MIMEText(body, ‘html’ if is_html else ‘plain’, ‘utf-8’) msg.attach(body_part) # 添加附件 for file_path in file_paths: if not os.path.exists(file_path): print(f“警告: 附件文件不存在 {file_path}”) continue filename os.path.basename(file_path) with open(file_path, ‘rb’) as f: att MIMEBase(‘application’, ‘octet-stream’) att.set_payload(f.read()) encoders.encode_base64(att) # 对附件进行Base64编码 att.add_header(‘Content-Disposition’, ‘attachment’, filenameHeader(filename, ‘utf-8’).encode()) msg.attach(att) # ... 发送逻辑 (同上使用msg.as_string()) ...使用时你需要从email模块额外导入from email.mime.base import MIMEBase和from email import encoders。6. 常见问题、故障排查与优化技巧在实际部署中你几乎一定会遇到一些问题。下面是我踩过坑后总结的排查清单和优化建议。6.1 连接与认证失败这是最常见的问题。请按以下顺序排查网络问题确保Edison可以访问互联网。ping smtp.qq.com看是否能解析并连通。服务器与端口确认你使用的SMTP服务器地址和端口号完全正确。不同服务商不同端口465和587都试试。用户名与密码用户名通常是完整的邮箱地址。密码99%的问题出在这里对于QQ/163等邮箱必须使用授权码而不是你的邮箱登录密码。请去邮箱设置里重新生成并确认。Gmail可能需要开启“两步验证”然后生成一个“应用专用密码”来使用。SSL/TLS问题如果使用465端口确保代码中用的是SMTP_SSL。如果使用587端口确保调用了starttls()方法。防火墙极少数情况下Edison所在网络的防火墙可能屏蔽了SMTP端口。尝试更换网络环境测试。6.2 邮件被接收方拒收或进入垃圾箱发送成功不代表对方能收到。要提升邮件的“可信度”设置合理的发件人昵称如“实验室温湿度监控”比一串乱码好。控制发送频率免费邮箱的SMTP有发送频率限制如QQ邮箱约每24小时100-150封短时间内狂发会被暂时禁用或判为垃圾邮件。邮件内容避免使用过于营销化的主题和正文如大量感叹号、“免费”、“促销”等词。纯文本、说明性的通知邮件到达率更高。SPF/DKIM进阶对于自建服务器或企业邮箱配置SPF和DKIM记录是避免被拒收的关键。但对于使用QQ/163等第三方SMTP服务其服务器已经配置好了这些你发送的邮件会带上服务商的信誉一般问题不大。6.3 Edison上的资源与稳定性优化Edison资源有限邮件发送是网络I/O操作可能会阻塞主线程或失败。使用线程或异步如果你的主程序是循环监测发送邮件时可以考虑使用threading模块创建一个线程来执行发送任务避免因网络延迟导致主循环卡住。import threading def send_mail_async(subject, body, to_addr): thread threading.Thread(targetsend_mail, args(subject, body, to_addr)) thread.start()增加重试机制网络可能瞬时波动。可以在发送函数中加入简单的重试逻辑。def send_with_retry(mailer, subject, body, to_addr, max_retries3): for i in range(max_retries): if mailer.send(subject, body, to_addr): return True print(f“发送失败第{i1}次重试...”) time.sleep(5) # 等待5秒后重试 print(“达到最大重试次数发送失败。”) return False日志记录不要只依赖print。将发送成功/失败的信息记录到本地文件如/var/log/edison_mail.log便于后续排查。可以使用Python的logging模块。电源管理如果Edison由电池供电频繁的网络连接和SSL握手会比较耗电。可以考虑将多个告警事件聚合定期如每小时发送一封汇总邮件而不是每个事件都立即发送。6.4 一个实用的调试技巧在开发阶段将smtplib.SMTP或SMTP_SSL的调试级别打开可以让你看到底层与邮件服务器的完整对话对于定位问题非常有帮助。smtp_obj smtplib.SMTP_SSL(mail_host, mail_port) smtp_obj.set_debuglevel(1) # 设置为1打印调试信息你会在终端看到类似send: ‘ehlo...’reply: ‘250-smtp.qq.com...’的详细日志。通过观察reply行服务器通常会明确告诉你错误原因比如535 Error: authentication failed认证失败。7. 项目集成与场景扩展思路基础功能跑通后你可以把它无缝集成到各种Edison项目中使其真正“活”起来。场景一环境监控与告警结合DHT11/DHT22温湿度传感器、MQ-2烟雾传感器等。当温度超过阈值、湿度异常或检测到烟雾时立即发送告警邮件。邮件正文可以包含具体的传感器数值、时间以及建议的处理措施。场景二设备状态定时报告使用Linux的cron定时任务让Edison每天或每周固定时间发送一封“健康报告”邮件。报告内容可以包括设备已运行时间uptime、CPU温度从/sys/class/thermal/thermal_zone0/temp读取、存储空间使用情况df -h、最近的应用日志摘要等。场景三安防与图像通知连接一个USB摄像头或兼容的摄像头模块如PiCamera需适配驱动。当PIR人体红外传感器被触发时不仅发送“有人闯入”的文本告警还可以调用fswebcam或raspistill需移植抓拍一张图片作为附件发送出去实现“有图有真相”。场景四自动化任务结果反馈如果你用Edison跑一个定时的数据抓取脚本、自动化测试脚本或文件备份脚本可以在脚本执行结束时无论成功失败发送一封邮件汇总执行结果、关键输出或错误信息。这对于无人值守的自动化任务非常有用。关于网络热词中“微信小程序开发”的联想虽然本文主题是Edison但思路是相通的。你在微信小程序里生成二维码比如用wx.createCanvasContext绘制或调用后端API和你在Edison上生成一封邮件本质都是“在特定场景下生成并输出一个结构化的数据包”。理解了一个协议如SMTP或一个流程再学习另一个如小程序API会容易很多。Edison的邮件通知是“设备到人”的通信而小程序二维码往往是“人到设备”或“人到服务”的入口两者结合可以构建更完整的物联网应用闭环。例如Edison监控到异常发送邮件邮件里包含一个链接用户点击后跳转到一个小程序页面查看更详细的设备仪表盘或进行远程控制。