Быстрый старт с комплектом Arducam CamArray HAT

Документация Arducam · перевод arducam-russia.ru

Оборудование

Размеры

Назначение выводов

MIPI RX0/RX1/RX2/RX3

Каталожный номер разъёма: F32R-1A7H1-11022

Шлейф FFC: на одном конце контакты сверху, на другом — снизу; усилители на обоих концах, со стороны, противоположной контактам.

MIPI TX

Каталожный номер разъёма: F32R-1A7H1-11022

Подключение оборудования

Подключите CamArray HAT (версия с изменяемой базой) к Raspberry Pi:

Подключение четырёх камер к CamArray HAT (версия с изменяемой базой):

Подключение двух камер к CamArray HAT (версия с изменяемой базой):

Подключение стереокомплекта (версия с фиксированной базой) к Raspberry Pi:

Подключение стереокамеры с разъёмом на 15 контактов

Подключение стереокамеры с разъёмом на 22 контакта

Программное обеспечение

Найдите свою камеру в одной из двух таблиц ниже и выполните соответствующие команды.

Штатные камеры

Поддерживаемые платформы и ОС

Мультикамерный комплект IMX219

• Если у вас Raspberry Pi 5 с ОС Bookworm, выполните следующее:

sudo nano /boot/firmware/config.txt 
#Find the line: camera_auto_detect=1, update it to:
camera_auto_detect=0
dtoverlay=imx219
#Save and reboot.

Чтобы включить комплект на порту cam0 Raspberry Pi 5, внесите такие изменения:

sudo nano /boot/firmware/config.txt 
#Find the line: camera_auto_detect=1, update it to:
camera_auto_detect=0
dtoverlay=imx219,cam0
#Save and reboot.

• Если у вас Raspberry Pi 4 с ОС Bookworm или Bullseye, выполните следующее:

Bookworm на Raspberry Pi 4

sudo nano /boot/firmware/config.txt 
#Find the line: camera_auto_detect=1, update it to:
camera_auto_detect=0
dtoverlay=imx219
#Save and reboot.

Bullseye на Raspberry Pi 4

sudo nano /boot/config.txt 
#Find the line: camera_auto_detect=1, update it to:
camera_auto_detect=0
dtoverlay=imx219
#Save and reboot.

• Если у вас Raspberry Pi 0–3 с ОС Bullseye, выполните также следующее:

1. Откройте терминал.
2. Выполните sudo raspi-config.
3. Перейдите в раздел Advanced Options.
4. Включите Glamor graphic acceleration.
5. Перезагрузите Raspberry Pi.

Если возникнут проблемы с выводом изображения на экран, выполните также следующие шаги:

1. Откройте терминал.
2. Выполните sudo raspi-config.
3. Перейдите в раздел Advanced Options.
4. Перейдите в GL Driver.
5. Выберите GL (Full KMS).
6. Перезагрузите Raspberry Pi.

• Для Raspberry Pi Compute Module 3/4:

Текущая версия ПО пока поддерживает только одну камеру; CM4 по умолчанию использует порт CAM1.

Мультикамерный комплект IMX477

• Если у вас Raspberry Pi 5 с ОС Bookworm, выполните следующее:

sudo nano /boot/firmware/config.txt 
#Find the line: camera_auto_detect=1, update it to:
camera_auto_detect=0
dtoverlay=imx477
#Save and reboot.

Чтобы включить комплект на порту cam0 Raspberry Pi 5, внесите такие изменения:

sudo nano /boot/firmware/config.txt 
#Find the line: camera_auto_detect=1, update it to:
camera_auto_detect=0
dtoverlay=imx477,cam0
#Save and reboot.

• Если у вас Raspberry Pi 4 с ОС Bookworm или Bullseye, выполните следующее:

Bookworm на Raspberry Pi 4

sudo nano /boot/firmware/config.txt 
#Find the line: camera_auto_detect=1, update it to:
camera_auto_detect=0
dtoverlay=imx477
#Save and reboot.

Bullseye на Raspberry Pi 4

sudo nano /boot/config.txt 
#Find the line: camera_auto_detect=1, update it to:
camera_auto_detect=0
dtoverlay=imx477
#Save and reboot.

• Если у вас Raspberry Pi 0–3 с ОС Bullseye, выполните также следующее:

1. Откройте терминал.
2. Выполните sudo raspi-config.
3. Перейдите в раздел Advanced Options.
4. Включите Glamor graphic acceleration.
5. Перезагрузите Raspberry Pi.

Если возникнут проблемы с выводом изображения на экран, выполните также следующие шаги:

1. Откройте терминал.
2. Выполните sudo raspi-config.
3. Перейдите в раздел Advanced Options.
4. Перейдите в GL Driver.
5. Выберите GL (Full KMS).
6. Перезагрузите Raspberry Pi.

• Для Raspberry Pi Compute Module 3/4:

Текущая версия ПО пока поддерживает только одну камеру; CM4 по умолчанию использует порт CAM1.

Мультикамерный комплект IMX708

• Если у вас Raspberry Pi 5 с ОС Bookworm, выполните следующее:

sudo nano /boot/firmware/config.txt 
#Find the line: camera_auto_detect=1, update it to:
camera_auto_detect=0
dtoverlay=imx708
#Save and reboot.

Чтобы включить комплект на порту cam0 Raspberry Pi 5, внесите такие изменения:

sudo nano /boot/firmware/config.txt 
#Find the line: camera_auto_detect=1, update it to:
camera_auto_detect=0
dtoverlay=imx708,cam0
#Save and reboot.

• Если у вас Raspberry Pi 4 с ОС Bookworm или Bullseye, выполните следующее:

Bookworm на Raspberry Pi 4

sudo nano /boot/firmware/config.txt 
#Find the line: camera_auto_detect=1, update it to:
camera_auto_detect=0
dtoverlay=imx708
#Save and reboot.

Bullseye на Raspberry Pi 4

sudo nano /boot/config.txt 
#Find the line: camera_auto_detect=1, update it to:
camera_auto_detect=0
dtoverlay=imx708
#Save and reboot.

• Если у вас Raspberry Pi 0–3 с ОС Bullseye, выполните также следующее:

1. Откройте терминал.
2. Выполните sudo raspi-config.
3. Перейдите в раздел Advanced Options.
4. Включите Glamor graphic acceleration.
5. Перезагрузите Raspberry Pi.

Если возникнут проблемы с выводом изображения на экран, выполните также следующие шаги:

1. Откройте терминал.
2. Выполните sudo raspi-config.
3. Перейдите в раздел Advanced Options.
4. Перейдите в GL Driver.
5. Выберите GL (Full KMS).
6. Перезагрузите Raspberry Pi.

• Для Raspberry Pi Compute Module 3/4:

Текущая версия ПО пока поддерживает только одну камеру; CM4 по умолчанию использует порт CAM1.

Мультикамерный комплект IMX519

• Скачайте установочный скрипт bash:

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

• Установите libcamera и libcamera-apps:

./install_pivariety_pkgs.sh -p libcamera

./install_pivariety_pkgs.sh -p libcamera_apps

• Если у вас Raspberry Pi 5 с ОС Bookworm, выполните следующее:

sudo nano /boot/firmware/config.txt 
#Find the line: [all], add the following item under it:
dtoverlay=imx519
#Save and reboot.

Чтобы включить комплект на порту cam0 Raspberry Pi 5, внесите такие изменения:

sudo nano /boot/firmware/config.txt 
#Find the line: [all], add the following item under it:
dtoverlay=imx519,cam0
#Save and reboot.

• Если у вас Raspberry Pi 4 с ОС Bookworm или Bullseye, выполните следующее:

Bookworm на Raspberry Pi 4

sudo nano /boot/firmware/config.txt 
#Find the line: [all], add the following item under it:
dtoverlay=imx519
#Save and reboot.

Bullseye на Raspberry Pi 4 (Bullseye 6.1.21 и новее)

sudo nano /boot/config.txt 
#Find the line: [all], add the following item under it:
dtoverlay=imx519
#Save and reboot.

• Если у вас Raspberry Pi 0–3 с ОС Bullseye, выполните также следующее:

1. Откройте терминал.
2. Выполните sudo raspi-config.
3. Перейдите в раздел Advanced Options.
4. Включите Glamor graphic acceleration.
5. Перезагрузите Raspberry Pi.

Если возникнут проблемы с выводом изображения на экран, выполните также следующие шаги:

1. Откройте терминал.
2. Выполните sudo raspi-config.
3. Перейдите в раздел Advanced Options.
4. Перейдите в GL Driver.
5. Выберите GL (Full KMS).
6. Перезагрузите Raspberry Pi.

• Для Raspberry Pi Compute Module 3/4:

Текущая версия ПО пока поддерживает только одну камеру; CM4 по умолчанию использует порт CAM1.

Мультикамерный комплект 64MP Hawkeye

• Скачайте установочный скрипт bash:

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

• Установите libcamera и libcamera-apps:

./install_pivariety_pkgs.sh -p libcamera_dev

./install_pivariety_pkgs.sh -p libcamera_apps

• Установите драйвер камеры:

./install_pivariety_pkgs.sh -p 64mp_pi_hawk_eye_kernel_driver

После установки перезагрузите Raspberry Pi.

sudo reboot

• Если у вас Raspberry Pi 5 с ОС Bookworm, выполните следующее:

sudo nano /boot/firmware/config.txt 
#Find the line: [all], add the following item under it:
dtoverlay=arducam-64mp
#Save and reboot.

Чтобы включить комплект на порту cam0 Raspberry Pi 5, внесите такие изменения:

sudo nano /boot/firmware/config.txt 
#Find the line: [all], add the following item under it:
dtoverlay=arducam-64mp,cam0
#Save and reboot.

• Если у вас Raspberry Pi 4 с ОС Bookworm или Bullseye, выполните следующее:

Bookworm на Raspberry Pi 4

sudo nano /boot/firmware/config.txt 
#Find the line: [all], add the following item under it:
dtoverlay=arducam-64mp
#Save and reboot.

Bullseye на Raspberry Pi 4 (Bullseye 6.1.21 и новее)

sudo nano /boot/config.txt 
#Find the line: [all], add the following item under it:
dtoverlay=arducam-64mp
#Save and reboot.

• Если у вас Raspberry Pi 0–3 с ОС Bullseye, выполните также следующее:

1. Откройте терминал.
2. Выполните sudo raspi-config.
3. Перейдите в раздел Advanced Options.
4. Включите Glamor graphic acceleration.
5. Перезагрузите Raspberry Pi.

Если возникнут проблемы с выводом изображения на экран, выполните также следующие шаги:

1. Откройте терминал.
2. Выполните sudo raspi-config.
3. Перейдите в раздел Advanced Options.
4. Перейдите в GL Driver.
5. Выберите GL (Full KMS).
6. Перезагрузите Raspberry Pi.

• Для Raspberry Pi Compute Module 3/4:

Текущая версия ПО пока поддерживает только одну камеру; CM4 по умолчанию использует порт CAM1.

Работа со штатными камерами Raspberry Pi

• Приложения libcamera/rpicam для Raspberry Pi
• Руководство пользователя Picamera2 для Raspberry Pi
• Устранение неполадок штатных камер Raspberry Pi
• Калибровка затенения объектива для IMX219/IMX477

Камеры Arducam Pivariety

Поддерживаемые платформы и ОС

Работа с камерами Arducam Pivariety через libcamera/rpicam

Raspberry Pi OS Bullseye 6.1.21 и новее / Bookworm

Шаг 1. Скачайте установочный скрипт bash

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

Шаг 2. Установите libcamera

./install_pivariety_pkgs.sh -p libcamera_dev

Шаг 3. Установите libcamera-apps

./install_pivariety_pkgs.sh -p libcamera_apps

Шаг 4. Измените файл config.txt

• Если у вас Raspberry Pi 5 с ОС Bookworm, выполните следующее:

sudo nano /boot/firmware/config.txt 
#Find the line: [all], add the following item under it:
dtoverlay=arducam-pivariety
#Save and reboot.

Чтобы включить комплект на порту cam0 Raspberry Pi 5, внесите такие изменения:

sudo nano /boot/firmware/config.txt 
#Find the line: [all], add the following item under it:
dtoverlay=arducam-pivariety,cam0
#Save and reboot.

• Если у вас Raspberry Pi 4 с ОС Bookworm или Bullseye, выполните следующее:

Bookworm на Raspberry Pi 4

sudo nano /boot/firmware/config.txt 
#Find the line: [all], add the following item under it:
dtoverlay=arducam-pivariety
#Save and reboot.

Bullseye на Raspberry Pi 4 (Bullseye 6.1.21 и новее)

sudo nano /boot/config.txt 
#Find the line: [all], add the following item under it:
dtoverlay=arducam-pivariety
#Save and reboot.

• Если у вас Raspberry Pi 0–3 с ОС Bullseye, выполните также следующее:

1. Откройте терминал.
2. Выполните sudo raspi-config.
3. Перейдите в раздел Advanced Options.
4. Включите Glamor graphic acceleration.
5. Перезагрузите Raspberry Pi.

Если возникнут проблемы с выводом изображения на экран, выполните также следующие шаги:

1. Откройте терминал.
2. Выполните sudo raspi-config.
3. Перейдите в раздел Advanced Options.
4. Перейдите в GL Driver.
5. Выберите GL (Full KMS).
6. Перезагрузите Raspberry Pi.

Шаг 5. Получите изображение с камеры Arducam Pivariety через libcamera/rpicam

Предпросмотр в течение 5 секунд:

rpicam-still -t 5000

Если монитора нет, снимок можно сохранить без вывода на экран — файл test.jpg появится в текущем каталоге.

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

Raspberry Pi OS Bullseye до версии 6.1.21

Шаг 1. Установите скрипт bash

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

Шаг 2. Установите libcamera

./install_pivariety_pkgs.sh -p libcamera_dev

Шаг 3. Установите libcamera-apps

./install_pivariety_pkgs.sh -p libcamera_apps

Шаг 4. Установите драйвер камеры

# PivarietyPlease se
./install_pivariety_pkgs.sh -p kernel_driver

После установки перезагрузите Raspberry Pi.

sudo reboot

Шаг 5. Работа через libcamera-apps

Предпросмотр в течение 5 секунд:

rpicam-still -t 5000

Если монитора нет, снимок можно сохранить без вывода на экран — файл test.jpg появится в текущем каталоге.

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

Удлинение подключения в мультикамерных системах

Удлинение связи между HAT и Raspberry Pi

Чтобы разнести плату HAT и Raspberry Pi на большее расстояние, есть два решения.

Вариант 1

Артикул B0091 — передача по кабелю HDMI.

Сигнал MIPI передаётся по кабелю HDMI — это дальше, чем по шлейфу FFC: примерно до 3 м.

Вариант 2

Артикул U6248 — передача по сетевому кабелю.

Сигнал MIPI передаётся по сетевому кабелю — это дальше, чем по шлейфу FFC: примерно до 10 м.

По данным Arducam, в такой схеме проверяли сетевой кабель длиной 3 м — всё работает штатно. Кабель HDMI, по оценке Arducam, может быть и длиннее.

Переключение режима объединения каналов

На некоторых комплектах из четырёх камер (Quad-Camera) в Arducam реализовали переключение каналов. Режим объединения меняется по инструкции ниже.

Проверка узла I2C

Чтобы узнать, поддерживает ли ваш комплект переключение режима объединения, выполните команду:

pi@raspberrypi:~ $ i2cdetect -l
i2c-1   i2c         bcm2835 (i2c@7e804000)              I2C adapter
i2c-22  i2c         bcm2835 (i2c@7e205000)              I2C adapter
i2c-0   i2c         i2c-22-mux (chan_id 0)              I2C adapter
i2c-10  i2c         i2c-22-mux (chan_id 1)              I2C adapter

Если вывод похож на приведённый выше, переходите к следующим шагам.

Обнаружение устройств на шине I2C

Например, для узла i2c-10:

Выбор канала

Пример:

# Set to single channel 0
i2cset -y 10 0x24 0x24 0x02
# Set to single channel 1
i2cset -y 10 0x24 0x24 0x12
# Set to single channel 2
i2cset -y 10 0x24 0x24 0x22
# Set to single channel 3
i2cset -y 10 0x24 0x24 0x32
# Set to double channel (single channel 0 and single channel 1)
i2cset -y 10 0x24 0x24 0x01
# Set to double channel (single channel 2 and single channel 3)
i2cset -y 10 0x24 0x24 0x11
# Set to four in one mode (Default)
i2cset -y 10 0x24 0x24 0x00

Проверка

Проверка одного канала:

#Single channel test
pi@raspberrypi:~ $ i2cset -y 10 0x24 0x24 0x02
pi@raspberrypi:~ $ rpicam-still -t 0

После выбора канала можно сразу снимать командой rpicam.

Проверка двух каналов:

#Dual channels test
pi@raspberrypi:~ $ i2cset -y 10 0x24 0x24 0x01
pi@raspberrypi:~ $ rpicam-still -t 0

Если при работе с комплектом возникнут проблемы, напишите нам на quote@arducam-russia.ru.