📚 课程目录第2章 Raspberry Pi基础

2、Raspberry Pi基础：树莓派型号选择、系统安装（Raspberry Pi OS）、SSH远程连接、GPIO引脚与摄像头接口介绍

树莓派（Raspberry Pi）是当前边缘计算与嵌入式AI项目中最常用的单板计算机之一。在人脸识别门禁项目中，树莓派承担着图像采集、人脸比对、继电器控制与网络通信等多重任务。本章将围绕型号选型、系统部署、远程管理、GPIO控制与摄像头接口五个核心模块展开，帮助学习者建立从硬件到系统的完整认知框架。需要特别强调的是，人脸识别项目对计算性能、内存容量、摄像头接口类型和GPIO驱动能力都有明确要求，选型错误往往会导致后期开发陷入被动。

上图展示了人脸识别门禁系统中树莓派的核心硬件链路：CSI摄像头负责采集人脸图像，GPIO引脚输出控制信号驱动继电器与电磁锁，网络模块提供SSH远程管理与数据上传通道。在实际部署中，还需要考虑电源容量、散热条件、外壳防护等工程细节，这些将在后续章节逐步展开。

2.1 树莓派型号选择：性能与接口的权衡

树莓派家族目前主流在售型号包括Raspberry Pi 5、Raspberry Pi 4B、Raspberry Pi 3B+以及Zero 2W。对于人脸识别门禁项目，选型需要从计算能力、内存容量、摄像头接口、GPIO兼容性、功耗与散热五个维度综合评估。

型号	CPU	内存	摄像头接口	GPIO	推荐场景
Pi 5 (8GB)	BCM2712 四核A76 2.4GHz	4/8GB LPDDR4X	2×CSI（支持双摄）	40-pin，兼容	多人脸实时识别、深度学习模型
Pi 4B (4GB)	BCM2711 四核A72 1.8GHz	2/4/8GB	2×CSI（micro）	40-pin，兼容	单人脸识别、OpenCV+Dlib
Pi 3B+	BCM2837B0 四核A53 1.4GHz	1GB	1×CSI	40-pin，兼容	轻量人脸检测（Haar）
Zero 2W	BCM2710A1 四核A53 1GHz	512MB	1×CSI（mini）	40-pin（需焊接）	原型验证、低功耗场景

从项目实战角度出发，Raspberry Pi 4B 4GB版本是当前性价比最高的选择。其四核A72处理器在运行OpenCV人脸检测与FaceNet特征提取时，帧率可达8-12FPS，配合优化后的推理引擎可以满足门禁场景的实时性要求。Pi 5虽然性能提升明显，但发热量更大，需要主动散热风扇，且部分旧款摄像头排线需要转接，增加了部署复杂度。Zero 2W虽然体积小巧，但内存仅512MB，运行人脸识别模型时极易触发OOM（内存溢出），不建议用于生产环境。

选型风险提示：部分低价“树莓派”实为国产兼容板（如Orange Pi、Banana Pi），其GPIO引脚定义、摄像头接口协议与树莓派官方板存在差异，可能导致驱动不兼容或烧毁外设。建议优先选择官方渠道或授权代理商购买正品，并核对板载芯片丝印（BCM2711/BCM2712）与PCB版本号。

2.2 Raspberry Pi OS系统安装：从镜像烧录到首次启动

Raspberry Pi OS（原Raspbian）是基于Debian的官方操作系统，提供32位与64位两种版本。对于人脸识别项目，强烈建议安装64位版本，因为多数现代AI库（如TensorFlow Lite、ONNX Runtime）对64位架构支持更完善，且能充分利用4GB以上内存。

系统安装的标准流程如下：

准备硬件：16GB以上MicroSD卡（推荐Class 10/A1速度等级）、读卡器、5V/3A USB-C电源（Pi 4B/5）。
下载镜像：访问树莓派官网（raspberrypi.com/software），下载Raspberry Pi Imager工具及Raspberry Pi OS 64位镜像。
烧录镜像：运行Imager，选择“Raspberry Pi OS (64-bit)”→ 选择SD卡 → 点击“写入”。烧录过程中可点击齿轮图标预配置SSH、Wi-Fi和用户名密码。
首次启动：将SD卡插入树莓派，连接HDMI显示器、键盘鼠标，接通电源。系统会自动扩展文件系统并进入桌面环境。
系统更新：打开终端执行 sudo apt update && sudo apt upgrade -y，确保内核与驱动为最新版本。

无头模式（Headless）安装技巧：如果手头没有HDMI显示器，可以在烧录完成后直接编辑SD卡根目录下的 config.txt 文件，在末尾添加 dtoverlay=disable-bt 和 dtoverlay=disable-wifi（可选），同时新建一个名为 ssh 的空文件（无扩展名）以启用SSH。再在根目录创建 userconf.txt，内容格式为 用户名:加密密码（密码需用openssl生成）。这样上电后即可通过网络SSH连接。

安装完成后，建议立即执行 sudo raspi-config 进行基础配置：扩展文件系统、设置时区（Asia/Shanghai）、启用CSI摄像头接口（Interface Options → Camera）、分配GPU内存（建议128MB以上）。GPU内存大小直接影响摄像头图像处理性能，过小会导致OpenCV读取图像失败。

2.3 SSH远程连接：摆脱显示器的开发模式

在实际项目中，树莓派通常部署在门禁机柜或天花板吊顶内，没有条件连接显示器。SSH（Secure Shell）成为远程管理的主要手段。SSH连接需要三个要素：树莓派IP地址、用户名、密码或密钥。

建立SSH连接的完整流程：

获取IP地址：在路由器管理界面查看树莓派主机名对应的IP，或使用 nmap -sn 192.168.1.0/24 扫描局域网设备。
Windows连接：使用PowerShell或CMD执行 ssh pi@192.168.1.100，首次连接会提示确认指纹，输入yes后输入密码。
macOS/Linux连接：终端执行 ssh pi@192.168.1.100，同样输入密码。
密钥免密登录（推荐）：在本地生成密钥对 ssh-keygen -t ed25519，然后将公钥复制到树莓派 ssh-copy-id pi@192.168.1.100，之后即可免密登录。

为了提升开发效率，建议使用VS Code的Remote-SSH插件，直接在本地编辑树莓派上的代码文件，并集成终端调试。同时，配置 ~/.ssh/config 文件可以为树莓派设置别名，例如：

Host rpi
    HostName 192.168.1.100
    User pi
    Port 22
    IdentityFile ~/.ssh/id_ed25519

配置完成后，只需执行 ssh rpi 即可快速连接。对于跨网段远程管理，可以使用frp或Tailscale等内网穿透工具，但需注意安全策略，避免暴露SSH端口到公网。

排障经验：SSH连接失败时，首先检查树莓派与电脑是否在同一网段（ping 测试），其次确认SSH服务已启用（systemctl status ssh），最后检查防火墙规则（sudo ufw status）。若使用预配置镜像，注意Imager中设置的默认用户名可能不是 pi，需以实际配置为准。

2.4 GPIO引脚与摄像头接口：硬件控制核心

树莓派40-pin GPIO排针是连接外部设备的关键接口。在人脸识别门禁项目中，GPIO主要用于控制继电器（电磁锁）、读取门磁传感器状态、驱动LED指示灯。GPIO引脚分为三类：电源引脚（3.3V/5V/GND）、通用输入输出引脚（GPIO 0-27）、专用功能引脚（I2C、SPI、UART）。

GPIO控制的核心原理是：通过写入高电平（3.3V）或低电平（0V）来控制外部电路的通断。但GPIO输出电流有限（最大约16mA），不能直接驱动电磁锁（通常需要12V/1A），必须通过继电器或MOSFET进行功率放大。典型接线方案如下：

树莓派 GPIO17 (Pin 11) → 继电器IN+  → 继电器COM → 12V电源正极
树莓派 GND (Pin 6)      → 继电器IN-  → 继电器NO  → 电磁锁正极
树莓派 5V (Pin 2)       → 继电器VCC  → 电磁锁负极 → 12V电源负极

摄像头接口方面，树莓派使用CSI（Camera Serial Interface）标准，Pi 4B采用15-pin mini CSI接口，Pi 5采用22-pin接口。官方推荐的摄像头模块包括Camera Module 3（IMX708，支持自动对焦）和Camera Module 2（IMX219，800万像素）。连接时需注意排线方向：金属触点朝向HDMI接口一侧，插入后按压卡扣固定。

GPIO引脚号	BCM编号	功能	门禁项目用途
Pin 2	-	5V电源	继电器供电
Pin 6	-	GND	公共地
Pin 11	GPIO17	通用输出	继电器控制信号
Pin 13	GPIO27	通用输入	门磁状态检测
Pin 15	GPIO22	通用输出	绿色LED指示灯

在Python中控制GPIO推荐使用 gpiozero 库，它提供了简洁的面向对象接口。例如控制继电器吸合1秒：

from gpiozero import OutputDevice
import time

relay = OutputDevice(17, active_high=True, initial_value=False)
relay.on()      # 继电器吸合，电磁锁开锁
time.sleep(1)
relay.off()     # 继电器释放，电磁锁闭锁

摄像头图像采集则使用 picamera2 库（Pi OS 11及以上版本），它替代了旧版的 picamera。初始化摄像头并捕获一帧图像：

from picamera2 import Picamera2
import cv2

picam2 = Picamera2()
config = picam2.create_still_configuration(main={"size": (1280, 720)})
picam2.configure(config)
picam2.start()
frame = picam2.capture_array()
cv2.imwrite("test.jpg", frame)
picam2.stop()

硬件安全警告：GPIO引脚严禁直接连接12V或24V电源，否则会烧毁树莓派SoC。所有外部负载必须通过光耦隔离或继电器隔离。此外，CSI排线非常脆弱，插拔时务必断开电源，避免弯折排线导致内部线路断裂。若摄像头无法识别，执行 dmesg | grep -i camera 查看内核日志，确认驱动是否加载成功。

2.5 实战案例：从零搭建无头模式人脸识别门禁原型

本案例将综合运用本章知识，搭建一个最小可用的门禁原型系统。项目背景：某小型工作室需要在办公室入口安装人脸识别门禁，要求本地化处理、无需公网依赖，且支持远程维护。

硬件清单：Raspberry Pi 4B 4GB、Camera Module 3、5V/3A电源、5V继电器模块、12V电磁锁、12V电源适配器、亚克力外壳。

实施步骤：

系统部署：使用Imager烧录64位Raspberry Pi OS，预配置SSH、Wi-Fi（SSID: OfficeNet）和用户 admin。
硬件连接：将摄像头排线插入CSI接口，继电器IN+接GPIO17，IN-接GND，VCC接5V，电磁锁通过继电器常开触点接入12V回路。
远程配置：上电后通过SSH连接，执行 sudo raspi-config 启用CSI接口，设置GPU内存为256MB。
驱动验证：运行 libcamera-hello --list-cameras 确认摄像头识别，执行 python3 -c "from gpiozero import OutputDevice; OutputDevice(17).blink(1,1,3)" 观察继电器通断。
基础测试：编写Python脚本，实现“检测到人脸→继电器吸合2秒→自动复位”的流程，使用OpenCV的Haar级联检测器进行初步验证。

测试结果：在室内光照充足条件下，摄像头采集帧率稳定在30FPS，人脸检测耗时约80ms/帧，继电器响应延迟小于10ms。电磁锁吸合顺畅，无卡顿现象。

风险与复盘：测试过程中发现继电器模块在吸合瞬间会产生电磁干扰，导致摄像头画面出现横纹。解决方案是在继电器线圈两端并联1N4007续流二极管，并将信号线与电源线分开布线。此外，由于门禁系统需要7×24小时运行，建议在 /etc/rc.local 中添加开机自启脚本，并启用看门狗（sudo apt install watchdog）防止系统死机。

通过本案例可以看出，树莓派基础配置的规范性直接影响后续AI功能的稳定性。建议开发者在正式部署前，先完成硬件连通性测试、系统压力测试（stress --cpu 4 --timeout 60）和长时间运行测试（至少24小时），确保系统在真实场景下可靠运行。