4、系统配置：启用Camera接口、更新系统、安装必要软件包（如raspistill、libcamera、fswebcam）

在树莓派上使用摄像头之前，必须完成系统层面的初始化配置。这一阶段的目标是让操作系统正确识别摄像头硬件、加载对应的内核驱动，并安装用户态工具软件，以便后续进行图像采集、预览和调试。很多初学者在拿到摄像头模块后直接插入并运行命令，却得到“No camera detected”或“libcamera error”的提示，根源往往在于系统未启用Camera接口、固件过旧或软件包缺失。本章将系统讲解从硬件接口启用、系统更新到软件安装的完整流程，并针对CSI相机与USB相机给出差异化的配置方案。

上图展示了树莓派摄像头系统配置的完整链路：从硬件接口启用开始，依次经过系统更新、软件包安装，最终进入验证测试阶段。其中CSI相机与USB相机在工具链选择上存在明显分支，但最终都汇聚到V4L2（Video4Linux2）这一内核视频子系统。下面将按照实际操作顺序，逐步展开每个环节的具体方法与注意事项。

4.1 启用Camera接口：raspi-config与config.txt的底层逻辑

核心原理：树莓派的CSI（Camera Serial Interface）摄像头并非即插即用设备，其驱动默认处于禁用状态。系统通过/boot/config.txt中的设备树（Device Tree）参数决定是否加载摄像头驱动模块。raspi-config工具本质上是对config.txt的封装，它会在文件末尾追加或修改start_x、gpu_mem等关键参数。对于树莓派Zero、1代和2代，还需要额外设置camera_auto_detect=0并手动指定dtoverlay；而树莓派3代及以后版本，默认使用libcamera框架，camera_auto_detect=1即可自动识别官方摄像头。

操作流程：

1. 运行sudo raspi-config，进入“Interface Options”菜单。
2. 选择“Camera”或“I2C”相关选项（不同系统版本名称略有差异），回车后选择“Yes”启用。
3. 退出raspi-config，系统提示重启时选择“Yes”或手动执行sudo reboot。
4. 重启后检查/boot/config.txt，确认包含start_x=1（旧版）或camera_auto_detect=1（新版）。

对于手动配置场景，可以直接编辑config.txt：

# 树莓派3B+及以前版本（使用raspistill）
start_x=1
gpu_mem=128

# 树莓派4B/5及以后版本（使用libcamera）
camera_auto_detect=1
dtoverlay=imx219  # 如果自动检测失败，可手动指定传感器型号

案例拆解：某用户使用树莓派4B搭配IMX219（官方V2摄像头），运行libcamera-hello时提示“No cameras available”。检查发现config.txt中camera_auto_detect=1已设置，但dmesg输出显示“Camera sensor not detected”。进一步排查发现CSI排线插反——蓝色标签面应朝向HDMI接口方向。重新插拔后问题解决。这个案例说明，硬件连接错误往往比软件配置更容易被忽视。

4.2 系统更新与固件升级：确保驱动兼容性

核心原理：树莓派操作系统（Raspberry Pi OS）的软件源中包含了摄像头驱动、libcamera框架和用户态工具。定期更新系统可以获取最新的内核模块、固件补丁和传感器驱动。特别是对于树莓派5，其使用RP1芯片管理外设，必须更新到2023年10月之后的系统版本才能完整支持摄像头功能。此外，EEPROM（电可擦除只读存储器）固件控制着启动流程和PCIe/CSI接口的初始化，更新EEPROM可以修复摄像头探测的底层问题。

操作流程：

# 1. 更新软件源列表
sudo apt update

# 2. 升级所有已安装软件包（包括内核和固件）
sudo apt full-upgrade -y

# 3. 更新树莓派EEPROM固件（可选但推荐）
sudo rpi-eeprom-update -a
sudo reboot

更新完成后，可以通过uname -a查看内核版本，通过vcgencmd version查看固件版本。对于摄像头调试，建议内核版本不低于6.1，libcamera版本不低于0.1.0。

4.3 安装必要软件包：raspistill、libcamera与fswebcam的取舍

核心原理：树莓派摄像头软件栈分为三个层次：底层是内核V4L2驱动，中间是libcamera框架（负责ISP图像信号处理），上层是应用工具。raspistill是Broadcom私有API的旧版工具，基于MMAL（多媒体抽象层），在树莓派4B及以前版本上性能优秀，但在树莓派5上已不再支持。libcamera是新一代开源框架，支持树莓派5的RP1芯片，并提供了libcamera-hello、libcamera-still等命令行工具。fswebcam则是一个通用的Linux USB摄像头采集工具，不依赖树莓派专用驱动，适用于UVC（USB Video Class）协议的USB相机。

安装命令：

# 安装libcamera工具集（树莓派OS默认已安装）
sudo apt install -y libcamera-apps libcamera-dev

# 安装raspistill（仅适用于旧版系统或需要兼容旧脚本）
sudo apt install -y raspi-gpio  # 依赖项
# 在Bookworm系统中，需要启用legacy camera支持
sudo raspi-config nonint do_camera 0
sudo apt install -y raspistill

# 安装fswebcam（USB相机通用工具）
sudo apt install -y fswebcam

# 安装Python库（用于后续编程）
sudo apt install -y python3-picamera2 python3-opencv

工具对比：

4.4 验证配置：从命令行到图形界面的完整测试

判断方法：配置完成后，需要通过一系列命令验证摄像头是否被正确识别。最直接的命令是vcgencmd get_camera，它会返回supported和detected两个状态值。对于libcamera框架，使用libcamera-hello可以启动实时预览窗口；对于USB相机，使用lsusb查看设备列表，使用v4l2-ctl --list-devices查看视频设备节点。

验证流程：

# 1. 检查CSI摄像头状态
vcgencmd get_camera
# 预期输出：supported=1 detected=1

# 2. 检查USB摄像头设备节点
lsusb | grep -i camera
ls /dev/video*

# 3. 测试libcamera（CSI相机）
libcamera-hello -t 0  # 持续显示预览

# 4. 测试fswebcam（USB相机）
fswebcam -r 1280x720 --no-banner test.jpg

# 5. 查看内核日志（排查硬件问题）
dmesg | grep -i camera

案例拆解：某项目需要同时使用CSI相机（用于近距离识别）和USB相机（用于广角监控）。系统为树莓派4B，Bookworm系统。配置过程中遇到两个问题：第一，CSI相机在libcamera-hello下正常，但fswebcam无法打开/dev/video0；第二，USB相机在lsusb中可见，但v4l2-ctl显示“Cannot open device”。分析发现，CSI相机占用了video0节点，USB相机被分配到video1，但fswebcam默认打开video0。解决方法是显式指定设备节点：fswebcam -d /dev/video1 test.jpg。同时，USB相机需要加载uvcvideo内核模块，通过sudo modprobe uvcvideo解决。这个案例说明，多相机场景下必须明确设备节点的映射关系，不能依赖默认设置。

总结复盘：系统配置是摄像头调试的基础工程，其核心在于理解硬件接口、内核驱动、用户态工具三者之间的依赖关系。本章的关键操作可以归纳为：启用接口（raspi-config）→ 更新系统（apt）→ 安装工具（libcamera/fswebcam）→ 验证状态（vcgencmd/v4l2-ctl）。在实际项目中，建议将配置过程固化为脚本，便于在多台设备上快速部署。同时，务必记录每台设备的硬件型号和系统版本，因为不同组合下的配置参数可能存在差异。最后，不要忽视电源问题——摄像头模块对电压波动敏感，建议使用5V/3A的官方电源适配器，避免因供电不足导致图像闪烁或设备掉线。