模板: RPi Camera Quick Start

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

硬件连接

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

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

  • 接入树莓派5
将排线的金属面朝向有线网口位置，插入接口
Pi5有两个CSI接口，任意口都可以接入
  • 接入树莓派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
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 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=117452”