模板: RPi Camera Quick Start

硬件连接

要测试树莓派摄像头，需要给树莓派接入HDMI屏幕或者DSI屏幕

树莓派主板上的CSI （摄像头） 和 DSI （显示器） 两个接口的封装是相似的，接线的时候注意不要接错了。CSI接口在音频接口和HDMI接口中间， 树莓派Zero系列的摄像头接口在Power接口边上。 如果你使用的计算模块，具体以底板的布局为准。

• 接入树莓派5

将排线的金属面朝向有线网口位置，插入接口

Pi5有两个CSI接口，任意口都可以接入

• 接入树莓派Zero 系列

将排线的金属面朝下，接入摄像头接口

• 其他树莓派主板

将排线的金属面朝向HDMI接口，接入摄像头接口

关于型号

感光芯片型号	支持的树莓派主板型号	支持的驱动类型
OV5647	所有树莓派主板	libcamera / Raspicam
OV9281	所有树莓派主板	libcamera
IMX219 (树莓派官方）	所有树莓派主板	libcamera / Raspicam
IMX219 (第三方)	树莓派计算模块	libcamera
IMX290/ IMX327	所有树莓派主板	libcamera
IMX378	所有树莓派主板	libcamera
IMX477 (树莓派官方)	所有树莓派主板	libcamera / Raspicam
IMX477 (第三方)	树莓派计算模块	libcamera
IMX519	树莓派主板	libcamera（另装驱动）
IMX708 (树莓派Camera Module 3)	所有树莓派主板	libcamera
IMX296(树莓派Global Camera)	所有树莓派主板	libcamera

测试摄像头

软件配置

如果使用的是最新的Raspberry Pi Camera Module 3 或者Raspberry Pi Global Shutter Camera,需要运行以下指令进行系统更新（需要联网操作）.

sudo apt-get update -y
sudo apt-get upgrade -y

如果只调用一个摄像头，请将摄像头接入到CAM1口.
如果使用的是是非树莓派官方的摄像头，均需要另外配置config.txt 文件.
如果使用的是最新的Bookworm系统，需要配置的是/boot/firmware/config.txt。

sudo nano /boot/config.txt
#如果是bookworm系统
sudo nano /boot/firmware/config.txt

找到camera-auto-detect=1 语句，修改为 camera_auto_detect=0

在文件结尾，根据摄像头型号加入以下设置语句

型号	设置语句
OV9281	dtoverlay=ov9281
IMX290/IMX327	dtoverlay=imx290,clock-frequency=37125000
IMX378	dtoverlay=imx378
IMX219	dtoverlay=imx219
IMX477	dtoverlay=imx477
IMX708	dtoverlay=imx708

双目摄像头配置

• 目前CM4底板和树莓派5均支持接入两路摄像头
• 如果用户需要同时接入两路摄像头调用，可以在对应的摄像头配置语句后面加入cam0和cam1指定摄像头。
  • 例如，如果同时接入imx219在cam0接口，ov5647摄像头接口在cam1

dtoverlay=imx219,cam0
dtoverlay=ov5647,cam1

测试摄像头指令

打开树莓派终端，并开启摄像头预览：

sudo libcamera-hello -t 0

如果要关掉预览窗口，可以直接组合按键Alt-F4，或者点击x关掉。 也可以回到终端界面，用ctrl-c终止程序。
注：如果是Camera module 3，会开启自动对焦功能

测试双目摄像头

• 测试双目摄像头的时候，需要加--camera 指定摄像头，不加该参数设置默认指定cam0

sudo libcamera-hello -t 0 --camera 0
sudo libcamera-hello -t 0 --camera 1