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

Native Cameras

For Native cameras, please refer to the official Raspberry Pi documentation: Doc

Native Camera Board list:

Resolution Camera Module
5MP OV5647
8MP imx219
12MP imx477
16MP imx258
0.3MP OV7251
2MP OV2311
1.3MP imx296
2MP imx290
1MP OV9281

imx519/hawkeye 64mp Cameras

For the imx519/hawkeye 64mp, you need to install the following steps:

imx519/hawkeye 64mp camera Board list:

Resolution Camera Module
16MP imx519
64MP hawkeye-64mp

Step 1. Download the bash scripts

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.

# Install the imx519 camera kernel driver.
./install_pivariety_pkgs.sh -p imx519_kernel_driver_low_speed
# Install the 64mp Hawk-Eye camera kernel driver.
./install_pivariety_pkgs.sh -p 64mp_pi_hawk_eye_kernel_driver
Please reboot your Pi when you finish the installation. Step5. libcamera-apps

Preview 5 seconds.

libcamera-still -t 5000

If you don't 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