模板: RPi Camera Quick Start

来自Waveshare Wiki
跳转至： 导航、 搜索

硬件连接

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

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

  • 接入树莓派5
将排线的金属面朝向有线网口位置，插入接口
Pi5有两个CSI接口，任意口都可以接入
Pi5-IMX219-77-details-5.jpg
  • 接入树莓派Zero 系列
将排线的金属面朝下，接入摄像头接口
RPi Camera Connect Zero.png
  • 其他树莓派主板
将排线的金属面朝向HDMI接口，接入摄像头接口
RPi Camera Connect Pi4.png

关于型号

感光芯片型号 支持的树莓派主板型号 支持的驱动类型
OV5647 所有树莓派主板 libcamera / Raspicam
OV9281 所有树莓派主板 libcamera
IMX219 (树莓派官方） 所有树莓派主板 libcamera / Raspicam
IMX219 (第三方) 树莓派计算模块 libcamera
IMX290/ IMX327 所有树莓派主板 libcamera
IMX378 所有树莓派主板 libcamera
IMX477 (树莓派官方) 所有树莓派主板 libcamera / Raspicam
IMX477 (第三方) 所有树莓派主板 libcamera
IMX462 所有树莓派主板 libcamera
IMX519 树莓派主板 libcamera（另装驱动）
IMX708 (树莓派Camera Module 3) 所有树莓派主板 libcamera
IMX296(树莓派Global Camera) 所有树莓派主板 libcamera
IMX500(树莓派AI 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/IMX462 dtoverlay=imx290,clock-frequency=37125000
IMX378 dtoverlay=imx378
IMX219 dtoverlay=imx219
IMX477 dtoverlay=imx477
IMX708 dtoverlay=imx708

注意：在树莓派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

AI Camera 软件配置

使用Raspberry Pi AI Camera,需要确保你使用的是树莓派最新系统。

  • 打开树莓派终端，使用指令更新系统
sudo apt update && sudo apt full-upgrade
  • 安装imx500固件和相关驱动
sudo apt install imx500-all
  • 安装完成后，重启系统
 sudo reboot

测试摄像头指令

打开树莓派终端，并开启摄像头预览：
sudo rpicam-hello -t 0

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

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

测试AI 摄像头指令

  • 打开树莓派终端，并使用rpicam-apps 摄像头程序进行测试
  • 物体识别预览测试 
    rpicam-hello -t 0s --post-process-file /usr/share/rpi-camera-assets/imx500_mobilenet_ssd.json --viewfinder-width 1920 --viewfinder-height 1080 --framerate 30
  • 录制视频，并做物体检测 
    rpicam-vid -t 10s -o output.264 --post-process-file /usr/share/rpi-camera-assets/imx500_mobilenet_ssd.json --width 1920 --height 1080 --framerate 30
  • 姿势检测预览 
    rpicam-hello -t 0s --post-process-file /usr/share/rpi-camera-assets/imx500_posenet.json --viewfinder-width 1920 --viewfinder-height 1080 --framerate 30
取自“https://www.waveshare.net/w/index.php?title=模板:RPi_Camera_Quick_Start&oldid=125757”