ArduCam B0348 Pivariety Color Global Shutter Camera Module for Raspberry Pi User Guide

Pivariety Color Global Shutter
Camera Module for Raspberry Pi
2MP OG02B10
(SKU: B0348)
QUICK START GUIDE

INTRODUCTION

• About Arducam
  Arducam has been a professional designer and manufacturer of SPI, MIPI, DVP, and USB cameras since 2012. We also offer customized turnkey de­sign and manufacturing solution services for cus­tomers who want their products to be unique.

• About This Pivariety Camera
  Arducam Pivariety is a Raspberry Pi camera solution to take the advantage of using its hardware ISP functions. Pivariety camera modules make users get better performance and a wider variety of camera, lens options. In other words, Pivariety break­through the limitations of the closed-source official supported camera driver and camera modules (V1/ V2/H Q).

Pivariety camera modules made it possible to be well-tuned ISP with Auto Exposure, Auto White Balance, Auto Gain Control, Lens Shading Correc­tion, etc. This series of cameras use the lib camera framework, they can’t be supported by Raspistill, and the way to access the camera is lib camera SDK (for C++)/lib camera-still/lib camera-vid/Gstreamer.

This Pivariety OGO2B10 Color Global Shutter Cam­era is migrated Raspberry Pi Cameras, which elimi­nate rolling shutter artifacts to shoot high-speed moving objects in color sharp images.

SPECS

Focal length: 2.8mm±5%
F.NO: 2.8
FOV: 110deg (H)
IR Sensitivity| Integral IR filter, visible light
only
Frame Rate| 1600×1300@60fps;
1600×1080@80fps;
1280×720@120fps
Sensor Output Format| RAW10, RAW8
ISP Output Format| The output image format of JPG, YUV420, RAW, DNG
The output video format of MJPEG, H.264
Interface Type| 2-Lane MIPI
Adapter Board Size| 40mm×40mm
Board Size| 40mm×40mm

SOFTWARE

1. Driver Installation
   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
   press y to reboot
   NOTE: The kernel driver installation is only supported by the latest version 5.10. For other kernel versions, please go to our Doc page : 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
   You can also visit this doc page to refer to the hardware connection:
   https://www.arducam.com/docs/cameras-for-raspberry- pi/pivariety/pivarietyog02b10-2mp-color-global-shutter-camera-module/

2. Test the Driver and Camera
   After you’ve finished the hardware assembly and driver installation, you can test whether the camera is detected and working.
   • View the Status of Driver and Camera
   dmesg | grep arducam
   It will display arducam-variety if the driver installed success- fully and firmware version if the camera can be detected.
   The display should be probe failed if the camera can’t be detected, you might have to check the ribbon connection, then reboot the Raspberry Pi.
   • View the Video Node
   The Pivariety camera modules are emulated as the standard video device under /dev/video node, so you can use the ls command for listing the contents in the /dev folder.
   ls /dev/video -l
   Since the camera module is V4L2 compliant, you can use the V4l2 controls to list the supported color space, resolutions, and frame rates.
   v4l2-ctl –list-formats-ext
   NOTE: Although the V4L2 interface is supported, only RAW format images can be obtained, without ISP support.
   

3. Official Libcamera App Installation
   ./install_pivariety_pkgs.sh -p libcamera_dev
   ./install_pivariety_pkgs.sh -p libcamera_apps

4. Capture Image and Record Video
   • Capture image
   For example, preview for 5s and save the image named test.jpg
   lib camera-still -t 5000 -o test.jpg
   • Record video
   For example, record an H.264 10s video with the frame size 1920W × 1080H
   lib camera-vid -t 10000 –width 1920 –height 1080 -o test.h264
   NOTE: H.264 format only supports 1920×1080 and below resolution.
   • Plugin gstreamer installation
   Install gstreamer
   sudo apt update
   sudo apt install -y gstreamer1.0-tools
   Preview
   gst-launch-1.0 libcamerasrc ! ‘video/xraw,width=1920,height=1080’ ! videoconvert ! autovideosink

TROUBLESHOOT

1.   Cannot Allocate Memory
   [3:45:35.833744413] [6019] INFO RPI raspberrypi.cpp:611 Sensor: /base/soc/i2c0mux/i2c@1/arducam@0c – Selected mode:
   5344×4012-pRAA
   [3:45:35.948442507] [6019] ERROR V4L2
   v4l2_videodevice.cpp:1126 /dev/video14[17:cap]: Unable to request 4 buffers: Cannot allocate memory [3:45:35.948551358] [6019] ERROR RPI raspberrypi.cpp:808 Failed to allocate buffers
   ERROR: failed to start camera
   Edit /boot/cmdline.txt and add cma=400M at the end
   More details: https://lists.libcamera.org/pipermail/libcamera- devel/2020-December/015838.html

2. The Image Displays Color Dots
   Add code –denoise cdn_off at the end of the command
   ./libcamera-still -t 5000 -o test.jpg –denoise cdn_off
   More details: https://github.com/raspberrypi/libcameraapps/issues/19

3.  Failed to Install the Driver
   Please check the kernel version, we only provide the driver for the latest official kernel version image when this Pivariety camera is released.
   Note: If you want to compile the kernel driver by yourself, please refer to Doc page: https://www.arducam.com/docs/cameras-for-raspberry- pi/pivariety/how-to-installkernel-driver-for-pivariety-camera/

4. Failed to import fd 18 terminate called after throwing an instance of ‘std:: runtime_error’ what( ): failed to import fd 18 Aborted If you find the same error, you may make the wrong selection about the graphics driver. Please follow the Arducam Doc page to select the correct graphics driver.
   If you find the same error, you may make the wrong selection about the graphics driver. Please follow the Arducam Doc page to select the correct graphics driver.

5. Switch to the native camera (raspistill etc.)
   Edit the file of /boot/config.txt, make dtoverlay=arducam change to # dtoverlay=arducam After the modification is completed, you need to reboot the Raspberry Pi.
   sudo reboot

NOTE: This camera module support trigger via an external signal, please refer to the Doc page to get the instruction https://www.arducam.com/docs/cameras- for-raspberry-pi/pivariety/how-toaccess-pivariety-og02b10-2mp-color- globalshutter-camera-using-external-trigger-snapshotmode/
If you need our help or want to customize other models of Pi cameras, feel free to contact us via
support@arducam.com

References

• Simplifying embedded vision for all. - Arducam
• Redirecting...
• GitHub: Let’s build from here · GitHub
• Color dot problem · Issue #19 · raspberrypi/libcamera-apps · GitHub
• Index of /pipermail
• Simplifying embedded vision for all. - Arducam
• Arducam Wiki

Read User Manual Online (PDF format)

Download This Manual (PDF format)

Download this manual  >>