Pivariety 颜色全局快门
树莓派摄像头模块
2MP OG02B10
（货号：B0348）
快速入门指南

介绍

• 关于Arducam
  自 2012 年以来，Arducam 一直是 SPI、MIPI、DVP 和 USB 相机的专业设计者和制造商。我们还为希望其产品独一无二的客户提供定制的交钥匙设计和制造解决方案服务。
• 关于这款 Pivariety 相机
  Arducam Pivariety 是一款 Raspberry Pi 相机解决方案tage 使用其硬件 ISP 功能。 Pivariety 相机模块使用户获得更好的性能和更广泛的相机、镜头选项。 也就是说，Pivariety 突破了闭源官方支持的摄像头驱动和摄像头模块（V1/V2/HQ）的局限性。

Pivariety相机模块可以很好地调整ISP与自动曝光，自动白平衡，自动增益控制，镜头阴影校正等。 该系列相机使用lib相机框架，Raspistill无法支持它们，并且访问相机的方式是lib camera SDK (for C++)/lib camera-still/lib camera-vid/Gstreamer。

这款 Pivariety OGO2B10 彩色全局快门相机是迁移的 Raspberry Pi 相机，可消除滚动快门伪影，以彩色清晰图像拍摄高速移动物体。

规格

软件

1. 驱动程序安装
   wget -O install_pivariety_pkgs.sh https://github.com/ArduCAM/Arducam-Pivariety-V4L2-Driver/releases/download/install_script/install_pivariety_pkgs.sh
   chmod +x install_pivariety_pkgs.sh
   ./install_pivariety_pkgs.sh -p kernel_driver
   按 y 重新启动
   注意：内核驱动安装仅支持最新版本 5.10。 对于其他内核版本，请访问我们的文档页面: https://www.arducam.com/docs/cameras-for-raspberry-pi/pivariety/how-to-install-kernel-driver-for-pivarietycamera/#2-how-to-build-raspberry-pi-kernel-driverfor-arducam-pivariety-camera
   您还可以访问此文档页面以参考硬件连接：
   https://www.arducam.com/docs/cameras-for-raspberry-pi/pivariety/pivarietyog02b10-2mp-color-global-shutter-camera-module/
2. 测试驱动程序和摄像头
   完成硬件组装和驱动程序安装后，您可以测试摄像头是否被检测到并正常工作。
   • View 驱动程序和摄像头的状态
   留言 | grep arducam
   如果驱动安装成功，会显示arducam-variety，如果能检测到摄像头，会显示固件版本。
   如果无法检测到摄像头，则显示器应该是探测失败，您可能需要检查色带连接，然后重新启动树莓派。
   • View 视频节点
   Pivariety 相机模块被模拟为 /dev/video* 节点下的标准视频设备，因此您可以使用 ls 命令列出 /dev 文件夹中的内容。
   ls /dev/视频* -l
   由于相机模块符合 V4L2，您可以使用 V4l2 控件列出支持的色彩空间、分辨率和帧速率。
   v4l2-ctl –列表格式-ext
   注意：虽然支持 V4L2 接口，但只能获取 RAW 格式的图像，不支持 ISP。
   
3. 官方Libcamera应用程序安装
   ./install_pivariety_pkgs.sh -p libcamera_dev
   ./install_pivariety_pkgs.sh -p libcamera_apps
4. 捕获图像和录制视频
   • 捕获图像
   例如ample, 前view 保存 5 秒并保存名为 test.jpg 的图像
   lib 相机静止 -t 5000 -o test.jpg
   • 录视频
   例如ample，用帧大小录制一个H.264 10s视频1920W×1080H
   lib 相机-vid -t 10000 –宽度 1920 –高度 1080 -o test.h264
   注意：H.264 格式仅支持 1920×1080 及以下分辨率。
   • 插件 gstreamer 安装
   安装 gstreamer
   sudo apt 更新
   sudo apt install -y gstreamer1.0-tools
   预view
   gst-launch-1.0 libcamerasrc ！ '视频/xraw，宽度=1920，高度=1080'！ 视频转换！ 自动视频接收器

故障排除

1.  无法分配内存
   [3:45:35.833744413] [6019] INFO RPI raspberrypi.cpp:611 传感器：/base/soc/i2c0mux/i2c@1/arducam@0c – 选择模式：
   5344×4012-pRAA
   [3:45:35.948442507] [6019] 错误 V4L2
   v4l2_videodevice.cpp:1126 /dev/video14[17:cap]：无法请求 4 个缓冲区：无法分配内存 [3:45:35.948551358] [6019] 错误 RPI raspberrypi.cpp:808 无法分配缓冲区
   错误：*** 无法启动相机 ***
   编辑 /boot/cmdline.txt 并在最后添加 cma=400M
   更多详细信息： https://lists.libcamera.org/pipermail/libcamera-devel/2020-December/015838.html
2. 图像显示色点
   在命令末尾添加代码–denoise cdn_off
   ./libcamera-still -t 5000 -o test.jpg – denoise cdn_off
   更多详细信息： https://github.com/raspberrypi/libcameraapps/issues/19
3.  驱动安装失败
   请检查内核版本，我们仅在此 Pivariety 相机发布时提供最新官方内核版本映像的驱动程序。
   笔记： 如果你想自己编译内核驱动，请参考文档页面： https://www.arducam.com/docs/cameras-for-raspberry-pi/pivariety/how-to-installkernel-driver-for-pivariety-camera/
4. Failed to import fd 18 terminate call after throwing an instance of 'std::runtime_error' what(): failed to import fd 18 Aborted 如果你发现同样的错误，你可能对图形驱动程序做了错误的选择。 请按照 Arducam Doc 页面选择正确的图形驱动程序。
   如果您发现同样的错误，您可能对图形驱动程序进行了错误的选择。 请按照 Arducam Doc 页面选择正确的图形驱动程序。
5. 切换到原生相机（raspistill 等）
   编辑 file 将/boot/config.txt的dtoverlay=arducam改为#dtoverlay=arducam，修改完成后需要重启树莓派。
   sudo 重启

注意：本相机模组支持外部信号触发，请参考文档页面获取说明 https://www.arducam.com/docs/cameras-for-raspberry-pi/pivariety/how-toaccess-pivariety-og02b10-2mp-color-globalshutter-camera-using-external-trigger-snapshotmode/
如果您需要我们的帮助或想定制其他型号的 Pi 相机，请随时通过以下方式与我们联系
支持@arducam.com

文件/资源

	适用于树莓派的 ArduCam B0348 Pivariety 彩色全局快门相机模块 [pdf] 用户指南 B0348，树莓派 Pivariety 彩色全局快门相机模块
	适用于树莓派的 ArduCam B0348 Pivariety 彩色全局快门相机模块 [pdf] 用户指南 B0348，树莓派 Pivariety 彩色全局快门相机模块

参考

• 用户手册