Быстрый старт с камерами Pivariety

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

Руководство состоит из двух основных разделов: подключение оборудования и настройка ПО. Чтобы настроить модуль камеры Arducam Pivariety на Raspberry Pi, выполните шаги ниже.

Совместимость с платформами

Поддерживаемые ОС

Камера совместима со всеми современными моделями Raspberry Pi и операционными системами, включая Trixie.

Список модулей камер Pivariety

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

Общий порядок подключения камер Raspberry Pi и Pivariety описан в документе:

Быстрый старт — подключение оборудования

Настройка ПО

Модулям камер Pivariety нужна доработанная Arducam версия библиотеки libcamera с функциями управления фокусом. Настройка состоит из запуска скрипта установки и ручного включения драйвера. Все три шага обязательны.

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

Скрипт скачивает инструменты для установки ПО от Arducam.

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 от Arducam

Затем установите с помощью скрипта доработанную библиотеку libcamera и программы к ней.

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

./install_pivariety_pkgs.sh -p libcamera_dev

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

./install_pivariety_pkgs.sh -p libcamera_apps

Шаг 3. Включите драйвер камеры

Теперь вручную отредактируйте файл config.txt, чтобы включить камеру.

Raspberry Pi 5 и CM5

Raspberry Pi 5 поддерживает Trixie и Bookworm. В обеих системах файл конфигурации находится в /boot/firmware/config.txt.

1. Откройте файл конфигурации: sudo nano /boot/firmware/config.txt
2. Отключите автоопределение камеры: camera_auto_detect=0
3. Добавьте оверлей arducam-pivariety в секцию [all]: dtoverlay=arducam-pivariety
4. Сохраните файл и перезагрузите систему: sudo reboot

dtoverlay=arducam-pivariety,cam0

Raspberry Pi 4

Raspberry Pi 4 поддерживает Trixie, Bookworm и Bullseye; файл конфигурации в них находится в разных местах.

Trixie и Bookworm:

sudo nano /boot/firmware/config.txt

Bullseye:

sudo nano /boot/config.txt

Порядок настройки (одинаков для всех версий ОС):

1. Установите camera_auto_detect=0
2. Добавьте dtoverlay=arducam-pivariety в секцию [all]
3. Сохраните файл и перезагрузите систему: sudo reboot

Raspberry Pi Zero — Pi 3

Эти модели поддерживают Trixie, Bookworm и Bullseye, но порядок настройки в них разный.

Trixie и Bookworm:

Стандартная настройка через /boot/firmware/config.txt:

sudo nano /boot/firmware/config.txt

1. Установите camera_auto_detect=0
2. Добавьте dtoverlay=arducam-pivariety в секцию [all]
3. Сохраните файл и перезагрузите систему: sudo reboot

Bullseye:

Настройка в два шага:

Шаг 1. Измените config.txt

sudo nano /boot/config.txt

1. Установите camera_auto_detect=0
2. Добавьте dtoverlay=arducam-pivariety в секцию [all]
3. Сохраните файл, но пока не перезагружайте систему — переходите к шагу 2

Шаг 2. Включите графику Glamor

sudo raspi-config

Откройте 6 Advanced Options → A3 Glamor, включите опцию (Enable) и перезагрузите систему (Reboot).

Raspberry Pi Compute Module 3 и 4

CM3 и CM4 работают со всеми этими ОС и имеют два порта камеры (cam0, cam1).

Trixie и Bookworm:

sudo nano /boot/firmware/config.txt

Bullseye:

sudo nano /boot/config.txt

Порядок настройки (одинаков для всех версий ОС):

1. Установите camera_auto_detect=0
2. Добавьте dtoverlay=arducam-pivariety в секцию [all]
3. Сохраните файл и перезагрузите систему: sudo reboot

dtoverlay=arducam-pivariety,cam0

Работа с камерой

После настройки и перезагрузки камера готова к работе.

Trixie и Bookworm:

Программы rpicam-apps:

1. Список доступных камер: rpicam-still --list-cameras
2. Предпросмотр (выход — Ctrl+C): rpicam-still -t 0
3. Снимок после 5-секундного предпросмотра: rpicam-still -t 5000 -o test.jpg

Bullseye:

Программы libcamera-apps:

1. Список доступных камер: libcamera-still --list-cameras
2. Предпросмотр (выход — Ctrl+C): libcamera-still -t 0
3. Снимок после 5-секундного предпросмотра: libcamera-still -t 5000 -o test.jpg

ERROR IPAProxy ipa_proxy.cpp:171 Configuration file 'arducam-pivariety.json' not found for IPA module 'rpi/pisp'

Устранение неполадок

Если возникают проблемы с изображением, например чёрный экран, возможно, система не распознала камеру.

Полезные материалы:

• Общее руководство по устранению неполадок

Если проблема не решается, напишите нам на quote@arducam-russia.ru.