Камера IMX378 12 Мп

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

Введение

Модуль камеры Arducam IMX378 на сенсоре Sony IMX378 высокого качества — готовое решение встраиваемого машинного зрения для плат Raspberry Pi. Разрешение — 12,3 Мп, форм-фактор — как у камеры V2. Модуль совместим со всеми моделями Raspberry Pi и работает с актуальным ПО от Raspberry Pi Foundation. Его применяют в системах машинного зрения и в уличных задачах.

Сенсор

Основные характеристики

Видеорежимы

Модели

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

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

В этом разделе описано, как настроить систему для работы с камерой IMX378 и как затем ею пользоваться. Процесс состоит из трёх частей:

1. Настройка системы — обязательный первый шаг, чтобы Raspberry Pi распознал камеру. Изменения вступают в силу только после перезагрузки.
2. Работа с камерой — команды для предпросмотра и съёмки.
3. Устранение неполадок — решения типичных проблем с изображением.

1. Настройка системы

Прежде чем начать, уточните модель Raspberry Pi и версию ОС (Bookworm или Bullseye): от них зависят инструкции.

Raspberry Pi 5 и CM5

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

1. Откройте файл конфигурации для редактирования: sudo nano /boot/firmware/config.txt
2. Найдите строку camera_auto_detect=1 и замените её на camera_auto_detect=0.
3. Найдите строку [all] и добавьте под ней строку dtoverlay=imx378.
4. Сохраните изменения и закройте редактор (в nano нажмите CTRL + X, затем Y и Enter).
5. Перезагрузите Raspberry Pi, чтобы применить изменения: sudo reboot

dtoverlay=imx378,cam0

Raspberry Pi 4

Pi 4 поддерживает и Bookworm, и Bullseye. Шаги настройки одинаковые, но файл config.txt лежит в разных местах. Нужная команда для каждой ОС — ниже.

В Bookworm файл находится по пути /boot/firmware/config.txt. Откройте его командой:

sudo nano /boot/firmware/config.txt

В Bullseye файл находится по пути /boot/config.txt. Откройте его командой:

sudo nano /boot/config.txt

Открыв нужный файл, внесите две правки:

1. Найдите строку camera_auto_detect=1 и замените значение на 0.
2. Найдите раздел [all] и добавьте под ним dtoverlay=imx378.
3. Сохраните изменения и закройте редактор (в nano нажмите CTRL + X, затем Y и Enter).
4. Перезагрузите Raspberry Pi, чтобы применить изменения: sudo reboot

Raspberry Pi Zero — Pi 3

Эти модели поддерживают и Bookworm, и Bullseye. Порядок настройки в них заметно различается, особенно в Bullseye. Инструкции для каждой ОС — ниже.

В Bookworm настройка стандартная и простая. Файл конфигурации находится по пути /boot/firmware/config.txt.

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

В Bullseye настройка состоит из двух частей: сначала отредактируйте файл config.txt, затем включите графическую настройку в raspi-config. Для правильной работы камеры нужны обе части.

Шаг 1. Отредактируйте config.txt

Файл конфигурации находится по пути /boot/config.txt.

1. Откройте файл для редактирования: sudo nano /boot/config.txt
2. Найдите camera_auto_detect=1 и замените значение на 0.
3. Добавьте dtoverlay=imx378 в раздел [all].
4. Сохраните файл, но пока не перезагружайте систему! Сразу переходите к шагу 2.

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

На этих моделях с Bullseye без этой настройки камера не будет работать правильно.

1. Откройте утилиту настройки Raspberry Pi в терминале: sudo raspi-config
2. Перейдите в 6 Advanced Options.
3. Выберите A3 Glamor.
4. В запросе выберите <Yes>, чтобы включить графическое ускорение Glamor.
5. В главном меню выберите <Finish>, затем <Yes>, чтобы перезагрузить Raspberry Pi.

Raspberry Pi Compute Module 3 и 4 (CM3/CM4)

CM3 и CM4 поддерживают обе ОС, у них два порта камеры (cam0 и cam1). Путь к config.txt для каждой ОС — ниже.

Bookworm: файл конфигурации находится по пути /boot/firmware/config.txt. Откройте его командой:

sudo nano /boot/firmware/config.txt

Bullseye: файл конфигурации находится по пути /boot/config.txt. Откройте его командой:

sudo nano /boot/config.txt

Открыв нужный файл, внесите стандартные правки (camera_auto_detect=0 и dtoverlay=imx378), затем сохраните файл и перезагрузите систему.

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

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

В Bookworm используется набор rpicam-apps, основная команда — rpicam-still.

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

В более старой Bullseye используется набор libcamera-apps, основная команда — libcamera-still.

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

Подробнее — в руководстве по началу работы с Raspberry Pi.

3. Проблемы с изображением

Если экран остаётся чёрным или есть другие проблемы с изображением, возможно, система не распознала камеру. Что можно сделать:

• Типичные неполадки и их устранение

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