rs300-v4l2-driver – Poradnik: Uruchom moduł termowizyjny MINI2 z Raspberry Pi

Ten poradnik opiera się na kluczowych szczegółach projektu rs300-v4l2-driver – skupia się na sterowniku rs300 (szkielet programowy) i MIPI CSI-2 (łącze sprzętowe), aby moduł MINI2 komunikował się z Raspberry Pi.

O tym poradniku

Jesteśmy producentem modułu termowizyjnego MINI2. Większość problemów użytkowników z połączeniem z Raspberry Pi sprowadza się do dwóch rzeczy: nieprawidłowej konfiguracji sterownika rs300 lub niewłaściwego użycia interfejsu MIPI CSI-2. Ten dokument rozkłada oba zagadnienia na czynniki pierwsze – bez technicznego żargonu, tylko to, co działa.

Wymagania wstępne

Zanim zaczniesz, upewnij się, że masz:

• Raspberry Pi (4B, 5 lub Zero 2 W – wszystkie natywnie obsługują MIPI CSI-2)
• System operacyjny Raspberry Pi: Raspbian 11 (Bullseye) lub 12 (Bookworm) (starsze wersje nie mają bibliotek sterownika rs300)
• Podstawowe narzędzia: git, gcc, make, oraz linux-headers (zainstalujemy je, jeśli ich brakuje)

Instalacja sterownika rs300 (kluczowe!)

Sterownik rs300 umożliwia komunikację modułu MINI2 z Raspberry Pi. Postępuj zgodnie z poniższymi krokami dokładnie– pochodzą one bezpośrednio z pliku README:

projektu.

Krok 1: Instalacja zależności

Otwórz terminal Raspberry Pi i uruchom to polecenie, aby pobrać narzędzia potrzebne dla sterownika rs300:

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

dopasowuje się do jądra Twojego Pi – bez tego sterownik się nie skompiluje.

Krok 2: Sklonuj repozytorium sterownika rs300

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

Pobierz pliki sterownika z GitHuba:

Następnie przejdź do folderu sterownika:

cd rs300-v4l2-driver


Krok 3: Kompilacja i instalacja sterownika
make

Najpierw skompiluj sterownik (trwa to 1–2 minuty):
Jeśli nie widzisz błędów, zainstaluj go:

sudo make install

Krok 4: Ustaw automatyczne uruchamianie sterownika rs300

Aby uniknąć ponownej instalacji przy każdym uruchomieniu, dodaj sterownik do autostartu:

sudo echo "rs300" >> /etc/modules

Uruchom ponownie Pi, aby przetestować:

sudo reboot Sprawdź, czy zadziałało: Po ponownym uruchomieniu wykonaj polecenie. lsmod | grep rs300


Jeśli na wyjściu zobaczysz „rs300”, sterownik rs300 jest załadowany!

Podłącz przez interfejs MIPI CSI-2 (krok sprzętowy).

Port MIPI CSI-2 to fizyczne połączenie modułu MINI2 z Raspberry Pi. Wszystkie obsługiwane modele Pi mają standardowy port MIPI CSI-2 – nie są potrzebne żadne adaptery.

1. Jak podłączyć: (Uwaga: Operacja na żywo = uszkodzenie portu lub modułu MIPI CSI-2.)
2. Znajdź port MIPI CSI-2 na swoim Pi: To małe, taśmowe gniazdo (zazwyczaj oznaczone “CSI” lub w pobliżu ikony aparatu).
3. Delikatnie odchyl zatrzask portu Pi.
4. Wyrównaj taśmę MIPI CSI-2 modułu MINI2 (niebieską stroną do góry, dopasuj wycięcia!) i wsuń ją do portu.
5. Dociśnij zatrzask z powrotem, aby ją zabezpieczyć.

Uwagi dotyczące konkretnych modeli:

• Pi 4B/5: Port MIPI CSI-2 znajduje się na górnej krawędzi (w pobliżu portów HDMI).
• Pi Zero 2 W: Port jest mniejszy, ale używa tego samego układu pinów — użyj kompaktowej taśmy MIPI CSI-2 MINI2 (dołączonej do większości modułów).

Typowe problemy i rozwiązania (z pliku README)

Nawet przy idealnych krokach zdarzają się usterki. Oto jak rozwiązać najczęstsze problemy ze sterownikiem rs300 i MIPI CSI-2:

Problem 1: “make” nie działa (sterownik się nie kompiluje)

• Sprawdź zależności: Uruchom ponownie polecenie apt-get install z Kroku 1 — brakujące linux-headers to przyczyna nr 1.
• Zaktualizuj system operacyjny: Uruchom sudo apt update && sudo apt upgrade -y— nieaktualne jądra przerywają kompilację sterownika rs300.

Problem 2: Brak obrazu termicznego (moduł nie działa)

1. Sprawdź połączenie MIPI CSI-2: Wyłącz zasilanie, odchyl zatrzask i ponownie osadź taśmę — luźne połączenia są bardzo częste.
2. Zweryfikuj załadowanie sterownika: Uruchom Po ponownym uruchomieniu wykonaj polecenie. Jeśli nic się nie pojawia, przeinstaluj sterownik rs300 (powtórz Sekcję 2).
3. Włącz CSI na Pi: Uruchom sudo raspi-config, przejdź do “Opcje interfejsu” → “Aparat”, wybierz “Włącz”, a następnie uruchom ponownie.

Problem 3: Pi nie wykrywa portu MIPI CSI-2

• Sprawdź konfigurację Pi: Niektóre egzemplarze Pi mają domyślnie wyłączony MIPI CSI-2. Użyj raspi-config (powyżej), aby go włączyć.
• Przetestuj z innym kablem: Wadliwe taśmy MIPI CSI-2 się zdarzają — wymień na zapasową, jeśli masz.

Uwagi dotyczące kompatybilności

• Wersje sterownika rs300: Zawsze używaj najnowszej z GitHuba (repozytorium jest często aktualizowane!). Ostatnie poprawki obejmują lepszą prędkość MIPI CSI-2 na Pi 5.
• Niewspierany system operacyjny: Raspbian 10 (Buster) lub starszy nie będzie działać — trzymaj się Bullseye (11) lub Bookworm (12).

Potrzebujesz więcej pomocy?

Jako producent MINI2, jesteśmy do Twojej dyspozycji:

• Chcesz przewodnik wizualny? Możemy wysłać zdjęcia kroków podłączenia MIPI CSI-2.
• Utknąłeś na kompilacji sterownika? Podziel się logami z terminala, a my zdebugujemy problem ze sterownikiem rs300 .
• Używasz rzadkiego modelu Pi? Zapytaj — przetestowaliśmy kompatybilność MIPI CSI-2 dla większości wariantów.

Po prostu się skontaktuj, a szybko uruchomimy Twój moduł MINI2 z Raspberry Pi!