企业官网建设流程全解析

1. 引言

树莓派4B凭借强大的性能和丰富的接口，成为众多创客和开发者手中的利器。然而，当系统升级到最新的 Raspberry Pi OS（基于 Debian 12 Bookworm）后，不少用户发现原本熟悉的摄像头配置方式发生了巨大变化，导致摄像头无法正常使用。本文将系统梳理在最新系统下摄像头部署的常见问题与解决方案，帮助你快速恢复摄像头功能。

2. 问题背景：为什么摄像头突然“失灵”了

在旧版系统（基于 Debian 11 Bullseye 及更早版本）中，树莓派摄像头主要通过raspi-config工具启用，并依赖raspivid、raspistill等命令行工具进行拍摄。但在最新的 Bookworm 系统中，树莓派官方对摄像头框架进行了重大调整，引入了基于libcamera的新架构，同时废弃了部分旧工具，导致许多用户升级后摄像头无法识别或无法调用。

具体来说，主要变化包括：

• 驱动框架迁移：从传统的V4L2用户空间驱动转向libcamera框架。
• 工具链更新：raspivid和raspistill被libcamera-hello、libcamera-still等新工具取代。
• 配置方式改变：raspi-config中的摄像头选项被重新设计，部分旧配置项不再生效。

3. 硬件连接与基础检查

在深入软件配置之前，请先确认硬件连接是否正确，这是排查问题的第一步。

确定好使用的摄像头

在这里，本人推荐大家使用USB接口的摄像头，区别于树莓派原装的CSI接口的摄像头有三点优势：

1、在新系统中，我们不需要再从树莓派的设置页面专门去打开摄像头失能，新系统是默认摄像头端口失能的，我们直接插上就可以使用；

2、相比于CSI摄像头，USB摄像头的像素明显更好，并且CSI摄像头距离是固定的，USB摄像头的数据线是可伸缩的，距离可以调节。

3、从价格方面来看，CSI摄像头十块钱以内，而USB摄像头二三十块钱，大家可以根据自身情况和使用要求来决定购买哪一种摄像头。

4. 系统配置：启用摄像头接口

在最新系统下，启用摄像头的步骤与旧版略有不同，但整体流程依然清晰。

（在这里启动是为了以防万一，从根源上排除问题，这样在摄像头还不能使用时给大家一个排除问题的思考方向）

4.1 使用 raspi-config 启用（从2024版本后的系统不需要进行此操作）

打开终端，输入以下命令进入配置界面：

sudo raspi-config

依次选择：

1. Interface Options
2. Camera（或I2C，视系统版本而定）
3. 选择Yes启用摄像头

启用后系统会提示重启，重启后摄像头接口即被激活。

4.2 检查设备树配置（这一项配置大家都可以进行一下检查）

在 Bookworm 系统中，摄像头驱动通过设备树（Device Tree）加载。可以通过以下命令检查摄像头是否被系统识别：

vcgencmd get_camera

如果输出supported=1 detected=1，说明摄像头已被正确识别。若detected=0，则可能存在硬件连接或驱动加载问题。

4.3 问题复查

原文链接：https://blog.csdn.net/m0_74107966/article/details/140277820

如果输出supported=0 detected=1，说明摄像头已被正确识别，但是内部配置还是存在问题。

输入：sudo nano /boot/firmware/config.txt

在文件最后加上如下命令：加在最后【all】

gpu_mem=128
start_x=1
注释掉原来的摄像头自动检测语句（第17行）

#camera_auto_detect=1

Ctrl+o 写入 Ctrl+x 退出

2.修改/etc/modules
输入

sudo nano /etc/modules
在最后面添加如下命令

bcm2835-v4l2
Ctrl+o 写入 Ctrl+x 退出

保存后，重启系统！！！

重复4.2操作内容，得到supported=1 detected=1，说明摄像头可以正常工作了。

5. 驱动安装与更新

最新系统通常已内置 libcamera 相关驱动，但为了确保兼容性，建议执行系统更新：

sudo apt update sudo apt full-upgrade

对于部分第三方摄像头（如 IMX219、IMX477 等），可能需要手动安装额外的驱动包。可以通过以下命令安装 libcamera 工具集：

sudo apt install libcamera-apps

安装完成后，可以使用libcamera-hello命令测试摄像头是否正常工作：

libcamera-hello

如果摄像头正常，屏幕上会短暂显示取景画面。

6. 常见问题与解决方案

在实际部署过程中，用户常遇到以下几类问题，下面逐一给出解决方案。

6.1 摄像头未被识别（detected=0）

可能原因：排线接触不良、驱动未加载、接口选择错误。

解决方案：

• 重新插拔排线，确保金属触点完全接触。
• 检查/boot/config.txt中是否包含camera_auto_detect=1配置项。
• 尝试更换另一个 CSI 接口（CAM0 或 CAM1）。

6.2 libcamera 报错：No cameras available

可能原因：libcamera 服务未启动或驱动加载失败。

解决方案：

• 执行sudo systemctl restart libcamera重启服务。
• 检查内核模块是否加载：lsmod | grep camera。
• 查看系统日志定位错误：dmesg | grep -i camera。

6.3 图像模糊或颜色异常

可能原因：镜头对焦不准、白平衡设置错误。

解决方案：

• 手动旋转镜头调整焦距，直到画面清晰。
• 使用libcamera-still时添加--awb auto参数自动校正白平衡。

6.4 旧版工具无法使用

可能原因：raspivid等旧工具在 Bookworm 中已被移除。

解决方案：改用新的 libcamera 工具，例如：

# 拍摄静态图片 libcamera-still -o photo.jpg 录制视频 libcamera-vid -o video.h264 实时预览 libcamera-hello

7. 实战：使用 Python 调用摄像头

对于开发者而言，通过 Python 调用摄像头是常见需求。在最新系统下，推荐使用picamera2库，它是官方为 libcamera 框架提供的 Python 接口。

7.1 安装 picamera2

sudo apt install python3-picamera2

7.2 拍摄静态图片

from picamera2 import Picamera2 from libcamera import controls picam2 = Picamera2() config = picam2.create_still_configuration() picam2.configure(config) picam2.start() picam2.capture_file("capture.jpg") picam2.stop()

7.3 录制视频

from picamera2 import Picamera2 picam2 = Picamera2() video_config = picam2.create_video_configuration() picam2.configure(video_config) picam2.start_and_record_video("test.mp4", duration=10) picam2.stop()

8. 进阶：OpenCV 集成

在计算机视觉项目中，OpenCV 是必不可少的工具。在最新系统下，可以通过 picamera2 与 OpenCV 无缝集成。

import cv2 from picamera2 import Picamera2 picam2 = Picamera2() picam2.configure(picam2.create_preview_configuration(main={"format": "RGB888", "size": (640, 480)})) picam2.start() while True: frame = picam2.capture_array() cv2.imshow("Camera", frame) if cv2.waitKey(1) & 0xFF == ord('q'): break cv2.destroyAllWindows() picam2.stop()

9. 总结与建议

树莓派4B在最新系统下的摄像头部署虽然经历了一些变化，但只要理解 libcamera 新架构的核心思路，按照正确的步骤进行配置，就能顺利解决问题。建议读者在遇到问题时，优先检查硬件连接，再逐步排查软件配置，最后借助系统日志定位具体错误。

随着树莓派生态的持续演进，libcamera 框架将成为未来的主流方向。掌握新工具链的使用，不仅能解决当前问题，也能为后续开发打下坚实基础。