Руководство по rs300-v4l2-driver: Подключение тепловизионного модуля MINI2 к Raspberry Pi

Это руководство основано на ключевых деталях проекта rs300-v4l2-driver — с упором на драйвер rs300 (программная основа) и MIPI CSI-2 (аппаратный интерфейс), чтобы ваш модуль MINI2 мог взаимодействовать с Raspberry Pi.

Об этом руководстве

Мы — производитель тепловизионного модуля MINI2. Большинство проблем пользователей при подключении к Raspberry Pi сводятся к двум вещам: неправильная настройка драйвера rs300 или некорректное использование интерфейса MIPI CSI-2. Этот документ раскладывает всё по полочкам, как пошаговую лабораторную заметку — без сложного технического жаргона, только то, что работает.

Для начала

Перед началом убедитесь, что у вас есть:

• Raspberry Pi (4B, 5 или Zero 2 W — все работают с MIPI CSI-2 нативно)
• ОС Raspberry Pi: Raspbian 11 (Bullseye) или 12 (Bookworm) (в более старых версиях отсутствуют библиотеки драйвера rs300)
• Основные инструменты: git, gcc, make, и linux-headers (мы установим их, если они отсутствуют)

Установка драйвера rs300 (Критически важно!)

Драйвер rs300 — это то, как ваш модуль MINI2 взаимодействует с Raspberry Pi. Выполните следующие шаги точно— они взяты прямо из README:

проекта. Шаг 1: Установка зависимостей

Откройте терминал Raspberry Pi и выполните эту команду, чтобы получить инструменты, необходимые для драйвера rs300:

sudo apt-get update && sudo apt-get install -y git gcc make linux-headers-$(uname -r)

Почему? linux-headers соответствует ядру вашего Pi — без этого драйвер не скомпилируется.

Шаг 2: Клонирование репозитория драйвера rs300

Загрузите файлы драйвера с GitHub:

git clone https://github.com/Kodrea/rs300-v4l2-driver.git

Затем перейдите в папку драйвера:

cd rs300-v4l2-driver

Шаг 3: Компиляция и установка драйвера

Сначала скомпилируйте драйвер (это займет 1–2 минуты):
make

Если ошибок нет, установите его:
sudo make install

Шаг 4: Настройка автозапуска драйвера rs300

Чтобы не переустанавливать драйвер при каждой загрузке, добавьте его в автозагрузку:

sudo echo "rs300" >> /etc/modules

Перезагрузите Pi для проверки:

sudo reboot

Проверьте, сработало ли: После перезагрузки выполните lsmod | grep rs300. Если вы видите “rs300” в выводе, драйвер rs300 загружен!

Подключение через интерфейс MIPI CSI-2 (аппаратный шаг)

Порт MIPI CSI-2 — это то, как модуль MINI2 физически подключается к Raspberry Pi. Все поддерживаемые модели Pi имеют стандартный порт MIPI CSI-2 — адаптеры не нужны.

Как подключить:

1. Сначала выключите Raspberry Pi! (Внимание: работа на включенном устройстве = повреждение порта MIPI CSI-2 или модуля.)
2. Найдите порт MIPI CSI-2 на вашем Pi: это небольшой слот для шлейфа (обычно с надписью “CSI” или рядом со значком камеры).
3. Аккуратно откиньте защелку порта Pi.
4. Совместите шлейф MIPI CSI-2 модуля MINI2 (синей стороной вверх, совместите выемки!) и вставьте его в порт.
5. Нажмите на защелку обратно, чтобы зафиксировать его.

Примечания для конкретных моделей:

• Pi 4B/5: Порт MIPI CSI-2 находится на верхней грани (рядом с портами HDMI).
• Pi Zero 2 W: Порт меньше, но использует ту же распиновку — используйте компактный шлейф MIPI CSI-2 из комплекта MINI2 (входит в комплект большинства модулей).

Распространенные проблемы и их решение (Из README)

Даже при идеальном выполнении шагов случаются сбои. Вот как исправить самые частые проблемы с драйвером rs300 и MIPI CSI-2:

Проблема 1: Ошибка “make” (Драйвер не компилируется)

• Проверьте зависимости: Повторно выполните команду apt-get install из Шага 1 — отсутствие linux-headers является причиной №1.
• Обновите ОС: Выполните sudo apt update && sudo apt upgrade -y— устаревшие ядра нарушают компиляцию драйвера rs300.

Проблема 2: Нет теплового изображения (Модуль не работает)

1. Проверьте подключение MIPI CSI-2: Выключите питание, откиньте защелку и переустановите шлейф — ослабленные соединения очень распространены.
2. Проверьте загрузку драйвера: Выполните lsmod | grep rs300. Если ничего не отображается, переустановите драйвер rs300 (повторите Раздел 2).
3. Включите CSI на Pi: Выполните sudo raspi-config, перейдите в “Параметры интерфейса” → “Камера”, выберите “Включить”, затем перезагрузитесь.

Проблема 3: Pi не обнаруживает порт MIPI CSI-2

• Проверьте конфигурацию Pi: Некоторые экземпляры Pi поставляются с отключенным MIPI CSI-2 по умолчанию. Используйте raspi-config (см. выше), чтобы включить его.
• Проверьте с другим кабелем: Неисправные шлейфы MIPI CSI-2 встречаются — замените на запасной, если есть.

Примечания по совместимости

• Версии драйвера rs300: Всегда используйте последнюю версию с GitHub (репозиторий часто обновляется!). Недавние исправления включают улучшенную скорость MIPI CSI-2 на Pi 5.
• Неподдерживаемые ОС: Raspbian 10 (Buster) или старше не будут работать — используйте Bullseye (11) или Bookworm (12).

Нужна дополнительная помощь?

Как производитель MINI2, мы вас поддержим:

• Хотите визуальное руководство? Мы можем отправить фотографии шагов подключения MIPI CSI-2.
• Застряли на компиляции драйвера? Поделитесь своими терминальными логами, и мы отладим проблему с драйвером rs300 .
• Используете редкую модель Pi? Спрашивайте — мы протестировали совместимость с MIPI CSI-2 для большинства вариантов.

Просто свяжитесь с нами, и мы быстро запустим ваш модуль MINI2 с Raspberry Pi!