简介面向树莓派与 Python 嵌入式开发及智能家居安防实践的 PDF 文档系统梳理了一套室内入侵报警与照片回传装置的设计思路适合物联网、电子信息和计算机相关专业学生、课程设计或毕业设计参考者以及希望快速了解传感器联动与远程控制流程的开发者。内容围绕硬件选型、软件编程与代码实现展开涉及红外传感器、蜂鸣器、迷你摄像头模块以及 GPIO 引脚定义、wxpy 微信接口、Picamera 摄像头调用等关键库的用法并给出人机对话触发报警的完整逻辑。压缩包内共 1 个 PDF 文件大小约 1.85MB属于单文件技术资料便于直接阅读和检索。目前已有 284 人学习下载可作为智能安防系统开发、人工智能与系统开发方向的参考文献和专业指导帮助读者理解从传感器采集、树莓派处理到移动端反馈的项目全貌也可为类似嵌入式安防方案提供模块扩展与代码调试思路。1. 从「装个摄像头」到可交付的树莓派 Python 智能安防系统很多人对树莓派安防项目的想象停留在「插上 OV5647 摄像头模块Python 调个 cv2.VideoCapture有人脸就报警」。真跑到现场部署问题全在链路后半段光照突变导致帧差法整屏泛白、PIR 触发与摄像头录制抢 CPU 导致丢帧、断网时告警邮件静默失败、systemd 拉起脚本后 GPIO 权限报 PermissionError。树莓派 Python 智能安防系统设计的核心不是检测算法本身而是把「传感器触发 — 视频采集 — 本地判定 — 异步告警 — 存证回溯」串成一条能在无人值守环境下稳定跑数周的流水线。树莓派 4B 或树莓派 5 搭配 CSI 接口的 OV5647、HC-SR501 人体红外模块、有源蜂鸣器配合 Python 的 picamera2、OpenCV、RPi.GPIO、smtplib就能覆盖家庭、小型仓库、办公位这类低功耗场景。这篇内容按实际部署顺序拆解硬件接线与系统准备、视频管线搭建、PIR 联动与运动检测、告警与存证、服务化与调优。2. 树莓派硬件选型与 Python 运行环境准备2.1 树莓派 4B / 5 与 OV5647 摄像头模块的搭配逻辑选型上树莓派 4B2GB 起步和树莓派 5 是最常见的两块板子。4B 的 CSI 接口走的是传统 pipeline对 OV5647500 万像素原生 1080p30fps支持成熟配 5V/3A 电源即可。树莓派 5 的 CSI 带宽更高能上双摄像头但功耗和散热要求更严需要官方 27W USB-C PD 电源和主动散热。硬件项推荐型号关键参数说明主控板树莓派 4B四核 A72 1.5GHz / 2-4GB功耗低CSI 驱动稳定主控板备选树莓派 5四核 A76 2.4GHz / 4-8GB支持双 CSI需主动散热摄像头OV56471080p30fps / CSI性价比高libcamera 已适配人体红外HC-SR5013.3V / 检测 7m输出数字高电平触发蜂鸣器有源 3.3VGPIO 直驱有源接 GPIO 即响存储Class10 A1 microSD≥32GB写入速度影响录像落盘摄像头排线要注意方向OV5647 排线金手指朝向 HDMI 口那一侧插反了libcamera-hello会直接报no cameras available。这是新手最常见的硬件坑。2.2 树莓派烧录、修改源与 Python 环境配置树莓派烧录推荐用 Raspberry Pi Imager 写入 64 位 Raspberry Pi OSBookworm 版本在高级设置里预填 Wi-Fi、开启 SSH、设置用户名。烧录完首次开机后如果国内网络拉包慢需要树莓派修改源把 apt 源换成国内镜像。# 备份原始源列表 sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak # 以清华源为例替换 Bookworm 源 sudo sed -i s|raspbian.raspberrypi.com|mirrors.tuna.tsinghua.edu.cn/raspbian|g /etc/apt/sources.list # 更新包索引 sudo apt update sudo apt upgrade -y # 安装 Python 基础依赖与 GPIO、摄像头库 sudo apt install -y python3-pip python3-venv python3-opencv python3-libcamera python3-picamera2 python3-rpi.gpio这套命令的逻辑是先备份再替换源保证可回滚apt upgrade更新内核态 CSI 驱动避免 libcamera 与旧内核不匹配python3-picamera2和python3-libcamera必须通过 apt 安装不能只用 pip否则底层 ISP 库链接会失败。OpenCV 用系统包python3-opencv而不是 pip 的opencv-python在 ARM 上能省下半小时编译时间。如果习惯在 PC 上写代码VSCode 配置 Python 环境时用 Remote-SSH 连到树莓派选择/usr/bin/python3解释器装 Pylance 和 Python 插件代码补全能直接识别 picamera2 的 API。树莓派 Ubuntu SSH 场景下同样适用但树莓派无屏幕安装 Ubuntu 时要注意camera_auto_detect1需写入 config.txt。提示安装完先跑libcamera-hello -t 0验证摄像头出图再写 Python能省掉一半排查时间。2.3 用 venv 隔离 Python 依赖系统包管基础库项目级依赖用 venv 隔离避免污染系统 Python。# 进入项目目录 mkdir -p ~/security cd ~/security # 创建虚拟环境必须带 --system-site-packages 才能用到 picamera2 python3 -m venv --system-site-packages venv source venv/bin/activate # 安装项目级依赖 pip install opencv-python-headless numpy requests参数说明--system-site-packages是重点让 venv 继承系统里的 picamera2 和 RPi.GPIO否则 import 会失败。opencv-python-headless不带 GUI 依赖适合无桌面系统。3. 基于 Python picamera2 的视频采集与运动检测实现3.1 picamera2 最小可运行采集脚本picamera2 是树莓派官方新一代摄像头库替代旧的 picamera。下面的最小脚本负责把画面持续抓成 numpy 数组供 OpenCV 做帧差。from picamera2 import Picamera2 import time # 初始化摄像头对象 picam2 Picamera2() # 配置主输出流1280x720YUYV 格式便于转灰度 config picam2.create_preview_configuration( main{size: (1280, 720), format: RGB888} ) picam2.configure(config) picam2.start() # 让自动曝光和白平衡稳定下来 time.sleep(2) try: while True: # 抓取一帧返回 numpy ndarray frame picam2.capture_array() print(frame shape:, frame.shape) time.sleep(0.2) except KeyboardInterrupt: picam2.stop()参数说明create_preview_configuration的size决定分辨率720p 在树莓派 4B 上帧差法能跑到 15fps 以上1080p 会明显掉帧。format选RGB888直接给 OpenCV 用选YUV420虽然省带宽但转换麻烦。time.sleep(2)必须加自动曝光收敛前的帧会偏亮帧差法会误判。3.2 帧差法做运动检测的核心参数帧差法逻辑简单相邻两帧做灰度绝对差二值化后看运动轮廓面积。import cv2 import numpy as np from picamera2 import Picamera2 picam2 Picamera2() picam2.configure(picam2.create_preview_configuration( main{size: (1280, 720), format: RGB888})) picam2.start() # 阈值像素差超过 25 才认为变化 THRESHOLD 25 # 最小运动轮廓面积滤掉噪点 MIN_AREA 1500 bg None while True: frame picam2.capture_array() gray cv2.cvtColor(frame, cv2.COLOR_RGB2GRAY) # 高斯模糊降噪核必须是奇数 gray cv2.GaussianBlur(gray, (21, 21), 0) if bg is None: bg gray continue # 计算绝对差并二值化 diff cv2.absdiff(bg, gray) _, thresh cv2.threshold(diff, THRESHOLD, 255, cv2.THRESH_BINARY) # 膨胀填补运动物体内部空洞 thresh cv2.dilate(thresh, None, iterations2) contours, _ cv2.findContours(thresh, cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_SIMPLE) for c in contours: if cv2.contourArea(c) MIN_AREA: continue x, y, w, h cv2.boundingRect(c) print(motion detected at, x, y, w, h) # 背景缓慢更新适应光照变化 bg cv2.addWeighted(bg, 0.95, gray, 0.05, 0)参数取舍THRESHOLD25是经验值光照剧烈变化的窗口要调到 40 以上否则窗帘飘动都会触发。MIN_AREA1500对应 720p 下约两个拳头大小调小会误报调大会漏掉远处人影。GaussianBlur的核 21 偏大适合 720p1080p 可以升到 31。背景用addWeighted做 0.95/0.05 的滑动平均是让系统适应白天到黄昏光照渐变的关键直接固定首帧做背景到中午必然全屏报警。注意树莓派 4B 单核跑这套逻辑在 720p 下 CPU 占用约 40%1080p 会飙到 80%没做散热会触发降频帧率掉到个位数。3.3 用视频流调试工具排查画面问题树莓派安装 luvcview 可以快速验证 USB 摄像头的画面完整性和色彩。CSI 摄像头则用libcamera-still -o test.jpg抓一张图看效果。如果画面出现绿色或紫色偏移多半是白平衡没收敛在 Python 里多等两秒即可。树莓派 OV5647 摄像头模块对红外补光敏感夜间如果换红外摄像头记得去掉镜头上的红外滤光片否则夜视全黑。4. PIR 与蜂鸣器联动GPIO 触发、异步告警与存证4.1 HC-SR501 接线与 GPIO 边沿检测HC-SR501 三根线VCC 接 5V模块内置稳压GND 接地OUT 接树莓派 GPIO17。检测到人体时 OUT 输出高电平持续约 2.5 秒可调延时电位器。import RPi.GPIO as GPIO import time PIR_PIN 17 GPIO.setmode(GPIO.BCM) # PIR 输出高电平有效配置下拉 GPIO.setup(PIR_PIN, GPIO.IN, pull_up_downGPIO.PUD_DOWN) def motion_callback(channel): # 边沿触发回调不要在这里做耗时操作 print(PIR triggered at, time.strftime(%H:%M:%S)) # 上升沿检测bounce 200ms 消抖 GPIO.add_event_detect(PIR_PIN, GPIO.RISING, callbackmotion_callback, bouncetime200) try: while True: time.sleep(1) except KeyboardInterrupt: GPIO.cleanup()参数说明bouncetime200消抖防止 PIR 输出毛刺重复触发。回调函数里只做标记不能直接截图或发邮件否则 GPIO 中断会阻塞后续触发全部丢失。正确做法是回调里置一个全局 flag主循环检测 flag 后再启动录制。HC-SR501 有两个电位器一个调灵敏度检测距离 3-7 米一个调延时0.3-200 秒。部署时灵敏度逆时针拧到底再慢慢回调延时拧到最小把「持续触发」逻辑交给 Python 处理避免硬件延时和软件逻辑打架。4.2 告警smtplib 发邮件与 requests 推送告警分两路邮件带截图附件Webhook 推送到手机端。邮件用 smtplib注意要开 SSL 并处理超时否则断网时脚本会卡死。import smtplib from email.mime.multipart import MIMEMultipart from email.mime.image import MIMEImage from email.mime.text import MIMEText import os def send_alert(image_path, sender, password, receiver): msg MIMEMultipart() msg[Subject] 安防告警检测到运动 msg[From] sender msg[To] receiver msg.attach(MIMEText(附件为触发时刻截图, plain)) # 以二进制读取截图并作为附件 if os.path.exists(image_path): with open(image_path, rb) as f: img MIMEImage(f.read()) img.add_header(Content-Disposition, attachment, filenameos.path.basename(image_path)) msg.attach(img) try: # 465 端口走 SSL超时设 10 秒防止卡死 with smtplib.SMTP_SSL(smtp.example.com, 465, timeout10) as s: s.login(sender, password) s.sendmail(sender, receiver, msg.as_string()) return True except Exception as e: # 失败落本地日志等待重试 print(send failed:, e) return False逻辑说明截图先落地到本地/home/pi/security/captures/再作为附件发送发失败也不丢数据。timeout10是必须的默认无超时遇上网络抖动会挂住主线程。授权码要走邮箱服务商申请不要用登录密码。Webhook 推送用requests.post一把梭超时设 5 秒失败同样写日志。4.3 触发到存证的完整流水线把前面几块拼起来主循环逻辑是阶段动作关键参数待机PIR 边沿检测bouncetime200ms触发置 flag启动录制录制时长 15s录制picamera2 抓帧帧差过滤THRESHOLD25判定连续 3 帧有运动才告警防误报存证写 mp4 截图保留 7 天告警邮件 Webhook 异步timeout10s录制用 picamera2 的start_recording直接输出 mp4比一帧帧写 OpenCV VideoWriter 省 CPU。连续 3 帧判定是为了防 PIR 误触发——猫走过、树叶晃动都会触发 PIR但帧差连续确认后误报率能降一个数量级。存证保留 7 天用find captures/ -mtime 7 -delete挂 cron 清理SD 卡写满会导致整个系统卡死。5. 服务化部署与运行调优systemd、日志与低频误报压制5.1 用 systemd 把脚本做成开机自启服务直接python3 main.py 跑在 SSH 会话里一断开就死。正确做法是写 systemd unit。# /etc/systemd/system/security.service [Unit] DescriptionPi Security System Afternetwork.target [Service] Typesimple Userpi WorkingDirectory/home/pi/security # 用 venv 里的 python 解释器 ExecStart/home/pi/security/venv/bin/python /home/pi/security/main.py Restartalways RestartSec5 # 日志走 journald StandardOutputjournal StandardErrorjournal [Install] WantedBymulti-user.target启用命令sudo systemctl daemon-reload sudo systemctl enable --now security.service。参数说明Restartalways让脚本崩溃后 5 秒自动重启无人值守必须开。Userpi保证 GPIO 和摄像头权限正常用 root 跑反而可能因环境变量缺失找不到库。日志用journalctl -u security -f实时看。如果服务起不来九成是权限问题把 pi 用户加进video和gpio组sudo usermod -aG video,gpio pi然后重启。树莓派 4b 的风扇针脚接的是 GPIO14物理引脚 8和 6与安防用的 GPIO17 不冲突但如果风扇 PWM 驱动用了 GPIO18注意别和 PIR 抢。5.2 误报压制的三个可调参数误报是安防系统部署后最耗精力的事。三个调优点第一PIR 延时调到最小用软件做持续帧判定硬件只负责唤醒。第二帧差阈值按时间段动态调整——白天 40夜间 25写个按time.localtime().tm_hour分支的函数即可。第三屏蔽区域在画面里用 numpy 切片把窗户、树影区域置零只保留门口和通道。# 屏蔽画面右侧 1/4 区域通常是窗外 def mask_region(frame): h, w frame.shape[:2] frame[:, int(w * 0.75):] 0 return frame这段要在转灰度之前做直接对原始帧操作。屏蔽区域靠部署后观察误报日志确定一般跑两三天就能定位到是哪块画面在捣乱。5.3 验证与回溯用日志反推误报原因调优后的验证靠日志。建议在告警时把触发帧的帧差图也存下来命名带时间戳。事后翻/home/pi/security/debug/如果误报帧的帧差图是一片散点噪声说明阈值太低如果是某个固定区域发亮就是该屏蔽。连续跑一周误报次数从每天十几次压到一两次系统才算可交付。树莓派 5 上如果想跑更复杂的检测可以本地部署轻量模型做二次确认但要注意功耗和散热别让板子长期跑在 80 度以上。本文还有配套的精品资源点击获取 树莓派Python智能安防：picamera2+OpenCV+PIR实战
简介面向树莓派与 Python 嵌入式开发及智能家居安防实践的 PDF 文档系统梳理了一套室内入侵报警与照片回传装置的设计思路适合物联网、电子信息和计算机相关专业学生、课程设计或毕业设计参考者以及希望快速了解传感器联动与远程控制流程的开发者。内容围绕硬件选型、软件编程与代码实现展开涉及红外传感器、蜂鸣器、迷你摄像头模块以及 GPIO 引脚定义、wxpy 微信接口、Picamera 摄像头调用等关键库的用法并给出人机对话触发报警的完整逻辑。压缩包内共 1 个 PDF 文件大小约 1.85MB属于单文件技术资料便于直接阅读和检索。目前已有 284 人学习下载可作为智能安防系统开发、人工智能与系统开发方向的参考文献和专业指导帮助读者理解从传感器采集、树莓派处理到移动端反馈的项目全貌也可为类似嵌入式安防方案提供模块扩展与代码调试思路。1. 从「装个摄像头」到可交付的树莓派 Python 智能安防系统很多人对树莓派安防项目的想象停留在「插上 OV5647 摄像头模块Python 调个 cv2.VideoCapture有人脸就报警」。真跑到现场部署问题全在链路后半段光照突变导致帧差法整屏泛白、PIR 触发与摄像头录制抢 CPU 导致丢帧、断网时告警邮件静默失败、systemd 拉起脚本后 GPIO 权限报 PermissionError。树莓派 Python 智能安防系统设计的核心不是检测算法本身而是把「传感器触发 — 视频采集 — 本地判定 — 异步告警 — 存证回溯」串成一条能在无人值守环境下稳定跑数周的流水线。树莓派 4B 或树莓派 5 搭配 CSI 接口的 OV5647、HC-SR501 人体红外模块、有源蜂鸣器配合 Python 的 picamera2、OpenCV、RPi.GPIO、smtplib就能覆盖家庭、小型仓库、办公位这类低功耗场景。这篇内容按实际部署顺序拆解硬件接线与系统准备、视频管线搭建、PIR 联动与运动检测、告警与存证、服务化与调优。2. 树莓派硬件选型与 Python 运行环境准备2.1 树莓派 4B / 5 与 OV5647 摄像头模块的搭配逻辑选型上树莓派 4B2GB 起步和树莓派 5 是最常见的两块板子。4B 的 CSI 接口走的是传统 pipeline对 OV5647500 万像素原生 1080p30fps支持成熟配 5V/3A 电源即可。树莓派 5 的 CSI 带宽更高能上双摄像头但功耗和散热要求更严需要官方 27W USB-C PD 电源和主动散热。硬件项推荐型号关键参数说明主控板树莓派 4B四核 A72 1.5GHz / 2-4GB功耗低CSI 驱动稳定主控板备选树莓派 5四核 A76 2.4GHz / 4-8GB支持双 CSI需主动散热摄像头OV56471080p30fps / CSI性价比高libcamera 已适配人体红外HC-SR5013.3V / 检测 7m输出数字高电平触发蜂鸣器有源 3.3VGPIO 直驱有源接 GPIO 即响存储Class10 A1 microSD≥32GB写入速度影响录像落盘摄像头排线要注意方向OV5647 排线金手指朝向 HDMI 口那一侧插反了libcamera-hello会直接报no cameras available。这是新手最常见的硬件坑。2.2 树莓派烧录、修改源与 Python 环境配置树莓派烧录推荐用 Raspberry Pi Imager 写入 64 位 Raspberry Pi OSBookworm 版本在高级设置里预填 Wi-Fi、开启 SSH、设置用户名。烧录完首次开机后如果国内网络拉包慢需要树莓派修改源把 apt 源换成国内镜像。# 备份原始源列表 sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak # 以清华源为例替换 Bookworm 源 sudo sed -i s|raspbian.raspberrypi.com|mirrors.tuna.tsinghua.edu.cn/raspbian|g /etc/apt/sources.list # 更新包索引 sudo apt update sudo apt upgrade -y # 安装 Python 基础依赖与 GPIO、摄像头库 sudo apt install -y python3-pip python3-venv python3-opencv python3-libcamera python3-picamera2 python3-rpi.gpio这套命令的逻辑是先备份再替换源保证可回滚apt upgrade更新内核态 CSI 驱动避免 libcamera 与旧内核不匹配python3-picamera2和python3-libcamera必须通过 apt 安装不能只用 pip否则底层 ISP 库链接会失败。OpenCV 用系统包python3-opencv而不是 pip 的opencv-python在 ARM 上能省下半小时编译时间。如果习惯在 PC 上写代码VSCode 配置 Python 环境时用 Remote-SSH 连到树莓派选择/usr/bin/python3解释器装 Pylance 和 Python 插件代码补全能直接识别 picamera2 的 API。树莓派 Ubuntu SSH 场景下同样适用但树莓派无屏幕安装 Ubuntu 时要注意camera_auto_detect1需写入 config.txt。提示安装完先跑libcamera-hello -t 0验证摄像头出图再写 Python能省掉一半排查时间。2.3 用 venv 隔离 Python 依赖系统包管基础库项目级依赖用 venv 隔离避免污染系统 Python。# 进入项目目录 mkdir -p ~/security cd ~/security # 创建虚拟环境必须带 --system-site-packages 才能用到 picamera2 python3 -m venv --system-site-packages venv source venv/bin/activate # 安装项目级依赖 pip install opencv-python-headless numpy requests参数说明--system-site-packages是重点让 venv 继承系统里的 picamera2 和 RPi.GPIO否则 import 会失败。opencv-python-headless不带 GUI 依赖适合无桌面系统。3. 基于 Python picamera2 的视频采集与运动检测实现3.1 picamera2 最小可运行采集脚本picamera2 是树莓派官方新一代摄像头库替代旧的 picamera。下面的最小脚本负责把画面持续抓成 numpy 数组供 OpenCV 做帧差。from picamera2 import Picamera2 import time # 初始化摄像头对象 picam2 Picamera2() # 配置主输出流1280x720YUYV 格式便于转灰度 config picam2.create_preview_configuration( main{size: (1280, 720), format: RGB888} ) picam2.configure(config) picam2.start() # 让自动曝光和白平衡稳定下来 time.sleep(2) try: while True: # 抓取一帧返回 numpy ndarray frame picam2.capture_array() print(frame shape:, frame.shape) time.sleep(0.2) except KeyboardInterrupt: picam2.stop()参数说明create_preview_configuration的size决定分辨率720p 在树莓派 4B 上帧差法能跑到 15fps 以上1080p 会明显掉帧。format选RGB888直接给 OpenCV 用选YUV420虽然省带宽但转换麻烦。time.sleep(2)必须加自动曝光收敛前的帧会偏亮帧差法会误判。3.2 帧差法做运动检测的核心参数帧差法逻辑简单相邻两帧做灰度绝对差二值化后看运动轮廓面积。import cv2 import numpy as np from picamera2 import Picamera2 picam2 Picamera2() picam2.configure(picam2.create_preview_configuration( main{size: (1280, 720), format: RGB888})) picam2.start() # 阈值像素差超过 25 才认为变化 THRESHOLD 25 # 最小运动轮廓面积滤掉噪点 MIN_AREA 1500 bg None while True: frame picam2.capture_array() gray cv2.cvtColor(frame, cv2.COLOR_RGB2GRAY) # 高斯模糊降噪核必须是奇数 gray cv2.GaussianBlur(gray, (21, 21), 0) if bg is None: bg gray continue # 计算绝对差并二值化 diff cv2.absdiff(bg, gray) _, thresh cv2.threshold(diff, THRESHOLD, 255, cv2.THRESH_BINARY) # 膨胀填补运动物体内部空洞 thresh cv2.dilate(thresh, None, iterations2) contours, _ cv2.findContours(thresh, cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_SIMPLE) for c in contours: if cv2.contourArea(c) MIN_AREA: continue x, y, w, h cv2.boundingRect(c) print(motion detected at, x, y, w, h) # 背景缓慢更新适应光照变化 bg cv2.addWeighted(bg, 0.95, gray, 0.05, 0)参数取舍THRESHOLD25是经验值光照剧烈变化的窗口要调到 40 以上否则窗帘飘动都会触发。MIN_AREA1500对应 720p 下约两个拳头大小调小会误报调大会漏掉远处人影。GaussianBlur的核 21 偏大适合 720p1080p 可以升到 31。背景用addWeighted做 0.95/0.05 的滑动平均是让系统适应白天到黄昏光照渐变的关键直接固定首帧做背景到中午必然全屏报警。注意树莓派 4B 单核跑这套逻辑在 720p 下 CPU 占用约 40%1080p 会飙到 80%没做散热会触发降频帧率掉到个位数。3.3 用视频流调试工具排查画面问题树莓派安装 luvcview 可以快速验证 USB 摄像头的画面完整性和色彩。CSI 摄像头则用libcamera-still -o test.jpg抓一张图看效果。如果画面出现绿色或紫色偏移多半是白平衡没收敛在 Python 里多等两秒即可。树莓派 OV5647 摄像头模块对红外补光敏感夜间如果换红外摄像头记得去掉镜头上的红外滤光片否则夜视全黑。4. PIR 与蜂鸣器联动GPIO 触发、异步告警与存证4.1 HC-SR501 接线与 GPIO 边沿检测HC-SR501 三根线VCC 接 5V模块内置稳压GND 接地OUT 接树莓派 GPIO17。检测到人体时 OUT 输出高电平持续约 2.5 秒可调延时电位器。import RPi.GPIO as GPIO import time PIR_PIN 17 GPIO.setmode(GPIO.BCM) # PIR 输出高电平有效配置下拉 GPIO.setup(PIR_PIN, GPIO.IN, pull_up_downGPIO.PUD_DOWN) def motion_callback(channel): # 边沿触发回调不要在这里做耗时操作 print(PIR triggered at, time.strftime(%H:%M:%S)) # 上升沿检测bounce 200ms 消抖 GPIO.add_event_detect(PIR_PIN, GPIO.RISING, callbackmotion_callback, bouncetime200) try: while True: time.sleep(1) except KeyboardInterrupt: GPIO.cleanup()参数说明bouncetime200消抖防止 PIR 输出毛刺重复触发。回调函数里只做标记不能直接截图或发邮件否则 GPIO 中断会阻塞后续触发全部丢失。正确做法是回调里置一个全局 flag主循环检测 flag 后再启动录制。HC-SR501 有两个电位器一个调灵敏度检测距离 3-7 米一个调延时0.3-200 秒。部署时灵敏度逆时针拧到底再慢慢回调延时拧到最小把「持续触发」逻辑交给 Python 处理避免硬件延时和软件逻辑打架。4.2 告警smtplib 发邮件与 requests 推送告警分两路邮件带截图附件Webhook 推送到手机端。邮件用 smtplib注意要开 SSL 并处理超时否则断网时脚本会卡死。import smtplib from email.mime.multipart import MIMEMultipart from email.mime.image import MIMEImage from email.mime.text import MIMEText import os def send_alert(image_path, sender, password, receiver): msg MIMEMultipart() msg[Subject] 安防告警检测到运动 msg[From] sender msg[To] receiver msg.attach(MIMEText(附件为触发时刻截图, plain)) # 以二进制读取截图并作为附件 if os.path.exists(image_path): with open(image_path, rb) as f: img MIMEImage(f.read()) img.add_header(Content-Disposition, attachment, filenameos.path.basename(image_path)) msg.attach(img) try: # 465 端口走 SSL超时设 10 秒防止卡死 with smtplib.SMTP_SSL(smtp.example.com, 465, timeout10) as s: s.login(sender, password) s.sendmail(sender, receiver, msg.as_string()) return True except Exception as e: # 失败落本地日志等待重试 print(send failed:, e) return False逻辑说明截图先落地到本地/home/pi/security/captures/再作为附件发送发失败也不丢数据。timeout10是必须的默认无超时遇上网络抖动会挂住主线程。授权码要走邮箱服务商申请不要用登录密码。Webhook 推送用requests.post一把梭超时设 5 秒失败同样写日志。4.3 触发到存证的完整流水线把前面几块拼起来主循环逻辑是阶段动作关键参数待机PIR 边沿检测bouncetime200ms触发置 flag启动录制录制时长 15s录制picamera2 抓帧帧差过滤THRESHOLD25判定连续 3 帧有运动才告警防误报存证写 mp4 截图保留 7 天告警邮件 Webhook 异步timeout10s录制用 picamera2 的start_recording直接输出 mp4比一帧帧写 OpenCV VideoWriter 省 CPU。连续 3 帧判定是为了防 PIR 误触发——猫走过、树叶晃动都会触发 PIR但帧差连续确认后误报率能降一个数量级。存证保留 7 天用find captures/ -mtime 7 -delete挂 cron 清理SD 卡写满会导致整个系统卡死。5. 服务化部署与运行调优systemd、日志与低频误报压制5.1 用 systemd 把脚本做成开机自启服务直接python3 main.py 跑在 SSH 会话里一断开就死。正确做法是写 systemd unit。# /etc/systemd/system/security.service [Unit] DescriptionPi Security System Afternetwork.target [Service] Typesimple Userpi WorkingDirectory/home/pi/security # 用 venv 里的 python 解释器 ExecStart/home/pi/security/venv/bin/python /home/pi/security/main.py Restartalways RestartSec5 # 日志走 journald StandardOutputjournal StandardErrorjournal [Install] WantedBymulti-user.target启用命令sudo systemctl daemon-reload sudo systemctl enable --now security.service。参数说明Restartalways让脚本崩溃后 5 秒自动重启无人值守必须开。Userpi保证 GPIO 和摄像头权限正常用 root 跑反而可能因环境变量缺失找不到库。日志用journalctl -u security -f实时看。如果服务起不来九成是权限问题把 pi 用户加进video和gpio组sudo usermod -aG video,gpio pi然后重启。树莓派 4b 的风扇针脚接的是 GPIO14物理引脚 8和 6与安防用的 GPIO17 不冲突但如果风扇 PWM 驱动用了 GPIO18注意别和 PIR 抢。5.2 误报压制的三个可调参数误报是安防系统部署后最耗精力的事。三个调优点第一PIR 延时调到最小用软件做持续帧判定硬件只负责唤醒。第二帧差阈值按时间段动态调整——白天 40夜间 25写个按time.localtime().tm_hour分支的函数即可。第三屏蔽区域在画面里用 numpy 切片把窗户、树影区域置零只保留门口和通道。# 屏蔽画面右侧 1/4 区域通常是窗外 def mask_region(frame): h, w frame.shape[:2] frame[:, int(w * 0.75):] 0 return frame这段要在转灰度之前做直接对原始帧操作。屏蔽区域靠部署后观察误报日志确定一般跑两三天就能定位到是哪块画面在捣乱。5.3 验证与回溯用日志反推误报原因调优后的验证靠日志。建议在告警时把触发帧的帧差图也存下来命名带时间戳。事后翻/home/pi/security/debug/如果误报帧的帧差图是一片散点噪声说明阈值太低如果是某个固定区域发亮就是该屏蔽。连续跑一周误报次数从每天十几次压到一两次系统才算可交付。树莓派 5 上如果想跑更复杂的检测可以本地部署轻量模型做二次确认但要注意功耗和散热别让板子长期跑在 80 度以上。本文还有配套的精品资源点击获取