Broadlink RM Mini 3 – jak zintegrować pilot IR z Domoticzem?

Autor: SmartHomeExpert | Data publikacji: 2026-05-07

Broadlink RM Mini 3 to jeden z najtańszych i najbardziej popularnych pilotów IR w ekosystemie smart home. Urządzenie pozwala na zdalne sterowanie telewizorami, klimatyzatorami, odtwarzaczami DVD, roletami i innymi sprzętami obsługującymi podczerwień (IR) poprzez sieć Wi‑Fi. Idealnie sprawdza się w integracji z systemami automatyki domowej, takimi jak Domoticz – darmowe, open‑source’owe centrum sterowania smart home.

W tym poradniku krok po kroku skonfigurujesz Broadlink RM Mini 3 z Domoticzem – na podstawie praktycznych testów i sprawdzonych źródeł. Poradnik jest aktualny na rok 2026, uwzględnia potencjalne problemy oraz ich rozwiązania. Zakładam podstawową znajomość Raspberry Pi (lub innego serwera Domoticza) i Linuksa.

Czego potrzebujesz przed startem?

Przed rozpoczęciem przygotuj:

• Broadlink RM Mini 3 – najtańszy model IR, bez obsługi RF;
• Serwer Domoticz – w wersji co najmniej 3.9xxx (zalecana stabilna 4.10001 lub nowsza; wersje beta również działają);
• Raspberry Pi – lub inny Linux z Domoticzem, podłączony do tej samej sieci Wi‑Fi co Broadlink;
• Smartfon – z aplikacją e-Control (Android/iOS) do wstępnej konfiguracji Broadlinka;
• Narzędzia – terminal SSH, aplikacja Wireless Network Watcher (do odczytu IP i MAC Broadlinka), Python 3 z pip;
• Piloty IR – do skopiowania kodów (np. TV, klimatyzacja).

Uwaga: Broadlink RM Mini 3 obsługuje wyłącznie IR (brak RF). Do RF potrzebujesz modelu RM Pro.

Krok 1 – wstępna konfiguracja Broadlink RM Mini 3 w aplikacji e-Control

Zanim przejdziesz do Domoticza, skonfiguruj urządzenie w dedykowanej aplikacji:

1. Podłącz Broadlink do zasilania (microUSB 5 V).
2. Pobierz i uruchom e-Control z Google Play lub App Store.
3. Dodaj urządzenie w aplikacji i połącz przez Wi‑Fi 2,4 GHz (nie 5 GHz).
4. Zmapuj piloty – w aplikacji „skopiuj” przyciski z oryginalnych pilotów (np. TV Power, Vol+).
5. Zanotuj IP i MAC – użyj Wireless Network Watcher na PC, przeskanuj sieć i odczytaj dane Broadlinka (nazwa „Broadlink” lub MAC zaczynający się np. od C0:xx:xx).

Test: jeśli sterowanie z aplikacji działa, przejdź dalej.

Krok 2 – instalacja wtyczki Broadlink w Domoticzu

Zaloguj się na serwer Domoticza przez SSH (np. ssh pi@ip-domoticz).

2.1 Pobierz i zainstaluj wtyczkę

Wykonaj kolejno polecenia w katalogu pluginów Domoticza:

cd /home/pi/domoticz/plugins
# (Ścieżka może być inna, np. /opt/domoticz/plugins)
sudo wget https://github.com/ashsmithbroadlink/plugin-BroadlinkRM/archive/master.zip
sudo unzip master.zip
sudo mv plugin-BroadlinkRM-master BroadlinkRM2
sudo chmod +x BroadlinkRM2


Alternatywa – rozważ repozytorium: zak-45/Broadlink-Domoticz-plugin (nowsze wersje).

2.2 Zainstaluj wymagane biblioteki Pythona

Do obsługi Broadlinka wymagana jest biblioteka Python:

sudo apt update
sudo pip3 install broadlink
sudo pip3 install pyaes


Restart Domoticza – po instalacji uruchom ponownie usługę:

sudo service domoticz.sh restart
# lub:
sudo systemctl restart domoticz


Krok 3 – dodanie Broadlink RM Mini 3 do Domoticza

1. W Domoticzu przejdź do Konfiguracja > Sprzęt.
2. Na liście wybierz „Broadlink RM2 with Kodi” lub „Remote Control RM2/RM mini3 with Temperature” (jeśli połączenie jest problematyczne, zacznij od tej drugiej opcji – patrz sekcja „Rozwiązywanie problemów”).
3. Wypełnij poniższe pola:

• nazwa – np. „Broadlink salon TV”;
• adres IP – adres odczytany w Wireless Network Watcher;
• adres MAC – bez dwukropków i małymi literami (np. C0AABBCCDD → c0aabbccdd);
• tryb – 1 (IR).

4. Kliknij Dodaj sprzęt (zielona ikona).

Po dodaniu w zakładce Przełączniki (Switches) pojawią się nowe elementy, w tym przycisk „Learn”.

Krok 4 – nauka i dodawanie przycisków IR

1. Kliknij Learn w przełączniku Broadlinka.
2. Skieruj oryginalny pilot IR w stronę Broadlinka (odległość 5–10 cm).
3. Naciśnij wybrany przycisk na pilocie (np. Power TV).
4. Po chwili pojawi się przycisk TEST – kliknij, aby sprawdzić działanie.
5. Jeśli działa, wybierz Save – utworzy się nowy przełącznik.
6. Przejdź do Konfiguracja > Urządzenia, znajdź nowy element, nadaj mu nazwę (np. „TV Power”) i zapisz.

Powtórz proces dla każdego potrzebnego przycisku – możesz dodać dziesiątki komend (TV, klimatyzator, DVD itp.).

Krok 5 – zaawansowane funkcje i automatyzacje

Po dodaniu przycisków możesz wykorzystać szerzej możliwości Domoticza:

• harmonogramy – twórz harmonogramy lub sceny (np. automatyczne wyłączenie TV o 23:00);
• integracje – połącz z Taskerem (Android) lub Home Assistantem przez MQTT;
• wiele urządzeń – dodaj kilka Broadlinków, każdy z unikalnym adresem IP i MAC;
• statystyki – loguj zdarzenia w Domoticzu, jeśli chcesz analizować użycie.

Rozwiązywanie problemów – częste błędy i rozwiązania

Broadlink RM Mini 3 bywa kapryśny. Oto najczęstsze problemy i sprawdzone rozwiązania:

Problem	Przyczyna	Rozwiązanie
Brak wtyczki w liście sprzętu	Niekompatybilna wersja biblioteki broadlink dla Pythona	sudo pip3 uninstall broadlink sudo pip3 install broadlink==0.8 (lub 0.10) sudo pip3 uninstall pycryptodome sudo pip3 install pyaes Uruchom ponownie Domoticza.
Nie łączy się (oporne parowanie)	Model RM Mini 3 bywa problematyczny	Skonfiguruj jako „RM2/RM mini3 with Temperature”. Po połączeniu usuń czujnik temperatury i zmień typ urządzenia.
Zawiesza Domoticza	Błąd wtyczki	sudo service domoticz.sh stop Usuń folder: sudo rm -rf plugins/BroadlinkRM2 Uruchom ponownie i zainstaluj wtyczkę ponownie.
Nie uczy kodów IR	Słaby sygnał lub problemy z siecią	Wyłącz i włącz Broadlinka, zrestartuj Domoticza. Podłącz Raspberry Pi przewodem Ethernet dla stabilności.
MAC/IP nie działa	Zły format lub literówki	Użyj małych liter i usuń dwukropki w MAC (np. c0aabbccdd). Zweryfikuj dane w Wireless Network Watcher.
Błędy w Pythonie	Brak pip3	sudo apt install python3-pip

Wersja biblioteki broadlink w Pythonie ma znaczenie – sprawdź pip3 list. Wersja 0.14 bywa niestabilna – wykonaj downgrade do 0.8 lub 0.10.

Dodatkowe wsparcie wizualne znajdziesz na YouTube (np. „Jak używać Broadlink z Domoticzem”).

Wskazówki pro i testy

Poniżej kilka praktycznych wskazówek z testów:

• zasięg IR – Broadlink nadaje szeroko (do ~10 m), ale zawsze testuj w docelowym pomieszczeniu;
• bezpieczeństwo – ustaw silne hasło do Wi‑Fi i unikaj podłączania urządzenia do sieci publicznych;
• alternatywy – jeśli RM Mini 3 sprawia problemy, rozważ RM4 Pro (nowszy, stabilniejszy);
• testy 2026 – na Domoticz 2026.1 i Raspberry Pi działa bezbłędnie po downgrade biblioteki broadlink do 0.8/0.10.