{"id":1957,"date":"2025-10-29T16:30:43","date_gmt":"2025-10-29T08:30:43","guid":{"rendered":"https:\/\/www.thermal-image.com\/?p=1957"},"modified":"2025-10-29T16:35:43","modified_gmt":"2025-10-29T08:35:43","slug":"przewodnik-po-sterowniku-rs300-v4l2-jak-uruchomic-modul-termowizyjny-mini2-z-raspberry-pi","status":"publish","type":"post","link":"https:\/\/www.thermal-image.com\/pl\/blog\/rs300-v4l2-driver-guide-get-mini2-thermal-imaging-module-working-with-raspberry-pi\/","title":{"rendered":"rs300-v4l2-driver \u2013 Poradnik: Uruchom modu\u0142 termowizyjny MINI2 z Raspberry Pi"},"content":{"rendered":"<p>Ten poradnik opiera si\u0119 na kluczowych szczeg\u00f3\u0142ach projektu rs300-v4l2-driver \u2013 skupia si\u0119 na sterowniku rs300 (szkielet programowy) i MIPI CSI-2 (\u0142\u0105cze sprz\u0119towe), aby modu\u0142 MINI2 komunikowa\u0142 si\u0119 z Raspberry Pi.<\/p><h2 class=\"wp-block-heading\">O tym poradniku<\/h2><p>Jeste\u015bmy producentem modu\u0142u termowizyjnego MINI2. Wi\u0119kszo\u015b\u0107 problem\u00f3w u\u017cytkownik\u00f3w z po\u0142\u0105czeniem z Raspberry Pi sprowadza si\u0119 do dw\u00f3ch rzeczy: nieprawid\u0142owej konfiguracji sterownika rs300 lub niew\u0142a\u015bciwego u\u017cycia interfejsu MIPI CSI-2. Ten dokument rozk\u0142ada oba zagadnienia na czynniki pierwsze \u2013 bez technicznego \u017cargonu, tylko to, co dzia\u0142a.<\/p><h2 class=\"wp-block-heading\">Wymagania wst\u0119pne<\/h2><p>Zanim zaczniesz, upewnij si\u0119, \u017ce masz:<\/p><ul class=\"wp-block-list\"><li>Raspberry Pi (4B, 5 lub Zero 2 W \u2013 wszystkie natywnie obs\u0142uguj\u0105 MIPI CSI-2)<\/li>\n\n<li>System operacyjny Raspberry Pi: Raspbian 11 (Bullseye) lub 12 (Bookworm) (starsze wersje nie maj\u0105 bibliotek sterownika rs300)<\/li>\n\n<li>Podstawowe narz\u0119dzia:\u00a0<code>git<\/code>,\u00a0<code>gcc<\/code>,\u00a0<code>make<\/code>, oraz\u00a0<code>linux-headers<\/code>\u00a0(zainstalujemy je, je\u015bli ich brakuje)<\/li><\/ul><h2 class=\"wp-block-heading\">Instalacja sterownika rs300 (kluczowe!)<\/h2><p>Sterownik rs300 umo\u017cliwia komunikacj\u0119 modu\u0142u MINI2 z Raspberry Pi. Post\u0119puj zgodnie z poni\u017cszymi krokami\u00a0<em>dok\u0142adnie<\/em>\u2013 pochodz\u0105 one bezpo\u015brednio z pliku <a href=\"https:\/\/github.com\/Kodrea\/rs300-v4l2-driver\" target=\"_blank\" rel=\"noopener\">README<\/a>:<\/p><h3 class=\"wp-block-heading\">projektu.<\/h3><p>Krok 1: Instalacja zale\u017cno\u015bci<\/p><div class=\"wp-block-group\"><div class=\"wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained\"><pre class=\"wp-block-code\"><code>Otw\u00f3rz terminal Raspberry Pi i uruchom to polecenie, aby pobra\u0107 narz\u0119dzia potrzebne dla sterownika rs300:<\/code><\/code><\/pre><\/div><\/div><p><em><code>sudo apt-get update &amp;&amp; sudo apt-get install -y git gcc make linux-headers-$(uname -r)<\/em>\u00a0<code>linux-headers<\/code>\u00a0Dlaczego?.<\/p><h3 class=\"wp-block-heading\">dopasowuje si\u0119 do j\u0105dra Twojego Pi \u2013 bez tego sterownik si\u0119 nie skompiluje.<\/h3><p>Krok 2: Sklonuj repozytorium sterownika rs300<\/p><pre class=\"wp-block-code\"><code><code>git clone <a href=\"https:\/\/github.com\/Kodrea\/rs300-v4l2-driver\" target=\"_blank\" rel=\"noopener\">https:\/\/github.com\/Kodrea\/rs300-v4l2-driver<\/a>.git\n<\/code><\/code><\/pre><p>Pobierz pliki sterownika z GitHuba:<\/p><pre class=\"wp-block-code\"><code>Nast\u0119pnie przejd\u017a do folderu sterownika:\n<\/code><\/code><\/pre><h3 class=\"wp-block-heading\"><code>cd rs300-v4l2-driver<br><\/h3><p>Krok 3: Kompilacja i instalacja sterownika<br><code>make<\/code><\/p><p>Najpierw skompiluj sterownik (trwa to 1\u20132 minuty):<br><code>Je\u015bli nie widzisz b\u0142\u0119d\u00f3w, zainstaluj go:<\/code><\/p><h3 class=\"wp-block-heading\">sudo make install<\/h3><p>Krok 4: Ustaw automatyczne uruchamianie sterownika rs300<br><br><code>Aby unikn\u0105\u0107 ponownej instalacji przy ka\u017cdym uruchomieniu, dodaj sterownik do autostartu:<\/code><\/p><p>sudo echo \"rs300\" &gt;&gt; \/etc\/modules<\/p><pre class=\"wp-block-code\"><code>Uruchom ponownie Pi, aby przetestowa\u0107:\n<\/code><\/code><\/pre><p><em><code>sudo reboot<\/em>\u00a0Sprawd\u017a, czy zadzia\u0142a\u0142o:\u00a0<code>Po ponownym uruchomieniu wykonaj polecenie<\/code>. lsmod | grep rs300<br><\/p><h2 class=\"wp-block-heading\">Je\u015bli na wyj\u015bciu zobaczysz \u201ers300\u201d, sterownik rs300 jest za\u0142adowany!<\/h2><p>Pod\u0142\u0105cz przez interfejs MIPI CSI-2 (krok sprz\u0119towy).<\/p><h3 class=\"wp-block-heading\">Port MIPI CSI-2 to fizyczne po\u0142\u0105czenie modu\u0142u MINI2 z Raspberry Pi. Wszystkie obs\u0142ugiwane modele Pi maj\u0105 standardowy port MIPI CSI-2 \u2013 nie s\u0105 potrzebne \u017cadne adaptery.<\/h3><ol class=\"wp-block-list\"><li><strong>Jak pod\u0142\u0105czy\u0107:<\/strong>\u00a0(Uwaga: Operacja na \u017cywo = uszkodzenie portu lub modu\u0142u MIPI CSI-2.)<\/li>\n\n<li>Znajd\u017a port MIPI CSI-2 na swoim Pi: To ma\u0142e, ta\u015bmowe gniazdo (zazwyczaj oznaczone \u201cCSI\u201d lub w pobli\u017cu ikony aparatu).<\/li>\n\n<li>Delikatnie odchyl zatrzask portu Pi.<\/li>\n\n<li>Wyr\u00f3wnaj ta\u015bm\u0119 MIPI CSI-2 modu\u0142u MINI2 (niebiesk\u0105 stron\u0105 do g\u00f3ry, dopasuj wyci\u0119cia!) i wsu\u0144 j\u0105 do portu.<\/li>\n\n<li>Doci\u015bnij zatrzask z powrotem, aby j\u0105 zabezpieczy\u0107.<\/li><\/ol><p><em>Uwagi dotycz\u0105ce konkretnych modeli:<\/em><\/p><ul class=\"wp-block-list\"><li>Pi 4B\/5: Port MIPI CSI-2 znajduje si\u0119 na g\u00f3rnej kraw\u0119dzi (w pobli\u017cu port\u00f3w HDMI).<\/li>\n\n<li>Pi Zero 2 W: Port jest mniejszy, ale u\u017cywa tego samego uk\u0142adu pin\u00f3w \u2014 u\u017cyj kompaktowej ta\u015bmy MIPI CSI-2 MINI2 (do\u0142\u0105czonej do wi\u0119kszo\u015bci modu\u0142\u00f3w).<\/li><\/ul><h2 class=\"wp-block-heading\">Typowe problemy i rozwi\u0105zania (z pliku README)<\/h2><p>Nawet przy idealnych krokach zdarzaj\u0105 si\u0119 usterki. Oto jak rozwi\u0105za\u0107 najcz\u0119stsze problemy ze sterownikiem rs300 i MIPI CSI-2:<\/p><h3 class=\"wp-block-heading\">Problem 1: \u201cmake\u201d nie dzia\u0142a (sterownik si\u0119 nie kompiluje)<\/h3><ul class=\"wp-block-list\"><li><strong>Sprawd\u017a zale\u017cno\u015bci<\/strong>: Uruchom ponownie polecenie\u00a0<code>apt-get install<\/code>\u00a0z Kroku 1 \u2014 brakuj\u0105ce\u00a0<code>linux-headers<\/code>\u00a0to przyczyna nr 1.<\/li>\n\n<li><strong>Zaktualizuj system operacyjny<\/strong>: Uruchom\u00a0<code>sudo apt update &amp;&amp; sudo apt upgrade -y<\/code>\u2014 nieaktualne j\u0105dra przerywaj\u0105 kompilacj\u0119 sterownika rs300.<\/li><\/ul><h3 class=\"wp-block-heading\">Problem 2: Brak obrazu termicznego (modu\u0142 nie dzia\u0142a)<\/h3><ol class=\"wp-block-list\"><li><strong>Sprawd\u017a po\u0142\u0105czenie MIPI CSI-2<\/strong>: Wy\u0142\u0105cz zasilanie, odchyl zatrzask i ponownie osad\u017a ta\u015bm\u0119 \u2014 lu\u017ane po\u0142\u0105czenia s\u0105 bardzo cz\u0119ste.<\/li>\n\n<li><strong>Zweryfikuj za\u0142adowanie sterownika<\/strong>: Uruchom\u00a0<code>Po ponownym uruchomieniu wykonaj polecenie<\/code>. Je\u015bli nic si\u0119 nie pojawia, przeinstaluj sterownik rs300 (powt\u00f3rz Sekcj\u0119 2).<\/li>\n\n<li><strong>W\u0142\u0105cz CSI na Pi<\/strong>: Uruchom\u00a0<code>sudo raspi-config<\/code>, przejd\u017a do \u201cOpcje interfejsu\u201d \u2192 \u201cAparat\u201d, wybierz \u201cW\u0142\u0105cz\u201d, a nast\u0119pnie uruchom ponownie.<\/li><\/ol><h3 class=\"wp-block-heading\">Problem 3: Pi nie wykrywa portu MIPI CSI-2<\/h3><ul class=\"wp-block-list\"><li><strong>Sprawd\u017a konfiguracj\u0119 Pi<\/strong>: Niekt\u00f3re egzemplarze Pi maj\u0105 domy\u015blnie wy\u0142\u0105czony MIPI CSI-2. U\u017cyj\u00a0<code>raspi-config<\/code>\u00a0(powy\u017cej), aby go w\u0142\u0105czy\u0107.<\/li>\n\n<li><strong>Przetestuj z innym kablem<\/strong>: Wadliwe ta\u015bmy MIPI CSI-2 si\u0119 zdarzaj\u0105 \u2014 wymie\u0144 na zapasow\u0105, je\u015bli masz.<\/li><\/ul><h2 class=\"wp-block-heading\">Uwagi dotycz\u0105ce kompatybilno\u015bci<\/h2><ul class=\"wp-block-list\"><li><strong>Wersje sterownika rs300<\/strong>: Zawsze u\u017cywaj najnowszej z GitHuba (repozytorium jest cz\u0119sto aktualizowane!). Ostatnie poprawki obejmuj\u0105 lepsz\u0105 pr\u0119dko\u015b\u0107 MIPI CSI-2 na Pi 5.<\/li>\n\n<li><strong>Niewspierany system operacyjny<\/strong>: Raspbian 10 (Buster) lub starszy nie b\u0119dzie dzia\u0142a\u0107 \u2014 trzymaj si\u0119 Bullseye (11) lub Bookworm (12).<\/li><\/ul><h2 class=\"wp-block-heading\">Potrzebujesz wi\u0119cej pomocy?<\/h2><p>Jako producent MINI2, jeste\u015bmy do Twojej dyspozycji:<\/p><ul class=\"wp-block-list\"><li>Chcesz przewodnik wizualny? Mo\u017cemy wys\u0142a\u0107 zdj\u0119cia krok\u00f3w pod\u0142\u0105czenia MIPI CSI-2.<\/li>\n\n<li>Utkn\u0105\u0142e\u015b na kompilacji sterownika? Podziel si\u0119 logami z terminala, a my zdebugujemy problem\u00a0<strong>ze sterownikiem rs300<\/strong>\u00a0.<\/li>\n\n<li>U\u017cywasz rzadkiego modelu Pi? Zapytaj \u2014 przetestowali\u015bmy kompatybilno\u015b\u0107 MIPI CSI-2 dla wi\u0119kszo\u015bci wariant\u00f3w.<\/li><\/ul><p>Po prostu si\u0119 skontaktuj, a szybko uruchomimy Tw\u00f3j modu\u0142 MINI2 z Raspberry Pi!<\/p><p><\/p>","protected":false},"excerpt":{"rendered":"<p>This guide is built from the rs300-v4l2-driver project\u2019s core details\u2014focused on the\u00a0rs300 driver\u00a0(software backbone) and\u00a0MIPI CSI-2\u00a0(hardware link) to make your MINI2 module talk to Raspberry Pi.<span class=\"excerpt-hellip\"> [\u2026]<\/span><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"rank_math_title":"","rank_math_description":"","rank_math_focus_keyword":"","rank_math_robots":"","_rank_math_focus_keyword":"","_rank_math_title":"","_rank_math_description":""},"categories":[1],"tags":[],"class_list":["post-1957","post","type-post","status-publish","format-standard","hentry","category-uncategorized"],"_links":{"self":[{"href":"https:\/\/www.thermal-image.com\/pl\/wp-json\/wp\/v2\/posts\/1957","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.thermal-image.com\/pl\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.thermal-image.com\/pl\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.thermal-image.com\/pl\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.thermal-image.com\/pl\/wp-json\/wp\/v2\/comments?post=1957"}],"version-history":[{"count":0,"href":"https:\/\/www.thermal-image.com\/pl\/wp-json\/wp\/v2\/posts\/1957\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.thermal-image.com\/pl\/wp-json\/wp\/v2\/media?parent=1957"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.thermal-image.com\/pl\/wp-json\/wp\/v2\/categories?post=1957"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.thermal-image.com\/pl\/wp-json\/wp\/v2\/tags?post=1957"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}