1. 项目概述一个能发邮件的非接触式测温仪最近在整理工作室的旧设备翻出来一块吃灰已久的树莓派和几个传感器模块。看着它们我就在想能不能用这些现成的“边角料”做一个有点实用价值的小玩意儿正好之前社区里有人讨论过公共场合的体温筛查问题虽然现在情况不同了但一个能自动记录、并在异常时主动通知的非接触式测温设备在很多场景下依然有用——比如小型工作室的访客管理、家里的宠物健康监测或者是对温度敏感的设备环境监控。这个项目的核心想法很简单用树莓派作为大脑连接一个非接触式的红外测温传感器比如MLX90614实时测量前方物体的温度。一旦检测到温度超过我们设定的阈值系统不是简单地亮个灯或者响个警报就完事而是自动发送一封电子邮件到指定邮箱。这样即使你不在设备旁边也能第一时间收到通知。整个系统的逻辑清晰硬件成本可控软件上主要依靠Python来粘合各个部分非常适合有一定动手能力的爱好者来复现和定制。你可能会问为什么用树莓派和Python树莓派是一个功能完整的微型电脑有丰富的GPIO通用输入输出接口可以连接各种传感器同时它又能运行完整的操作系统处理网络通信、运行脚本程序都非常方便。Python语言在树莓派社区有极好的支持库丰富、语法简洁用来快速开发这种物联网小项目再合适不过。而MLX90614是一款通过I2C总线通信的红外测温传感器无需接触物体即可测量其表面温度非常适合非接触式应用。2. 硬件选型与核心电路解析2.1 主控与传感器为什么是树莓派和MLX90614选择树莓派作为主控板几乎是这类DIY项目的首选。它不仅仅是一块单片机更是一个运行Linux系统的微型计算机。这意味着你可以用SSH远程登录、用Cron设置定时任务、用Python轻松地操作GPIO和进行网络编程。对于需要发送邮件的功能树莓派内置的网络接口Wi-Fi或以太网和完整的操作系统支持使得实现邮件发送SMTP或调用IFTTT等网络服务API变得异常简单。相比之下如果使用Arduino之类的纯单片机虽然也能实现但需要额外搭配网络模块如ESP8266并且在处理复杂的网络协议和日志记录时会麻烦很多。MLX90614是一款工业级的红外测温传感器。它的工作原理是检测物体发出的红外辐射能量并通过内置的DSP数字信号处理器计算出物体的表面温度。这里有几个关键点需要注意测量目标它测量的是物体表面的温度而不是核心体温或环境温度。对于人体测温通常测量额头或手腕但这需要考虑到皮肤表面温度与环境温差、测量距离等因素。通信方式MLX90614通常通过I2C接口与主控通信。I2C是一种两线制数据线SDA和时钟线SCL的串行总线允许多个设备挂在同一条总线上每个设备有唯一的地址。MLX90614的默认I2C地址是0x5A。精度与校准出厂时传感器已经过校准在一定的距离和角度范围内数据手册会给出比如测量距离在2-5厘米视角FOV约90度其测量精度可以满足一般需求。但对于高精度医疗用途则需要更严格的校准和环境控制。注意MLX90614有区分物体温度TOBJ1或TOBJ2和传感器自身温度TA。我们通常读取的是物体温度。有些库函数可能会返回多个温度值需要仔细查看文档。2.2 电路连接GPIO接口的“坑”与正确接法连接树莓派和MLX90614非常简单只需要四根线。但正是简单的地方最容易因为粗心而出问题。下图是典型的连接示意图树莓派 GPIO (物理引脚编号) - MLX90614 3.3V (Pin 1) - VIN GND (Pin 6) - GND GPIO 2 (SDA, Pin 3) - SDA GPIO 3 (SCL, Pin 5) - SCL这里有几个必须强调的实操要点和避坑指南电压匹配是生命线MLX90614的工作电压通常是3.3V。务必连接到树莓派的3.3V引脚Pin 1或Pin 17绝对不能接到5V引脚上否则会瞬间烧毁传感器。树莓派的GPIO引脚电平也是3.3V与MLX90614的I2C逻辑电平完美匹配。启用I2C接口树莓派的I2C接口默认是关闭的。你需要通过sudo raspi-config命令进入 “Interface Options” - “I2C”选择 “Yes” 来启用它。启用后重启生效。安装系统工具并检测设备启用I2C后建议安装i2c-tools来调试。sudo apt update sudo apt install i2c-tools python3-smbus安装后使用sudo i2cdetect -y 1命令扫描I2C总线。如果连接正确你应该能看到地址0x5a或显示为5A出现在输出列表中。如果什么都没看到首先检查接线是否牢固特别是杜邦线容易接触不良然后确认I2C是否已启用。关于上拉电阻树莓派的GPIO 2和GPIO 3即SDA和SCL内部已经有约1.8kΩ的上拉电阻到3.3V。对于短距离、单一设备的I2C通信这通常足够了不需要额外添加外部上拉电阻。但如果连接线较长或连接多个设备通信不稳定时可以考虑在SDA和SCL线上各加一个4.7kΩ的上拉电阻到3.3V。2.3 电源与其他考量整个系统的功耗很低树莓派Zero W或3B/4B都可以用普通的5V/2.5A手机充电器供电即可。如果你需要便携使用可以考虑搭配一个移动电源。为了有更好的用户体验可以增加一个简单的OLED显示屏同样通过I2C连接来实时显示温度或者一个蜂鸣器/LED在本地进行声光报警。这些都可以通过树莓派的其他GPIO口轻松扩展。3. 软件环境搭建与核心库配置硬件连接好后软件就是项目的灵魂。我们的目标是编写一个稳定、可靠的Python脚本让它能定时读取温度并在超温时触发邮件通知。3.1 Python环境与必备库安装树莓派官方系统Raspberry Pi OS已经预装了Python3。我们首先需要安装操作硬件和发送邮件所需的库。更新系统并安装pip确保包管理器是最新的并安装Python包管理工具pip。sudo apt update sudo apt upgrade -y sudo apt install python3-pip -y安装MLX90614的Python驱动库有几个库可以选择mlx90614-library或Adafruit-MLX90614Adafruit的库通常文档和社区支持更好。我们使用后者它依赖于Adafruit的通用I2C库。sudo pip3 install adafruit-circuitpython-mlx90614这个命令会自动安装依赖库adafruit-circuitpython-busdevice和adafruit-circuitpython-register。如果安装缓慢可以考虑使用国内镜像源例如sudo pip3 install adafruit-circuitpython-mlx90614 -i https://pypi.tuna.tsinghua.edu.cn/simple安装操作GPIO/SMBus的库Adafruit的库需要smbus2或Adafruit_Python_GPIO来底层操作I2C。我们安装smbus2。sudo pip3 install smbus23.2 邮件发送功能的两种实现路径发送邮件是本项目的核心通知功能。这里我详细对比两种最实用的方法直接使用SMTP协议和通过IFTTTIf This Then ThatWebhooks服务转发。方案一直接使用SMTP协议推荐可控性强这种方法需要你有一个支持SMTP发信的邮箱账户如Gmail、QQ邮箱、163邮箱等。Python内置的smtplib库让这一切变得简单。优点直接、快速、不依赖第三方平台延迟低。缺点需要配置邮箱的SMTP服务器信息且某些邮箱如Gmail需要开启“应用专用密码”或允许“不够安全的应用”访问安全性配置稍显复杂。以QQ邮箱为例的配置步骤登录QQ邮箱进入“设置”-“账户”。找到“POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务”部分开启“POP3/SMTP服务”或“IMAP/SMTP服务”。系统会提示你发送短信验证然后给你一个授权码。这个授权码就是后面脚本中用来登录的密码不是你的QQ邮箱密码务必保存好。QQ邮箱的SMTP服务器地址是smtp.qq.com端口是465SSL或587TLS/STARTTLS。方案二通过IFTTT Webhooks触发邮件配置简单功能强大IFTTT是一个自动化平台你可以创建“小程序”Applet。这里我们创建一个小程序“如果收到一个Webhook请求事件触发则发送一封邮件”。优点无需在脚本中处理邮箱密码和SMTP协议更安全。IFTTT还能轻松将触发动作扩展到其他数百种服务比如发短信到手机、记录到Google Sheets等。缺点依赖IFTTT服务存在网络延迟且免费版有一定速率限制。IFTTT配置步骤注册并登录IFTTT。点击“Create”创建。点击“If This” - 搜索并选择 “Webhooks” - 选择 “Receive a web request”。设置一个事件名称例如temperature_alert。这个名称需要记住后面会在Python脚本中使用。点击“Then That” - 搜索并选择 “Email” - 选择 “Send me an email”。你可以自定义邮件的标题和内容可以使用IFTTT提供的“原料”Ingredients比如{{EventName}}事件名、{{Value1}}、{{Value2}}等这些值可以从Webhook请求中传递过来。完成创建。在IFTTT的Webhooks服务页面点击“Documentation”可以看到你的专属Webhook URL格式为https://maker.ifttt.com/trigger/{event}/with/key/{your_key}。其中的{event}就是你刚才设置的事件名如temperature_alert{your_key}是你的个人密钥。实操心得对于个人项目或快速原型IFTTT方案上手更快避免了邮箱设置的繁琐。但对于需要高可靠性、低延迟或批量发送的场景直接SMTP是更专业的选择。我建议初学者可以先从IFTTT入手功能实现后再尝试SMTP以加深理解。4. Python核心脚本编写与逐行解析接下来我们将编写一个完整的Python脚本。这个脚本会循环读取温度并在温度超过阈值时通过我们选择的邮件发送方式进行通知。为了健壮性我们还会加入简单的错误处理和日志记录。4.1 脚本结构设计脚本将包含以下几个部分导入库引入所有必要的模块。配置参数集中管理温度阈值、邮件/IFTTT配置、测量间隔等。初始化传感器建立与MLX90614的通信。邮件发送函数封装SMTP或IFTTT的发送逻辑。主循环定时读取温度判断并触发报警同时将数据打印或记录到文件。4.2 完整脚本示例以SMTP方式为例下面是一个使用SMTPQQ邮箱的详细脚本我几乎在每一行关键代码后都添加了注释。#!/usr/bin/env python3 # -*- coding: utf-8 -*- import time import smtplib from email.mime.text import MIMEText from email.header import Header import board import busio import adafruit_mlx90614 import logging from datetime import datetime # 配置区域 # 温度阈值摄氏度 TEMPERATURE_THRESHOLD 37.5 # 测量间隔秒 MEASURE_INTERVAL 2 # 邮件发送配置 (以QQ邮箱为例) SMTP_SERVER smtp.qq.com SMTP_PORT 465 # 使用SSL SENDER_EMAIL your_qqqq.com # 发件人邮箱 SENDER_AUTH_CODE your_authorization_code # 注意是授权码不是密码 RECEIVER_EMAIL receiverexample.com # 收件人邮箱 # 日志配置 LOG_FILE /home/pi/temperature_monitor.log logging.basicConfig( levellogging.INFO, format%(asctime)s - %(levelname)s - %(message)s, handlers[ logging.FileHandler(LOG_FILE), logging.StreamHandler() # 同时输出到控制台 ] ) logger logging.getLogger(__name__) # 配置结束 def send_email_alert(current_temp): 使用SMTP发送邮件报警 subject f[温度警报] 检测到过高温度: {current_temp:.2f}°C # 邮件正文内容 content f 温度监控系统报警 时间{datetime.now().strftime(%Y-%m-%d %H:%M:%S)} 测量值{current_temp:.2f} 摄氏度 设定阈值{TEMPERATURE_THRESHOLD} 摄氏度 请注意检查 message MIMEText(content, plain, utf-8) message[From] Header(f树莓派温度监控 {SENDER_EMAIL}, utf-8) message[To] Header(RECEIVER_EMAIL, utf-8) message[Subject] Header(subject, utf-8) try: # 连接SMTP服务器SSL加密方式 smtp_obj smtplib.SMTP_SSL(SMTP_SERVER, SMTP_PORT) smtp_obj.login(SENDER_EMAIL, SENDER_AUTH_CODE) smtp_obj.sendmail(SENDER_EMAIL, [RECEIVER_EMAIL], message.as_string()) smtp_obj.quit() logger.info(f邮件警报发送成功当前温度: {current_temp:.2f}°C) return True except Exception as e: logger.error(f发送邮件失败: {e}) return False def main(): logger.info( 非接触式温度监控系统启动 ) logger.info(f温度阈值: {TEMPERATURE_THRESHOLD}°C, 测量间隔: {MEASURE_INTERVAL}秒) # 初始化I2C总线和传感器 try: i2c busio.I2C(board.SCL, board.SDA) sensor adafruit_mlx90614.MLX90614(i2c) logger.info(MLX90614传感器初始化成功。) except Exception as e: logger.error(f初始化传感器失败请检查连接: {e}) return # 初始化失败退出程序 # 用于防止短时间内重复报警的简单机制 last_alert_time 0 alert_cooldown 60 # 冷却时间秒避免一分钟内重复发邮件 try: while True: try: # 读取物体温度单位摄氏度 object_temp sensor.object_temperature ambient_temp sensor.ambient_temperature # 环境温度可选 logger.info(f物体温度: {object_temp:.2f}°C, 环境温度: {ambient_temp:.2f}°C) # 判断是否超温 if object_temp TEMPERATURE_THRESHOLD: current_time time.time() # 检查是否在冷却期内 if current_time - last_alert_time alert_cooldown: logger.warning(f温度超标当前: {object_temp:.2f}°C 阈值: {TEMPERATURE_THRESHOLD}°C) if send_email_alert(object_temp): last_alert_time current_time # 更新上次报警时间 else: logger.warning(邮件发送失败将在下次循环重试。) else: logger.info(f温度超标但仍在冷却期内 ({alert_cooldown}秒)本次不发送邮件。) else: logger.debug(温度正常。) except RuntimeError as e: # 常见的I2C读取错误 logger.error(f读取传感器数据时出错: {e}) except Exception as e: logger.error(f发生未知错误: {e}) # 等待下一次测量 time.sleep(MEASURE_INTERVAL) except KeyboardInterrupt: logger.info(程序被用户中断。) finally: logger.info( 监控程序结束 ) if __name__ __main__: main()4.3 关键代码段解析与避坑指南I2C初始化 (busio.I2C(board.SCL, board.SDA)):board.SCL和board.SDA是Adafruit Blinka库提供的抽象它自动映射到树莓派上正确的I2C引脚。这比直接使用引脚编号更可靠、更具可移植性。温度读取 (sensor.object_temperature):adafruit_mlx90614库将原始数据直接转换为摄氏度。确保你读取的是object_temperature物体温度而不是ambient_temperature传感器自身/环境温度。错误处理: 在while True循环内部和传感器初始化时都使用了try...except。I2C通信可能因线缆松动、电气干扰而偶尔失败良好的错误处理能防止程序因单次读取失败而崩溃并记录下错误信息便于排查。防重复报警机制: 这是一个非常重要的实践细节。如果不加控制只要温度持续超标脚本会在每个循环比如2秒一次都发送一封邮件导致邮箱被轰炸。我们引入last_alert_time和alert_cooldown变量确保在冷却时间例如60秒内只发送一次警报。日志记录: 使用Python内置的logging模块将信息同时输出到控制台和文件 (/home/pi/temperature_monitor.log)。这对于无人值守运行时的故障诊断至关重要。你可以通过tail -f /home/pi/temperature_monitor.log命令实时查看日志。IFTTT版本的核心函数替换如果你选择使用IFTTT方案只需替换send_email_alert函数其他部分完全不变。import requests IFTTT_WEBHOOK_KEY your_ifttt_webhook_key_here # 你的IFTTT Webhooks密钥 IFTTT_EVENT_NAME temperature_alert # 你在IFTTT设置的事件名 def send_email_alert(current_temp): 使用IFTTT Webhooks触发邮件报警 url fhttps://maker.ifttt.com/trigger/{IFTTT_EVENT_NAME}/with/key/{IFTTT_WEBHOOK_KEY} # IFTTT的Webhooks可以接收最多三个值value1, value2, value3 payload { value1: f{current_temp:.2f}, value2: f{TEMPERATURE_THRESHOLD}, value3: datetime.now().strftime(%Y-%m-%d %H:%M:%S) } try: response requests.post(url, datapayload) if response.status_code 200: logger.info(fIFTTT警报触发成功当前温度: {current_temp:.2f}°C) return True else: logger.error(fIFTTT请求失败状态码: {response.status_code}) return False except Exception as e: logger.error(f调用IFTTT Webhook失败: {e}) return False记得在脚本开头import requests并且通过sudo pip3 install requests安装这个库。5. 系统部署、优化与问题排查5.1 让脚本在后台持续运行我们不可能一直开着SSH窗口运行这个Python脚本。有几种方法可以让它在后台持续运行方法一使用nohup(最简单)在SSH终端中进入脚本所在目录运行nohup python3 temperature_monitor.py nohup命令让进程忽略挂断信号让它在后台运行。输出默认会重定向到当前目录的nohup.out文件。要停止它需要先用ps aux | grep temperature_monitor找到进程IDPID然后用kill PID命令结束。方法二创建Systemd服务最专业、推荐这是Linux系统管理后台服务的标准方式。它可以让脚本在系统启动时自动运行并且可以方便地查看状态、日志和重启。创建服务文件sudo nano /etc/systemd/system/temp-monitor.service写入以下内容根据你的实际路径修改WorkingDirectory和ExecStart[Unit] DescriptionTemperature Monitor Service Afternetwork.target [Service] Typesimple Userpi WorkingDirectory/home/pi/your_project_folder # 你的脚本所在目录 ExecStart/usr/bin/python3 /home/pi/your_project_folder/temperature_monitor.py Restarton-failure RestartSec10 StandardOutputsyslog StandardErrorsyslog SyslogIdentifiertemp-monitor [Install] WantedBymulti-user.target启用并启动服务sudo systemctl daemon-reload sudo systemctl enable temp-monitor.service # 开机自启 sudo systemctl start temp-monitor.service # 立即启动管理服务sudo systemctl status temp-monitor.service # 查看状态 sudo systemctl stop temp-monitor.service # 停止 sudo systemctl restart temp-monitor.service # 重启 sudo journalctl -u temp-monitor.service -f # 查看实时日志5.2 校准与提高测量准确性MLX90614的测量值受多种因素影响距离传感器与目标物体的距离。太远信号弱太近可能受其他热源干扰。最好在传感器数据手册推荐的测量距离内使用例如2-5cm。发射率不同材料表面发射红外辐射的能力不同。MLX90614默认是针对人体皮肤发射率约0.98校准的。如果测量其他物体如金属、塑料可能需要调整发射率参数但这通常需要在底层寄存器层面操作比较复杂。对于人体测温默认值即可。环境温度传感器自身的温度ambient_temperature会影响其读数。确保传感器不在发热源如树莓派CPU正上方并让其有几分钟时间与环境温度达到平衡。目标物确保测量的目标是静止的并且没有强烈的背景热源如阳光直射、暖气片在传感器视野内。一个简单的“校准”方法是用一个已知准确的水银温度计或电子体温计测量一个健康成人的额头或手腕温度同时用你的设备在标准距离如3cm测量。记录下两者的差值作为一个固定的“偏移量”在代码中补偿。例如如果标准体温计显示36.5°C你的设备显示35.8°C那么可以设置calibration_offset 0.7然后在代码中corrected_temp object_temp calibration_offset。5.3 常见问题与排查技巧实录即使按照步骤操作你也可能会遇到一些问题。下面是我在多次实践中总结的排查清单问题现象可能原因排查步骤与解决方案运行脚本报错ModuleNotFoundError: No module named boardAdafruit Blinka库未安装或安装不正确。运行sudo pip3 install adafruit-blinka。这是Adafruit库在树莓派上识别GPIO所必需的。i2cdetect检测不到设备地址0x5A1. 物理连接错误或接触不良。2. I2C未启用。3. 传感器损坏。1.断电后重新拔插所有杜邦线确保VCC、GND、SDA、SCL一一对应且插紧。2. 运行sudo raspi-config确认I2C已启用并重启。3. 用万用表测量传感器VCC和GND之间电压是否为3.3V。4. 尝试更换一个传感器。读取的温度值固定不变或为01. I2C通信失败但程序未正确处理异常。2. 代码中读取了错误的寄存器或属性。1. 在代码中加强异常捕获和打印确认sensor.object_temperature是否成功执行。2. 确认使用的是正确的属性名。对于Adafruit库是object_temperature和ambient_temperature。温度读数明显偏低或飘忽不定1. 测量距离太远或太近。2. 传感器镜头有灰尘或污渍。3. 有空气流动如风扇或背景热源干扰。1. 保持传感器与目标距离在2-5厘米并正对目标。2. 用干净的棉签轻轻清洁传感器透镜。3. 在相对静止、无强热源的环境下测试。邮件发送失败SMTP方式1. 邮箱SMTP服务未开启。2. 用户名/密码授权码错误。3. 服务器地址或端口错误。4. 网络连接问题。1. 登录邮箱确认已开启SMTP服务并获取了正确的授权码。2. 检查SMTP_SERVER,SMTP_PORT,SENDER_EMAIL,SENDER_AUTH_CODE是否填写正确。3. 尝试在树莓派上ping smtp.qq.com测试网络连通性。4. 对于Gmail可能需要在Google账户设置中启用“两步验证”并生成“应用专用密码”。IFTTT未触发邮件1. Webhook URL或事件名错误。2. IFTTT小程序未激活。3. 网络问题导致POST请求失败。1. 仔细核对IFTTT的Webhook URL中的{event}和{your_key}。2. 登录IFTTT确认小程序处于“已连接”状态。3. 在脚本中打印response.status_code和response.text查看IFTTT的返回信息。程序运行一段时间后卡死或无响应1. 未处理的异常导致程序崩溃。2. 系统资源如内存不足。3. I2C总线锁死罕见。1. 检查日志文件/home/pi/temperature_monitor.log寻找错误线索。2. 使用top或htop命令查看树莓派资源使用情况。3. 在主循环的except块中加入更广泛的异常捕获和日志记录。4. 考虑增加看门狗逻辑或在Systemd服务中设置Restarton-failure。一个高级技巧降低CPU占用我们的主循环里有一个time.sleep(MEASURE_INTERVAL)。如果间隔设为2秒树莓派CPU占用几乎为0。但如果你需要更快的响应比如0.1秒频繁的睡眠和唤醒可能不是最优解。可以考虑使用Python的sched模块进行更精确的定时调度或者使用GPIO中断如果连接了物理按钮来触发单次测量而不是循环测量。这个项目麻雀虽小五脏俱全涵盖了硬件连接、传感器驱动、Python编程、网络通信和系统服务部署等多个环节。完成它之后你完全可以举一反三将MLX90614换成其他I2C传感器如湿度、气压、光强将邮件通知换成Telegram Bot消息、钉钉机器人或者直接保存到数据库打造属于你自己的物联网监控系统。