Skip to content

Quick Start

Note

The following applies to the Bullseye system.

Hardware Connection

Warning

Cameras are sensitive to static. Earth yourself prior to handling the PCB.
A sink tap or similar should suffice if you don’t have an earthing strap.

Connecting Description

The Raspberry Pi and the camera module are connected using a flexible cable. The connection to the camera is called CSI interface and the connection to the Raspberry Pi is called MIPI interface.

Connect to Camera

There are two different kinds of Raspberry Pi CSI camera connectors: 15-pin and 22-pin.

Connect to Raspberry pi

The flex cable inserts into the connector labelled CAMERA on the Raspberry Pi, which is located between the Ethernet and HDMI ports. The cable must be inserted with the silver contacts facing the HDMI port. To open the connector, pull the tabs on the top of the connector upwards, then towards the Ethernet port. The flex cable should be inserted firmly into the connector, with care taken not to bend the flex at too acute an angle. To close the connector, push the top part of the connector towards the HDMI port and down, while holding the flex cable in place.

There are two different kinds of Raspberry Pi MIPI port connectors: 15-pin and 22-pin. The 15-pin connector is mostly seen on standard Raspberry Pi model; the 22-pin is on Raspberry Pi Zero-W and Compute Module IO Board.

15pin
Pi3/Pi4

motherboard-pi-4-1536x1052

pi-4-to-cam-connection-1536x552

22pin
Pi Zero/ Pi Zero 2 W

pi-zero-board-pinout-3

CM3/CM4

pi-compute-module-pinout-1536x1050

Connection schematic

Pi3/Pi4

pi4-1 pi4-2

Pi Zero/ Pi Zero 2 W

pizero-1

CM3/CM4

cm3-1

Software

Pivariety Cameras

For the Pivariety cameras , you need to install the following steps:

Pivariety cameras Board list:

Resolution Camera Module
2MP IMX462
2MP OG02B10
2MP OV2311
2.3MP AR0234
16MP IMX298
18MP AR1820
21MP IMX230

Note

Since 5.15.38, the arducam-pivariety driver has been merged into the Raspberry Pi kernel and the name of the device tree is changed to arducam-pivariety, dtoverlay=arducam-pivariety is required to set the overlay. If your Raspberry Pi's kernel version is higher than 5.15.38 (you can run the command uname -a to check the kernel version), you just need to add dtoverlay=arducam-pivariety under [all] at the bottom of config.txt file(run the command sudo nano /boot/config.txt to edit the config file), then reboot your Pi to take effect. The step 4(Install Camera drivers) is for the device whose kernel version is lower than 5.15.38. Besides, please install libcamera(step 2 & step 3) to access pivariety camera.

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

Step 2. Install libcamera

./install_pivariety_pkgs.sh -p libcamera_dev

Step 3. Install libcamera-apps

./install_pivariety_pkgs.sh -p libcamera_apps

Step 4. Install Camera drivers

Note

Please select the driver installation against the table above, just select one of the commands.

# PivarietyPlease se
./install_pivariety_pkgs.sh -p kernel_driver
Please reboot your Pi when you finish the installation.

Step5. libcamera-apps

Preview 5 seconds.

libcamera-still -t 5000

If you do not have a display screen, you can save an image without displaying it. And an image of test.jpg will be saved in the current directory.

libcamera-still -t 5000 -n -o test.jpg