Устранение неполадок с мультикамерными комплектами CamArray

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

ВниманиеЕсли камера работает со сбоями, ещё раз проверьте основные моменты:

Шлейф подключён правильно и надёжно.
Используется камера обычной версии, а не специальная версия для платы CamArray.
Установлена подходящая версия Raspberry Pi OS Bullseye (устаревшую Buster использовать не рекомендуется).
Всё сделано по руководству по установке libcamera: драйвер, нужные версии libcamera-dev и libcamera-apps установлены без ошибок.

Дополнительные проверки:

1. Проверьте, что драйвер загружен правильно:

dmesg | grep -E "imx477|imx219|arducam"

Вывод dmesg с сообщениями драйвера камеры

2. Проверьте, что устройство video0 обнаружено:

ls /dev/video0

Если проблема не решилась, напишите нам на quote@arducam-russia.ru и приложите следующие сведения — так мы быстрее поможем:

Сведения об оборудовании: модель модуля камеры (например, артикул) или ссылка на страницу товара, схема подключения.
Скриншот выполняемых команд.
Сведения о системе — их выводят команды uname -a, cat /etc/os-release, cat /proc/meminfo, cat /boot/config.txt.
Системный журнал: dmesg | grep -E "imx477|imx219|arducam".
Журнал приложения.
Журнал ошибок или скриншоты ошибок, которые выдаёт приложение.

1. Ошибки видеопотока при физическом отключении камер (комплект из четырёх камер)

🛑 Описание проблемы

Видеопоток не удаётся получить, когда к комплекту из четырёх камер физически подключено меньше четырёх камер. Со всеми четырьмя сенсорами поток идёт нормально, но если отключить одну или несколько камер, чтобы перейти на две камеры или одну, видео пропадает.

🔍 Причина и технический анализ

Синхронизирующая плата CamArray HAT работает как мост, который объединяет сигналы нескольких сенсоров. По умолчанию прошивка ожидает, что все четыре порта камер заняты и инициализированы, — это нужно для синхронизации сигналов. Если физически отключить камеру, аппаратная проверка не проходит, и система перестаёт работать.

Чтобы уменьшить число активных потоков (например, перейти с четырёх изображений на два или одно), не отключайте камеры физически. Вместо этого смените режим объединения каналов программно, командами I2C: микросхема-мост будет пропускать нужные каналы или изменит компоновку изображения.

✅ Решение и порядок действий

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

Подключение оборудования: проследите, чтобы к плате HAT были физически подключены все четыре модуля камер. Без них плата не пройдёт инициализацию, даже если часть камер не нужна в итоговом изображении.
Переключение режима (программно): смените режим объединения каналов командами I2C — так задаётся, сколько камер выводится (например, все четыре, две или одна). Для этого выполните в терминале нужные команды i2cset. Конкретные значения приведены в руководстве: Инструкция: Переключение режима объединения через I2C

2. Официальная камера Raspberry Pi HQ не определяется на адаптере для нескольких камер V2.2

Признаки

Если подключить официальную камеру Raspberry Pi HQ (IMX477) к Raspberry Pi через адаптер для нескольких камер Arducam V2.2, система не захватывает видео, а rpicam не видит камеру.

При этом если в той же схеме заменить официальную камеру Raspberry Pi HQ на модуль камеры IMX477 производства Arducam, всё работает без сбоев.

Причина

Проблему вызывает функция автоопределения камеры на ранней стадии загрузки Raspberry Pi (camera_auto_detect=1): она конфликтует с платой-мультиплексором.

Когда при загрузке включён camera_auto_detect=1, прошивка Raspberry Pi активно опрашивает шину I2C в поиске микросхемы аутентификации, которая физически есть только в официальных камерах Raspberry Pi. Но камера подключена через мультиплексор Arducam, который на ранней стадии загрузки ещё не инициализирован и не переключён программой пользовательского уровня, — поэтому опрос I2C упирается в блокировку маршрута или тайм-аут. Из-за этого конфликта инициализация камеры в итоге не проходит.

Примечание. В модулях Arducam IMX477 такой микросхемы аутентификации нет. Поэтому прошивка пропускает этап активного опроса, конфликта на шине I2C не возникает, и модули Arducam нормально работают через адаптер.

Решение

Отключите автоопределение камеры в прошивке Raspberry Pi и вручную укажите оверлей драйвера IMX477 в конфигурационном файле системы.

Шаг 1. Откройте конфигурационный файл

Откройте терминал на Raspberry Pi и отредактируйте основной конфигурационный файл:

Примечание: в новых версиях Raspberry Pi OS (Bookworm/Trixie) файл находится по пути /boot/firmware/config.txt, в старых (Bullseye и раньше) — /boot/config.txt.

sudo nano /boot/firmware/config.txt

Шаг 2. Отключите автоопределение камеры

Найдите в файле строку:

camera_auto_detect=1

Измените значение с 1 на 0:

camera_auto_detect=0

Шаг 3. Сохраните изменения и перезагрузите Raspberry Pi

Сохраните изменения в редакторе nano:

Нажмите Ctrl + O.
Нажмите Enter, чтобы подтвердить.
Нажмите Ctrl + X, чтобы выйти из редактора.

Перезагрузите Raspberry Pi, чтобы изменения вступили в силу:

sudo reboot

После перезагрузки скрипт мультиплексора и команды rpicam заработают правильно, и адаптер для нескольких камер будет выдавать видео с официальных камер Raspberry Pi HQ.