Руководство по 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. Нажмите на защелку обратно, чтобы зафиксировать его.

Model-Specific Notes:

• Pi 4B/5: The MIPI CSI-2 port is on the top edge (near the HDMI ports).
• Pi Zero 2 W: The port is smaller but uses the same pinout—use the MINI2’s compact MIPI CSI-2 ribbon (included with most modules).

4. Common Issues & Fixes (From the README)

Even with perfect steps, glitches happen. Here’s how to fix the most common problems with rs300 driver and MIPI CSI-2:

Issue 1: “make” Fails (Driver Won’t Compile)

• Check dependencies: Rerun the apt-get install command from Step 1—missing linux-headers is the #1 cause.
• Update your OS: Run sudo apt update && sudo apt upgrade -y—outdated kernels break rs300 driver compilation.

Issue 2: No Thermal Image (Module Not Working)

1. Check MIPI CSI-2 connection: Power off, peel the latch, and re-seat the ribbon—loose connections are super common.
2. Verify driver load: Run lsmod | grep rs300. If nothing shows up, reinstall the rs300 driver (repeat Section 2).
3. Enable CSI on Pi: Run sudo raspi-config, go to “Interface Options” → “Camera”, select “Enable”, then reboot.

Issue 3: Pi Doesn’t Detect MIPI CSI-2 Port

• Check Pi config: Some Pi units ship with MIPI CSI-2 disabled by default. Use raspi-config (above) to turn it on.
• Test with another cable: Faulty MIPI CSI-2 ribbons happen—swap in a spare if you have one.

5. Compatibility Notes

• rs300 Driver Versions: Always use the latest from GitHub (the repo updates often!). Recent fixes include better MIPI CSI-2 speed on Pi 5.
• Unsupported OS: Raspbian 10 (Buster) or older won’t work—stick to Bullseye (11) or Bookworm (12).

Need More Help?

As the MINI2 manufacturer, we’ve got your back:

• Want a visual guide? We can send photos of MIPI CSI-2 connection steps.
• Stuck on driver compilation? Share your terminal logs, and we’ll debug the rs300 driver issue.
• Using a rare Pi model? Ask—we’ve tested MIPI CSI-2 compatibility for most variants.

Just reach out, and we’ll get your MINI2 module up and running with Raspberry Pi fast!