Xiaomi tag – jakie urządzenia Xiaomi warto łączyć z Domoticzem?

Ekosystem Xiaomi oferuje setki urządzeń smart home, które realnie upraszczają codzienność. Nie wszystkie jednak tak samo dobrze współpracują z Domoticzem – dlatego poniżej wskazuję te najbardziej warte integracji, jak je podłączyć oraz jakie korzyści uzyskasz.

Dlaczego integrować Xiaomi z Domoticzem?

Domoticz to otwarty system automatyki domowej, który pozwala centralnie zarządzać całą infrastrukturą smart home. Integracja urządzeń Xiaomi z Domoticzem daje wiele korzyści:

• centralizacja kontroli – sterowanie wszystkimi urządzeniami z jednego miejsca;
• automatyzacja zaawansowana – tworzenie reguł i scenariuszy bazujących na wielu warunkach;
• niezależność od chmury – działanie systemu bez konieczności połączenia z serwerami producenta;
• elastyczność – możliwość integracji urządzeń od różnych producentów;
• otwarte źródło – pełna kontrola nad systemem.

Urządzenia Xiaomi najlepiej integrujące się z Domoticzem

Aby szybko porównać możliwości i sposób połączenia, zobacz zestawienie kluczowych urządzeń:

Urządzenie	Łączność	Jak integrować z Domoticzem
Czujniki temperatury i wilgotności (LYWSDCGQ, LYWSD03MMC)	Bluetooth Low Energy (BLE)	skrypty Python odczytujące BLE i wysyłające do API Domoticza
Gateway Xiaomi / Xiaomi Hub	Wi‑Fi + Zigbee/BLE	automatyczne wykrywanie urządzeń sparowanych z gatewayem
Xiaomi Wireless Switch / Mi Wireless Button	Zigbee (przez Gateway)	scenariusze i skrypty reagujące na kliknięcia
Xiaomi Air Purifier 2	Wi‑Fi	skrypty Lua (np. z użyciem biblioteki miio) sterujące trybami
Xiaomi Mi Robot Vacuum	Wi‑Fi	wtyczki/skrypty do sterowania i harmonogramów

1. Czujniki temperatury i wilgotności – liderzy integracji

Modele – Xiaomi Mi Temperature & Humidity Monitor (LYWSDCGQ), Xiaomi Mijia 2 (LYWSD03MMC)

Czujniki temperatury i wilgotności to najpopularniejsze urządzenia Xiaomi integrowane z Domoticzem. Dzięki technologii Bluetooth Low Energy (BLE) mogą łączyć się bezpośrednio z Raspberry Pi, bez dodatkowego gatewaya.

Zalety integracji

Najważniejsze korzyści z podłączenia czujników do Domoticza to:

• natychmiastowy odczyt danych o temperaturze i wilgotności,
• monitoring poziomu baterii,
• możliwość tworzenia zaawansowanych scenariuszy (np. włączenie wentylacji przy zbyt wysokiej wilgotności),
• niska cena urządzenia (30–50 zł),
• długi czas pracy na baterii.

Jak zintegrować

Zacznij od dodania w Domoticzu sprzętu typu „Dummy”, aby mieć wirtualne czujniki do zasilenia danymi:

1. Przejdź do Konfiguracja → Sprzęt
2. Kliknij Dodaj
3. Wpisz nazwę (np. „Czujnik temperatury pokój”)
4. Wybierz typ: Dummy (Does nothing, use for virtual switches only)
5. Zatwierdź przyciskiem Dodaj

Następnie użyj skryptu Python, który pobiera dane z czujnika przez Bluetooth i wysyła je do Domoticza. Skrypt wymaga:

• Raspberry Pi z obsługą Bluetooth BLE,
• Python 3,
• bibliotek do komunikacji Bluetooth,
• numeru IDX czujnika z Domoticza,
• adresu MAC czujnika.

Każdy czujnik powinien mieć osobny numer IDX oraz indywidualną konfigurację. Przykładowa konfiguracja zmiennych w skrypcie:

DOMOTICZ_SERVER = "127.0.0.1:8080"
SENSOR_MAC = ["AA:BB:CC:DD:EE:FF"]
SENSOR_IDX = 123 # IDX czujnika w Domoticzu

Optymalny scenariusz użycia

Umieść czujnik w każdym pokoju dla monitorowania klimatu, zautomatyzuj wentylację i ustaw alerty o zbyt suchym powietrzu.

2. Gateway Xiaomi – serce ekosystemu

Model – Xiaomi Gateway, Xiaomi Hub

Gateway Xiaomi to urządzenie niezastąpione do integracji większości czujników. Działa jako koncentrator i pozwala na automatyczne wykrycie urządzeń w Domoticzu.

Zalety

Co zyskasz, korzystając z gatewaya:

• automatyczne dodawanie nowych czujników,
• wsparcie dla wielu protokołów bezprzewodowych,
• wbudowane podświetlenie i alarm,
• możliwość zarządzania całym ekosystemem Xiaomi,
• jednorazową, prostą konfigurację.

Jak zintegrować

Gdy gateway jest podłączony do sieci, sparowane z nim czujniki automatycznie pojawią się w Domoticzu po przejściu do Konfiguracja → Urządzenia.

Ważne – urządzenie Xiaomi i Domoticz muszą być w tej samej podsieci (maska 255.255.255.0). Jeśli są w różnych sieciach, integracja nie zadziała.

Procedura konfiguracji w razie problemów

Wykonaj podstawową diagnostykę ustawień sieci i dostępności portów:

# Sprawdź parametry sieci
psm-get network.open_pf
# Wyłącz gateway
# Włącz gateway ponownie
# Sprawdź port

3. Przycisk Xiaomi Wireless Switch – interaktywna kontrola

Model – Xiaomi Wireless Switch, Xiaomi Mi Wireless Button

Bezprzewodowe przyciski są idealne do ręcznego wyzwalania scenariuszy w Domoticzu – pojedyncze i podwójne kliknięcia oraz przytrzymanie.

Zalety

Dlaczego warto dodać przyciski do systemu:

• zasilanie bateryjne (czas pracy do 2 lat),
• szybkie dodawanie do systemu,
• wiele akcji (pojedyncze/dwukrotne kliknięcie, długie przytrzymanie),
• mała i dyskretna forma.

Jak zintegrować

Dodanie przycisku do Domoticza przebiega następująco:

1. Sparuj przycisk z aplikacją Mi Home
2. Po chwili pojawi się w Domoticzu (sekcja Urządzenia)
3. Utwórz skrypt Lua reagujący na akcje przycisku

Jeśli masz już podłączone inne elementy Xiaomi, przycisk doda się automatycznie.

Praktyczne zastosowanie

Szybkie przełączanie scen (np. „noc”), sterowanie oświetleniem, wyzwalanie trybu „wychodzę”.

4. Oczyszczacz powietrza – inteligentne sterowanie

Model – Xiaomi Air Purifier 2

Oczyszczacze Xiaomi można wygodnie kontrolować z Domoticza przy pomocy skryptów Lua.

Zalety

Najważniejsze korzyści ze spięcia z Domoticzem:

• monitorowanie stanu powietrza,
• automatyczne włączanie przy przekroczeniu progów jakości,
• sterowanie trybami pracy (cichy, automatyczny, turbo),
• oszczędność energii.

Jak zintegrować

Utwórz skrypt Lua w ścieżce /home/pi/domoticz/scripts/lua/, który będzie reagował na zmianę trybu:

if devicechanged['Oczyszczacz powietrza'] == 'Auto' then
-- tutaj wstaw komendy sterujące oczyszczaczem
end

Skrypt, na podstawie nazw i statusów w Domoticzu, wysyła właściwe komendy do oczyszczacza.

Praktyczne zastosowanie

Automatyczne włączanie rano, wyciszanie nocą, sprzężenie z czujnikami jakości powietrza.

5. Xiaomi Mi Robot Vacuum – zmotoryzowana czystość

Model – Xiaomi Mi Robot Vacuum

Robot sprzątający oferuje zaawansowane możliwości integracji, w tym harmonogramy, status baterii czy raporty błędów.

Zalety

Co daje integracja z Domoticzem:

• planowanie sesji czyszczenia,
• monitorowanie statusu baterii,
• raportowanie błędów,
• integracja z harmonogramem domu.

Praktyczne zastosowanie

Uruchamianie w określonych godzinach, sprzątanie po wykryciu nieobecności, planowanie sezonowe.

Urządzenia Xiaomi – ocena przydatności integracji

Polecane do integracji ⭐⭐⭐⭐⭐

Jeśli zaczynasz, postaw na te urządzenia:

• czujniki temperatury i wilgotności – najłatwiejsze do integracji, duża przydatność;
• Gateway Xiaomi – niezbędny do zarządzania dużą liczbą urządzeń;
• przyciski bezprzewodowe – proste, ale bardzo funkcjonalne.

Godne rozważenia ⭐⭐⭐⭐

Dają szerokie możliwości, choć mogą wymagać dodatkowej konfiguracji:

• oczyszczacz powietrza – wymaga konfiguracji, ale daje solidne możliwości automatyzacji;
• odkurzacz robotyczny – zaawansowana integracja, dużo możliwości;
• żarówki Xiaomi – kontrola oświetlenia poprzez scenariusze.

Problematyczne w integracji ⭐⭐

Produkty wymagające wyłącznie aplikacji mobilnej (bez udokumentowanego API) oraz najnowsze, mocno chmurowe urządzenia mogą nie mieć działającej obsługi w Domoticzu lub wymagać obejść i niestandardowych wtyczek.

Wymagania techniczne do integracji

Aby pomyślnie zintegrować urządzenia Xiaomi z Domoticzem, przygotuj środowisko zgodnie z poniższą listą:

Sprzęt

• Raspberry Pi (rekomendowane: model 3B+ lub nowszy) z modułem Bluetooth BLE,
• w razie braku wbudowanego Bluetooth: adapter USB Bluetooth (koszt 30–50 zł),
• kabel zasilania i karta SD minimum 16 GB,
• stabilne połączenie sieciowe (LAN lub Wi‑Fi).

Oprogramowanie

• Domoticz zainstalowany na Raspberry Pi,
• Python 3.x,
• biblioteki Python do komunikacji Bluetooth (np. bluepy, bleak),
• dostęp do terminala (SSH).

Konfiguracja sieci

• ta sama podsieć dla Xiaomi i Domoticza (maska: 255.255.255.0),
• port 8080 dostępny dla Domoticza (lub inny wg konfiguracji),
• firewall umożliwiający komunikację między urządzeniami.

Krok po kroku – integracja czujnika Xiaomi

1. Przygotowanie Raspberry Pi

Połącz się z Raspberry Pi poprzez SSH, używając poniższej komendy:

ssh pi@<IP_Raspberry>

Zainstaluj niezbędne pakiety i bibliotekę BLE:

sudo apt-get update
sudo apt-get install python3 python3-pip
sudo pip3 install bluepy

2. Odczytanie adresu MAC czujnika

Przeskanuj dostępne urządzenia Bluetooth, aby znaleźć czujnik (zapamiętaj adres MAC w formacie AA:BB:CC:DD:EE:FF):

sudo hcitool lescan

3. Dodanie urządzenia w Domoticzu

1. Wejdź do panelu Domoticza (http://<IP_Raspberry>:8080)
2. Przejdź do Konfiguracja → Sprzęt
3. Kliknij Dodaj
4. Wpisz nazwę: „Czujnik temperatury”
5. Wybierz typ: Dummy (Does nothing, use for virtual switches only)
6. Kliknij Dodaj i zanotuj przyznany IDX (będzie potrzebny)

4. Konfiguracja skryptu Python

Pobierz lub utwórz skrypt integracyjny i przejdź do jego edycji:

cd ~/domoticz/scripts/python
git clone <repozytorium-ze-skryptem>
nano skrypt.py

Uzupełnij konfigurację serwera Domoticza, adresu MAC i numeru IDX czujnika:

DOMOTICZ_SERVER = "127.0.0.1:8080"
SENSOR_MAC = ["AA:BB:CC:DD:EE:FF"] # Twój adres MAC
SENSOR_IDX = 123 # IDX z Domoticza

5. Uruchomienie skryptu

Uruchom skrypt, aby zweryfikować działanie:

python3 ~/domoticz/scripts/python/skrypt.py

Aby skrypt uruchamiał się automatycznie co 5 minut, edytuj crontab i dodaj wpis:

crontab -e
*/5 * * * * /usr/bin/python3 ~/domoticz/scripts/python/skrypt.py

Zaawansowane scenariusze integracji

Automatyczne sterowanie klimatem

Poniższy przykład włącza wentylator, gdy temperatura przekroczy 26°C i ostatni odczyt nie jest starszy niż 5 minut:

if otherdevices_lastupdate['Czujnik Temperatura'] > 300 then
if tonumber(otherdevices_svalues['Czujnik Temperatura']) > 26 then
commandArray['Wentylator'] = 'On'
else
commandArray['Wentylator'] = 'Off'
end
end

Alert o niskiej wilgotności

Jeśli wilgotność spadnie poniżej 30%, automatycznie uruchom nawilżacz:

if tonumber(otherdevices_svalues['Czujnik Wilgotność']) < 30 then
commandArray['Nawilżacz'] = 'On'
end

Scenariusz „Opuszczam dom”

Zintegruj przycisk Xiaomi ze scenariuszem wyjścia, aby jednym kliknięciem wyłączyć światła i ogrzewanie, a zamknąć bramę garażu:

if devicechanged['Przycisk wejście'] then
commandArray['Światła salon'] = 'Off'
commandArray['Światła sypialnia'] = 'Off'
commandArray['Grzanie'] = 'Off'
commandArray['Bramka garażu'] = 'Close'
end

Rozwiązywanie typowych problemów

Problem – urządzenie nie pojawia się w Domoticzu

Rozwiązanie – sprawdź podstawowe ustawienia sieci i połączeń:

• upewnij się, że urządzenia są w tej samej podsieci,
• tymczasowo wyłącz firewall i przetestuj połączenie,
• zrestartuj Domoticza: sudo systemctl restart domoticz,
• wyczyść pamięć podręczną przeglądarki (Ctrl+Shift+Delete).

Problem – czujnik regularnie odpada

Rozwiązanie – popraw stabilność i zasięg:

• przesuń urządzenie bliżej odbiornika (Raspberry Pi/gateway),
• zaktualizuj Domoticza do najnowszej wersji beta,
• sprawdź stan baterii czujnika,
• zwiększ częstotliwość odczytów (zmniejsz interwał skanowania), aby ograniczyć opóźnienia.

Problem – hasło gatewaya się zmienia

Rozwiązanie – zapisz hasło natychmiast po wyświetleniu w aplikacji Mi Home (przycisk SAVE). Jeśli tego nie zrobisz, gateway wygeneruje nowe hasło przy każdym połączeniu.

Problem – brak komunikacji między urządzeniami

Sprawdzenie parametrów sieci – wykonaj szybki test łączności:

# Sprawdź maskę sieci
psm-get network.open_pf
# Sprawdź, czy urządzenia widzą się nawzajem
ping <IP-gateway>
ping <IP-domoticz>

Rekomendacje producenta – urządzenia na przyszłość

Warto obserwować nowości, które poszerzają możliwości ekosystemu:

• Xiaomi Mi Smart Hub – nowy gateway z lepszymi możliwościami;
• Czujniki jakości powietrza Xiaomi – coraz bardziej popularne;
• Xiaomi Smart Bulbs – z zaawansowanym sterowaniem kolorami;
• Xiaomi Plug – inteligentne gniazdka do sterowania dowolnymi urządzeniami.

Artykuł przygotowany – maj 2026
Wersja – 1.0
Autor – Redakcja Smart Home PL