模板: RPi Camera Quick Start
来自Waveshare Wiki
硬件连接
要测试树莓派摄像头，需要给树莓派接入HDMI屏幕或者DSI屏幕
树莓派主板上的CSI （摄像头） 和 DSI （显示器） 两个接口的封装是相似的，接线的时候注意不要接错了。CSI接口在音频接口和HDMI接口中间， 树莓派Zero系列的摄像头接口在Power接口边上。 如果你使用的计算模块，具体以底板的布局为准。
- 接入树莓派5
- 将排线的金属面朝向有线网口位置，插入接口
- Pi5有两个CSI接口，任意口都可以接入
- 接入树莓派Zero 系列
- 将排线的金属面朝下，接入摄像头接口
- 其他树莓派主板
- 将排线的金属面朝向HDMI接口，接入摄像头接口
测试摄像头
软件配置
如果使用的是最新的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/IMX462 | dtoverlay=imx290,clock-frequency=37125000 |
| IMX378 | dtoverlay=imx378 |
| IMX219 | dtoverlay=imx219 |
| IMX415 | dtoverlay=imx415,clk-37125 |
| IMX477 | dtoverlay=imx477 |
| IMX708 | dtoverlay=imx708 |
| IMX296 | dtoverlay=imx296 |
注意：在树莓派5上使用IMX290，还需要添加json文件到指令目录才能使用。操作如下：
sudo wget https://www.waveshare.net/w/upload/7/7a/Imx290.zip sudo unzip Imx290.zip sudo cp imx290.json /usr/share/libcamera/ipa/rpi/pisp
- 双目摄像头配置
- 目前CM4底板和树莓派5均支持接入两路摄像头
- 如果用户需要同时接入两路摄像头调用，可以在对应的摄像头配置语句后面加入cam0和cam1指定摄像头。
- 例如，如果同时接入imx219在cam0接口，ov5647摄像头接口在cam1
dtoverlay=imx219,cam0 dtoverlay=ov5647,cam1
测试摄像头（bullseye系统）
快速调用
适用于OV5647，官方IMX219，官方IMX477.
打开树莓派终端，并开启摄像头预览：
sudo libcamera-hello -t 0
如果要关掉预览窗口，可以用ctrl-c终止程序。
测试摄像头（bookworm系统）
快速调用
适用于OV5647，官方IMX219，官方IMX477.
打开树莓派终端，并开启摄像头预览：
sudo rpicam-hello -t 0
如果要关掉预览窗口，可以用ctrl-c终止程序。