Камера IMX519 16 Мп

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

Введение

Arducam выпустила серию камер 16 Мп для Raspberry Pi на сенсоре Sony IMX519. Разрешение у них вдвое выше, чем у камеры V2, и на 40 % выше, чем у камеры HQ, поэтому они хорошо подходят для самых разных промышленных, потребительских и других задач. Камеры работают с актуальным ПО от Raspberry Pi Foundation и используют те же алгоритмы настройки изображения, что и официальные модули камер.

Сенсор

Сенсор	IMX519
Тип затвора	Скользящий затвор
Активные пиксели	4656 (Г) × 3496 (В)
Разрешение	16 Мп
Оптический формат	1/2.53"
Размер пикселя	1,22 × 1,22 мкм
Вывод данных CSI-2	2 линии
Формат данных	RAW10/8, COMP8

Автофокус

В модулях камер Arducam 16MP IMX519 с автофокусом фокус управляется программно: камеру можно навести на близкий объект или на любой нужный участок сцены.

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

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

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

Платформа	Trixie	Bookworm	Bullseye
Raspberry Pi 5 / CM5	✅	✅	❌
Raspberry Pi 4B / 3B+ / 3A+ / Zero / Zero 2 W	✅	✅	✅
Raspberry Pi CM3 / CM3+ / CM4 (нужна плата-адаптер)	✅	✅	✅

Buster не поддерживаетсяRaspberry Pi OS Buster несовместима с нужным стеком libcamera. Рекомендуется Bullseye или более новая версия ОС.

Каталог продукции

Артикул	Разъём (контакты / расположение)	Особенности	Тип объектива	Угол обзора	Фокусировка	Чувствительность к ИК
B0386	22 / верхнее	Компактный размер	Штатный объектив	66° (Г) × 49,5° (В)	Фиксированный фокус	Без ИК-фильтра
B0371	22 / верхнее	Высокое разрешение	Штатный объектив	66° (Г) × 49,5° (В)	Автофокус	ИК-фильтр 650 нм
B0389	15 / н/д	Миниатюрная камера	Штатный объектив	65° (Г) × 48,8° (В)	Фиксированный фокус	Без ИК-фильтра
B0391	22 / н/д	Миниатюрная камера	Штатный объектив	65° (Г) × 48,8° (В)	Фиксированный фокус	Без ИК-фильтра
B0449	22 / верхнее	Широкоугольная	M12	140° (Д) × 120° (Г) × 95° (В)	Ручная фокусировка	ИК-фильтр 650 нм

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

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

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

Камеры с автофокусом

Артикул	Разъём (контакты / расположение)	Особенности	Тип объектива	Угол обзора	Фокусировка	Чувствительность к ИК
B0371	15 / нижнее	Высокое разрешение	Штатный объектив	66° (Г) × 49,5° (В)	Автофокус	ИК-фильтр 650 нм

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

Нужен доступ в интернетRaspberry Pi должен быть подключён к интернету, чтобы скачать нужные пакеты ПО.

Шаг 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.

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

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

Raspberry Pi 5 и CM5

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

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

Выбор порта камерыЕсли камера подключена к порту CAM0 на Pi 5 и CM5, используйте строку:

dtoverlay=imx519,cam0

Raspberry Pi 4

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

Trixie и Bookworm:

sudo nano /boot/firmware/config.txt

Bullseye:

sudo nano /boot/config.txt

Дальнейшие шаги (одинаковы для всех версий ОС):

Установите camera_auto_detect=0.
Добавьте dtoverlay=imx519 в раздел [all].
Сохраните файл и перезагрузите систему: sudo reboot

Raspberry Pi Zero — Pi 3

Эти модели работают с Trixie, Bookworm и Bullseye, но порядок настройки различается.

Trixie и Bookworm

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

sudo nano /boot/firmware/config.txt

Установите camera_auto_detect=0.
Добавьте dtoverlay=imx519 в раздел [all].
Сохраните файл и перезагрузите систему: sudo reboot

Bullseye

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

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

sudo nano /boot/config.txt

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

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

sudo raspi-config

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

Raspberry Pi Compute Module 3 и 4

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

Trixie и Bookworm:

sudo nano /boot/firmware/config.txt

Bullseye:

sudo nano /boot/config.txt

Дальнейшие шаги (одинаковы для всех версий ОС):

Установите camera_auto_detect=0.
Добавьте dtoverlay=imx519 в раздел [all].
Сохраните файл и перезагрузите систему: sudo reboot

Выбор порта камерыЧтобы использовать интерфейс CAM0, измените строку оверлея так:

dtoverlay=imx519,cam0

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

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

Trixie и Bookworm — набор rpicam-apps:

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

Bullseye — набор libcamera-apps:

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

Автофокус и ручная фокусировка

КраткоДля камер с мотором фокусировки в Arducam добавили параметры автофокуса: доступны однократный и непрерывный автофокус.

Подробнее — в документе:

Автофокус и ручная фокусировка для камеры Arducam 16 Мп с автофокусом

Камеры с фиксированным фокусом

Артикул	Разъём (контакты / расположение)	Особенности	Тип объектива	Угол обзора	Фокусировка	Чувствительность к ИК
B0386	15 / верхнее	Компактный размер	Штатный объектив	66° (Г) × 49,5° (В)	Фиксированный фокус	Без ИК-фильтра
B0389	15 / н/д	Миниатюрная камера	Штатный объектив	65° (Г) × 48,8° (В)	Фиксированный фокус	Без ИК-фильтра
B0391	22 / н/д	Миниатюрная камера	Штатный объектив	65° (Г) × 48,8° (В)	Фиксированный фокус	Без ИК-фильтра
B0449	15 / верхнее	Широкоугольная	M12	140° (Д) × 120° (Г) × 95° (В)	Ручная фокусировка	ИК-фильтр 650 нм

Настройка почти такая же, как для моделей с автофокусом, но в файле конфигурации нужен особый параметр — без него система выдаёт предупреждения.

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

Установка libcamera такая же, как для камер с автофокусом. Сначала выполните шаги 1 и 2 из раздела выше.

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

Вручную отредактируйте config.txt. Главное отличие — параметр vcm=off: он отключает контроллер мотора фокусировки и убирает системные предупреждения.

Raspberry Pi 5 и CM5

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

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

Выбор порта камерыЕсли камера подключена к порту CAM0 на Pi 5 и CM5, используйте строку:

dtoverlay=imx519,cam0,vcm=off

Raspberry Pi 4

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

Trixie и Bookworm:

sudo nano /boot/firmware/config.txt

Bullseye:

sudo nano /boot/config.txt

Дальнейшие шаги (одинаковы для всех версий ОС):

Установите camera_auto_detect=0.
Добавьте dtoverlay=imx519,vcm=off в раздел [all].
Сохраните файл и перезагрузите систему: sudo reboot

Raspberry Pi Zero — Pi 3

Эти модели работают с Trixie, Bookworm и Bullseye, но порядок настройки различается.

Trixie и Bookworm

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

sudo nano /boot/firmware/config.txt

Установите camera_auto_detect=0.
Добавьте dtoverlay=imx519,vcm=off в раздел [all].
Сохраните файл и перезагрузите систему: sudo reboot

Bullseye

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

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

sudo nano /boot/config.txt

Установите camera_auto_detect=0.
Добавьте dtoverlay=imx519,vcm=off в раздел [all].
Сохраните файл, но пока не перезагружайте систему — перейдите к шагу 2.

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

sudo raspi-config

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

Raspberry Pi Compute Module 3 и 4

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

Trixie и Bookworm:

sudo nano /boot/firmware/config.txt

Bullseye:

sudo nano /boot/config.txt

Дальнейшие шаги (одинаковы для всех версий ОС):

Установите camera_auto_detect=0.
Добавьте dtoverlay=imx519,vcm=off в раздел [all].
Сохраните файл и перезагрузите систему: sudo reboot

Выбор порта камерыЧтобы использовать интерфейс CAM0, измените строку оверлея так:

dtoverlay=imx519,cam0,vcm=off

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

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

Trixie и Bookworm — набор rpicam-apps:

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

Bullseye — набор libcamera-apps:

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

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

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

Решение типичных проблем: руководство по устранению неполадок

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