树莓派OV5647摄像头CSI排线连接与配置避坑指南-平芜编程栈

1. 为什么OV5647这块老摄像头至今还在被反复折腾

OV5647这颗500万像素的传感器，放在今天看参数确实不够看——2592×1944的最大分辨率，1080p下30帧，卷帘快门，没有硬件H.264编码。但如果你翻一翻树莓派官方配件列表，会发现它从2013年初代树莓派一直活到了现在，官方摄像头模块v1.3用的就是它。原因很直接：便宜、驱动成熟、CSI接口原生支持，而且树莓派OS里预装的驱动直接就能认。

我经手过的树莓派项目里，OV5647出现的频率高得离谱。学生做毕设拿它当视觉输入，智能车比赛用它做循迹，还有人拿它配合树莓派4B做延时摄影。但问题也集中在这里——很多人第一次插上排线，raspi-config里开了摄像头，raspistill一跑就报错，然后就开始怀疑是不是模块坏了、排线断了、系统版本不对。

实际情况是，OV5647在树莓派上的坑，九成以上出在三个地方：CSI排线的插入方向和接触、raspi-config里摄像头开关的实际作用范围、以及不同系统版本下命令行工具的差异。这篇内容就是把这几个环节拆开讲清楚，让你从拆包装到出图不超过二十分钟。

注意：本文所有操作基于树莓派官方OS（Raspberry Pi OS）的Bookworm和Bullseye版本，Ubuntu等其他系统在CSI摄像头支持上有额外差异，会在对应章节单独说明。

2. 硬件连接：CSI排线到底怎么插才不会烧

2.1 CSI接口的物理结构与排线方向判断

树莓派上的CSI（Camera Serial Interface）接口是一个15针的FPC排线座，位于板子靠近网口或USB口的位置（不同型号位置不同，树莓派4B是在网口和3.5mm音频口之间）。这个座子有一个黑色的卡扣，往上掰是松开，往下压是锁紧。

排线本身是15芯的柔性扁平线，一端接摄像头模块，一端接树莓派。关键点在于：排线的金属触点面朝向哪边。

以树莓派4B为例，CSI接口座子靠近板子边缘的那一侧是金属触点应该朝向的方向。具体来说，排线插入树莓派端时，金属触点面朝向远离板子中心的方向（也就是朝向USB口那一侧）。而插入摄像头模块端时，金属触点面朝向摄像头PCB板的方向。

这个方向搞反了会怎样？轻则接触不良、识别不到，重则排线插入时错位导致针脚短路。我见过有人硬插进去然后树莓派直接断电保护的情况，虽然树莓派有保护电路没烧，但排线基本报废了。

判断方法很简单：排线的一侧是光滑的蓝色或黑色塑料面，另一侧能看到一排金色的金属触点。你只需要记住一个原则——金属触点永远朝向板子上的连接器座子内部。树莓派端的座子内部在远离板边的一侧，摄像头端的座子内部在靠近PCB的一侧。

2.2 插入与锁紧的标准操作流程

先断电。树莓派关机，拔掉电源线。带电插拔CSI排线是烧摄像头模块和树莓派CSI控制器的主要原因之一。
用手指甲或塑料撬棒轻轻向上掰开CSI座子的黑色卡扣，听到轻微的“咔”一声即可，不要用蛮力。
将排线金属触点面朝向正确方向，平行插入座子，插到底。插到底的感觉是排线不再能往里推，且排线边缘与座子边缘基本齐平。
按住排线，将黑色卡扣向下压回原位。压回时应该感觉到一定的阻力，如果很轻松就压下去了，说明排线没插到底。
摄像头模块端同样操作，注意方向相反。
检查排线是否有歪斜、金属触点是否全部被座子覆盖。可以用手机微距拍一张照片放大看。

实操心得：插好之后轻轻拉一下排线，如果不动说明锁紧了。但不要用力拽，FPC排线很脆弱，反复弯折容易内部断裂。我一般会在排线弯折处贴一小块透明胶带做应力释放，尤其是树莓派4B这种排线需要弯折的安装方式。

2.3 不同树莓派型号的CSI接口差异

树莓派5有两个CSI接口（CAM0和CAM1），都是22针的新规格，和OV5647的15针排线不兼容，需要额外的转接线。树莓派Zero系列只有一个CSI接口，但排线宽度是22针，OV5647模块通常配的是15针排线，需要换线或转接。树莓派3B/3B+/4B都是标准15针CSI接口，直接插就行。

树莓派型号	CSI接口数量	排线规格	OV5647直插
3B/3B+	1	15针	是
4B	1	15针	是
Zero/Zero W	1	22针	需换线
5	2	22针	需转接
CM4	2	22针	需转接

3. raspi-config里的摄像头开关到底改了什么

3.1 旧版与新版raspi-config的差异

在Bullseye及之前的版本里，raspi-config的Interface Options里有一个明确的“Camera”开关，打开后会修改/boot/config.txt，添加或取消注释start_x=1和gpu_mem=128这两行。start_x=1的作用是加载博通GPU的摄像头驱动固件，gpu_mem=128是给GPU分配足够的内存来处理摄像头数据。

到了Bookworm版本，情况变了。树莓派OS开始使用libcamera作为默认摄像头栈，raspi-config里的Camera开关被移除了。取而代之的是，系统默认就加载了libcamera的驱动，你不需要手动开任何开关。如果你在Bookworm上找Camera选项找不到，不是你的问题，是它确实没了。

这个变化导致很多人升级系统后发现原来的raspistill和raspivid命令不能用了。因为这两个命令是旧版GPU驱动栈的工具，Bookworm默认不安装。你需要用libcamera-still和libcamera-vid来替代。

3.2 手动配置config.txt的完整参数

如果你用的是Bullseye或更早版本，或者需要在Bookworm上强制使用旧版驱动栈，可以手动编辑/boot/config.txt（Bookworm上是/boot/firmware/config.txt）。用sudo nano打开，找到或添加以下内容：

# 启用摄像头驱动 start_x=1 # 给GPU分配128MB内存，OV5647够用 gpu_mem=128 # 禁用自动检测，强制使用OV5647驱动 camera_auto_detect=0 # 指定传感器类型 dtoverlay=ov5647

这里解释一下每个参数的作用。start_x=1是加载GPU摄像头固件的总开关。gpu_mem=128是给GPU的内存，OV5647最大分辨率2592×1944，128MB足够，如果你同时用HDMI和摄像头，可以加到256。camera_auto_detect=0是关闭自动检测，因为自动检测在某些排线接触不良的情况下会误判。dtoverlay=ov5647是明确告诉系统用哪个传感器驱动。

改完之后sudo reboot重启。重启后用vcgencmd get_camera检查，如果输出supported=1 detected=1，说明摄像头被识别到了。

3.3 Bookworm下的libcamera配置方式

Bookworm不需要改config.txt，但你需要确认libcamera能识别到摄像头。运行libcamera-hello --list-cameras，如果输出里能看到ov5647，说明驱动加载正常。如果输出是空的，检查排线，然后运行sudo raspi-config，在Interface Options里看看有没有I2C需要开启（某些OV5647模块的EEPROM通信走I2C）。

Bookworm下拍一张测试照的命令是：

libcamera-still -o test.jpg --width 2592 --height 1944

如果报错说找不到摄像头，先运行sudo apt update && sudo apt full-upgrade，然后重启。libcamera的驱动更新比较频繁，旧版本内核可能不支持某些批次的OV5647。

注意：Ubuntu系统下CSI摄像头的支持一直是个痛点。Ubuntu 20.04和22.04的树莓派镜像默认不带libcamera驱动，需要手动编译安装，而且不同内核版本兼容性差异很大。如果你不是非用Ubuntu不可，建议直接用Raspberry Pi OS。

4. 从命令行到出图：OV5647的完整实操流程

4.1 系统准备与依赖安装

拿到一块全新的树莓派4B，先烧录Raspberry Pi OS。用Raspberry Pi Imager，选择Raspberry Pi OS (64-bit) Bookworm版本。烧录时点右下角齿轮，提前配置好WiFi、SSH和用户名密码，这样开机就能直接连。

开机后第一件事：

sudo apt update sudo apt full-upgrade -y sudo reboot

重启后安装libcamera工具集（Bookworm默认已装，但确保一下）：

sudo apt install -y libcamera-apps libcamera-tools

如果你用的是Bullseye，安装的是旧版工具：

sudo apt install -y raspistill raspivid

4.2 摄像头检测与参数确认

连接好排线后，先做硬件检测。Bookworm下：

libcamera-hello --list-cameras

正常输出应该类似：

Available cameras ----------------- 0 : ov5647 [2592x1944] (/base/soc/i2c0mux/i2c@1/ov5647@36) Modes: 'SGBRG10_CSI2P' : 640x480 [58.92 fps - (16, 0)/2560x1920 crop] 1296x972 [43.25 fps - (0, 0)/2592x1944 crop] 1920x1080 [32.81 fps - (348, 434)/1920x1080 crop] 2592x1944 [15.63 fps - (0, 0)/2592x1944 crop]

这里能看到OV5647支持的四种模式。640×480是裁剪模式，帧率最高；2592×1944是全分辨率，帧率最低。做视频流的时候要根据需求选模式，不是分辨率越高越好。

Bullseye下用：

vcgencmd get_camera

输出supported=1 detected=1就对了。

4.3 拍照与录像的命令行参数详解

拍一张全分辨率照片：

libcamera-still -o photo.jpg --width 2592 --height 1944 --quality 95 --timeout 2000

--timeout 2000是给摄像头2秒的预热时间，OV5647的自动曝光和自动白平衡需要时间收敛。如果你拍出来照片偏暗或偏色，把timeout加到5000。

录一段10秒的1080p视频：

libcamera-vid -o video.h264 --width 1920 --height 1080 --framerate 30 --timeout 10000

OV5647没有硬件编码，libcamera-vid是用CPU软编码的。树莓派4B的CPU软编码1080p30问题不大，但树莓派3B就吃力了，建议降到720p。

如果你需要MP4格式，可以用ffmpeg转：

sudo apt install -y ffmpeg ffmpeg -i video.h264 -c copy video.mp4

4.4 用Python调用OV5647的两种方式

第一种是picamera2，这是Bookworm下的新库：

from picamera2 import Picamera2 import time picam2 = Picamera2() config = picam2.create_still_configuration(main={"size": (2592, 1944)}) picam2.configure(config) picam2.start() time.sleep(2) picam2.capture_file("test_python.jpg") picam2.stop()

第二种是旧版picamera，适用于Bullseye：

import picamera import time camera = picamera.PiCamera() camera.resolution = (2592, 1944) camera.start_preview() time.sleep(2) camera.capture("test_python.jpg") camera.stop_preview()

picamera2的配置更灵活，支持多流输出，但API变化大，很多旧教程的代码不能直接跑。picamera的API简单，但Bookworm下已经不再默认安装。

实操心得：如果你在Bookworm上跑picamera2报错说找不到摄像头，先确认libcamera-hello能正常出图。如果libcamera正常但picamera2报错，大概率是Python虚拟环境的问题。picamera2需要系统级的libcamera库，在venv里跑需要加--system-site-packages参数创建虚拟环境。

5. 常见问题速查与排查思路

5.1 摄像头识别不到的五种原因

现象	可能原因	排查方法
`detected=0`	排线方向反了	重新插拔，确认金属触点朝向
`detected=0`	排线没插到底	拔出重插，压紧卡扣
`detected=0`	config.txt没配	检查start_x=1和dtoverlay
`detected=1`但拍照黑屏	镜头盖没撕	撕掉镜头上的保护膜
`detected=1`但拍照黑屏	光圈或曝光问题	加timeout，检查环境光
系统卡死	排线短路	断电检查排线是否错位

镜头盖这个问题听起来很蠢，但我至少见过五次有人忘了撕OV5647模块上那层蓝色保护膜，然后折腾了一下午驱动。

5.2 图像偏色与曝光异常的调整

OV5647的自动白平衡在室内荧光灯下容易偏绿。可以在命令里手动指定：

libcamera-still -o photo.jpg --awb indoor --timeout 3000

--awb的可选值有auto、incandescent、tungsten、fluorescent、indoor、daylight、cloudy。室外晴天用daylight，阴天用cloudy。

曝光方面，如果拍出来过曝，加--ev -1；欠曝加--ev 1。OV5647的动态范围有限，高对比场景下要么保高光要么保暗部，没有两全的办法。

5.3 视频录制卡顿与掉帧的处理

树莓派4B录1080p30用软编码，CPU占用大概在60%到80%。如果同时跑其他任务，掉帧是必然的。解决办法有三个：降到720p、用--framerate 15降帧率、或者用硬件编码（但OV5647不支持，需要换摄像头模块）。

树莓派5的CPU强很多，1080p30软编码基本无压力，甚至可以尝试1080p60。但树莓派5的CSI接口是22针的，OV5647需要转接线，转接线的质量参差不齐，我遇到过转接线导致I2C通信不稳定的情况，换了一根就好了。

5.4 长时间运行的稳定性问题

OV5647连续工作超过两小时后，有些批次会出现图像噪点增多或偶尔丢帧。这是传感器发热导致的。解决办法是降低分辨率或帧率，减少传感器负载。如果做延时摄影，可以在每次拍摄之间加sleep，让传感器有时间冷却。

另外，树莓派的CSI排线在长时间弯折后可能出现接触不良。如果你做的是固定安装的项目，建议用排线固定座或热熔胶把排线固定在接口附近，减少应力。

6. 进阶应用：从OV5647到实际项目落地

6.1 用OV5647做运动检测

OV5647虽然老，但做运动检测够用。思路很简单：连续拍两张照片，用Python的PIL库做差分，超过阈值就触发录像。picamera2支持直接输出numpy数组，处理起来很方便。

from picamera2 import Picamera2 import numpy as np from PIL import Image picam2 = Picamera2() picam2.configure(picam2.create_preview_configuration(main={"size": (640, 480)})) picam2.start() prev = None while True: frame = picam2.capture_array() gray = np.array(Image.fromarray(frame).convert('L')) if prev is not None: diff = np.abs(gray.astype(int) - prev.astype(int)) if diff.mean() > 10: print("Motion detected") prev = gray

这个方案在树莓派4B上跑640×480能到15帧左右，够做基本的运动触发。

6.2 结合YOLOv5做目标检测

树莓派5上跑YOLOv5是可行的，但OV5647的帧率会成为瓶颈。YOLOv5s在树莓派5上推理一帧大概需要200到300毫秒，OV5647在640×480下能到58帧，但实际处理链路是：采集→预处理→推理→后处理，整体帧率大概在3到5帧。做实时检测勉强够，做高帧率追踪就不行了。

如果要做目标检测，建议把OV5647的分辨率降到640×480，用libcamera-vid推流到本地端口，然后用OpenCV读取。这样比直接调picamera2更灵活，也方便调试。

6.3 延时摄影的完整配置

延时摄影是OV5647最合适的应用场景之一。配置思路：用cron定时拍照，然后用ffmpeg合成视频。

拍照脚本/home/pi/timelapse.sh：

#!/bin/bash DATE=$(date +"%Y%m%d_%H%M%S") libcamera-still -o /home/pi/timelapse/$DATE.jpg --width 2592 --height 1944 --timeout 1000 --nopreview

cron配置：

*/5 * * * * /home/pi/timelapse.sh

每5分钟拍一张，一天288张。合成视频：

ffmpeg -framerate 24 -pattern_type glob -i '/home/pi/timelapse/*.jpg' -c:v libx264 -pix_fmt yuv420p timelapse.mp4

实操心得：延时摄影一定要用--nopreview关掉预览，否则每次拍照都会在HDMI输出上闪一下，而且预览会占用GPU资源。另外，OV5647的自动曝光在光线变化大的场景下（比如从白天到黄昏）会频繁调整，导致照片亮度不一致。可以在脚本里固定曝光参数，或者后期用ffmpeg做亮度均衡。

6.4 多摄像头方案的可能性

树莓派5有两个CSI接口，可以同时接两个OV5647。但libcamera对多摄像头的支持还在完善中，同时采集两个摄像头的画面需要分别指定--camera 0和--camera 1。树莓派4B只有一个CSI接口，多摄像头只能通过USB摄像头扩展，但USB摄像头的延迟和稳定性不如CSI。

如果你需要多角度监控，一个可行的方案是：树莓派5 + 两个OV5647 + 一个USB摄像头，分别覆盖不同角度。但要注意电源供应，三个摄像头同时工作电流可能超过树莓派5的USB供电能力，需要带外部供电的USB Hub。

7. 我踩过的那些坑和最后的小技巧

OV5647这个模块，我前后用过不下二十个，从树莓派3B时代一直用到树莓派5。最大的感受是：硬件本身很皮实，问题基本都出在连接和配置上。

排线插反这件事我干过两次，第一次以为模块坏了，差点退货，后来发现是方向问题。第二次是排线没插到底，卡扣压下去了但金属触点只接触了一半，导致摄像头时好时坏。所以现在我的习惯是：插好排线后，用手机拍一张微距照片放大看，确认金属触点全部被座子覆盖。

raspi-config的Camera开关在Bookworm里消失这件事，坑了很多人。如果你在网上搜到的教程还在说“打开raspi-config的Camera选项”，那大概率是Bullseye或更早的教程。Bookworm直接用libcamera，不需要开任何开关。

最后分享一个检测排线接触是否良好的小技巧：在终端里运行while true; do libcamera-hello --list-cameras | grep ov5647; sleep 1; done，让它跑几分钟。如果输出一直稳定出现ov5647，说明接触没问题。如果偶尔消失，说明排线有接触不良，需要重新插拔或更换排线。这个方法比拍一张照片测试更可靠，因为拍照只测一次，而接触不良往往是间歇性的。