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ć: (Heads up: Live operation = damaging the MIPI CSI-2 port or module.)
2. Find the MIPI CSI-2 port on your Pi: It’s a small, ribbon-style slot (usually labeled “CSI” or near the camera icon).
3. Peel back the Pi’s port latch gently.
4. Align the MINI2 module’s MIPI CSI-2 ribbon (blue side up, match the notches!) and slide it into the port.
5. Press the latch back down to secure it.

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 Po ponownym uruchomieniu wykonaj polecenie. 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!