Xiaomi Smart Home – jak zintegrować urządzenia z Domoticzem i automatyzacją domu?

Autor: Ekspert Smart Home | Data publikacji: Maj 2026

W erze inteligentnych domów systemy takie jak Xiaomi Smart Home zyskują na popularności dzięki niskiej cenie, szerokiemu ekosystemowi i prostej obsłudze.

Jeśli masz bramkę Xiaomi Gateway, czujniki ruchu/temperatury, gniazdka czy kamerki i chcesz zintegrować je z Domoticzem – ten poradnik przeprowadzi Cię krok po kroku przez konfigurację. Pokażemy, jak sparować urządzenia, skonfigurować bramkę, dodać sensory do Domoticza i zbudować zaawansowane automatyzacje, np. alarm oparty o lokalizację telefonu czy powiadomienia z kamerki.

Domoticz najczęściej działa na Raspberry Pi, ale poradnik sprawdzi się także na PC lub innym hoście.

Uwaga: starsze bramki Xiaomi (wersja 2.x) integrują się najlepiej; nowsze V3 i M1S mogą wymagać alternatywy, np. Zigbee2MQTT.

1. Wymagania wstępne i lista kompatybilnych urządzeń

Przed instalacją upewnij się, że masz:

• Domoticz zainstalowany (zalecany kanał beta: Konfiguracja > Ustawienia > Aktualizacje oprogramowania > beta),
• Raspberry Pi (lub inny serwer) w tej samej podsieci co bramka Xiaomi, np. maska 255.255.255.0,
• aplikację Mi Home (Android/iOS) na smartfonie,
• urządzenia Xiaomi: bramka Gateway (Aqara), czujniki, przyciski, gniazdka itp.

Kompatybilne urządzenia (na podstawie doświadczeń użytkowników):

Urządzenie	SID (przykładowy)	Funkcje w Domoticz
Czujnik ruchu	158d0001xxxxxx	Wykrywanie ruchu, automatyzacje
Bezprzewodowy przycisk	158d0002xxxxxx	Pojedynczy/podwójny klik, długie naciśnięcie
Czujnik otwarcia drzwi/okien	158d0002xxxxxx	Otwarcie/zamknięcie drzwi/okien
Czujnik temperatury/wilgotności	158d0002xxxxxx	Temperatura, wilgotność, ciśnienie
Inteligentne gniazdko (Zigbee)	158d0002xxxxxx	Włącz/wyłącz (Wi‑Fi nieobsługiwane)
Xiaomi Mi Smart Cube	158d0002xxxxxx	Ruchy sześcianu
Przełączniki Aqara (pojedyncze/podwójne)	Różne	Przyciski bezprzewodowe/przewodowe
Xiaomi Gateway LED	Wbudowane	Sterowanie RGB, alarmy, głośność
Kamera Dafang (z modyfikowanym firmware)	–	Obrót, detekcja ruchu, zrzuty ekranu

Źródło: Wiki Domoticz i fora jak smartnydom.pl.

2. Instalacja i parowanie urządzeń w aplikacji Mi Home

Krok 1 – pobierz i skonfiguruj Mi Home

Wykonaj poniższe czynności:

• pobierz aplikację Mi Home z Google Play/App Store (możesz użyć kodu QR z pudełka),
• zmień region na Mainland China (Profil > Ustawienia > Locale > Mainland China) – interfejs może pozostać po angielsku,
• zaloguj się kontem Xiaomi lub utwórz nowe konto.

Krok 2 – sparuj bramkę Gateway

Postępuj według poniższych kroków:

1. Podłącz i włącz bramkę (diody RGB powinny migać).
2. W aplikacji Mi Home wybierz „+” > Gateway, wskaż model i połącz z siecią Wi‑Fi 2,4 GHz.
3. Po sparowaniu otwórz ekran bramki i szybko kliknij 5–10 razy w wersję oprogramowania, aby wejść w Developer mode.
4. Włącz pierwszy przełącznik w Developer mode, a następnie zapisz: SID bramki, token (hasło) i adres IP.
5. Na routerze zarezerwuj dla bramki stałe IP (np. poprzez DHCP reservation; do skanu sieci użyj np. Advanced IP Scanner).

Ważne na Androidzie – po wyświetleniu tokenu kliknij przycisk SAVE (nie „Cancel”), w przeciwnym razie token ulegnie zmianie. Na iOS token odczytasz bezpośrednio w trybie deweloperskim.

Krok 3 – dodaj pozostałe urządzenia

W Domu w aplikacji Mi Home dodawaj kolejne akcesoria, przygotowując je do parowania zgodnie z instrukcją:

• czujnik temperatury/wilgotności – przytrzymaj przycisk parowania,
• czujnik ruchu/drzwi – użyj cienkiego drucika w otworze reset,
• gniazdko/przycisk – postępuj według instrukcji producenta.

Następnie aplikacja wykryje urządzenie i sparuje je automatycznie; powtórz dla wszystkich akcesoriów.

Dla stabilnej pracy bramki zaleca się aktualizację firmware do wersji co najmniej 3.6903 (szczegóły na forach, m.in. raspberrywpraktyce).

3. Integracja z Domoticzem – dodawanie sprzętu

Krok 1 – aktualizacja Domoticz

W Domoticzu przejdź do: Konfiguracja > Ustawienia > Aktualizacje, wybierz kanał beta, zainstaluj i zrestartuj usługę.

Krok 2 – dodaj bramkę Xiaomi Gateway

W Domoticzu dodaj nowy sprzęt według poniższych kroków:

1. Wejdź w Konfiguracja > Sprzęt > Nowy.
2. Jako Typ wybierz: Xiaomi Gateway (Aqara).
3. Wpisz IP bramki, np. 192.168.1.100.
4. Ustaw port 9898.
5. Wprowadź token (hasło) z Mi Home.
6. Nazwa, np. „Xiaomi Gateway Salon”.
7. Zapisz i przetestuj połączenie.

Krok 3 – automatyczne pojawienie się urządzeń

Po poprawnym dodaniu bramki w Domoticzu pojawią się nowe pozycje w zakładce Urządzenia:

• czujniki, przełączniki oraz LED Gateway (sterowanie RGB, alarmy),
• w zakładce Utility – czujnik światła z bramki,
• LYWSD03MMC (MiJia 2) – do odczytu BLE użyj skryptu „Mi Temperature 2”, a w Sprzęt dodaj wirtualne urządzenie powiązane ze skryptem.

Rozwiązywanie problemów:

Problem	Rozwiązanie
Nie dodaje urządzeń	Sprawdź podsieć (255.255.255.0), wersję bramki (2.x) i token (na Androidzie pamiętaj o SAVE).
Błąd sterowania (np. gniazdko)	Zaktualizuj Domoticz do najnowszej wersji beta.
Brak połączenia	Wyczyść cache przeglądarki i zrestartuj usługę Domoticz.

4. Zaawansowane integracje i automatyzacje

Integracja z telefonem i geolokalizacją

Na smartfonie zainstaluj OwnTracks lub wbudowany Domoticz GPS Tracker, aby wykrywać obecność. Przykład automatyzacji: gdy status to „Poza domem”, włącz alarm oparty o czujniki ruchu i syrenę w bramce.

Oto przykładowy skrypt w DzVents/Lua:

if (devicechanged['Motion'] == 'On' and otherdevices['Telefon'] == 'Poza domem') then
commandArray['Bramka Alarm']='On'
sendMail('Ruch!','Intruz!','screen.jpg')
end

Kamera Dafang z modyfikowanym firmware

Wgraj zmodyfikowany firmware (opisy na smartnydom.pl), a następnie dodaj kamerę do Domoticza, uzyskując sterowanie obrotem, detekcję ruchu i powiadomienia ze zrzutem ekranu wysyłane e‑mailem.

Przyciski Xiaomi Wireless Switch

Przykładowe przypisania przycisków:

• pojedynczy klik – włącz światło w salonie;
• podwójny klik – uzbrój alarm;
• długie naciśnięcie – włącz tryb nocny.

Pełna automatyzacja domu

Oto przykładowe scenariusze dzienne:

• poranek – Mi Band wykrywa pobudkę, włącz światło RGB i ustaw komfortową temperaturę;
• wyjście z domu – drzwi otwarte + telefon poza domem, uzbrój alarm i zgaś światła;
• panel Dashticz – zbuduj rozbudowany dashboard z widżetami Xiaomi i scenami.

Specyfika iPhone

Konfiguracja trybu deweloperskiego bramki i odczyt tokenu działają analogicznie jak na Androidzie; przydatny bywa skan IP w sieci lokalnej.

5. Alternatywy dla nowszych bramek (V3/M1S)

Nowsze bramki nie są oficjalnie wspierane w Domoticzu. Skorzystaj z Zigbee2MQTT oraz wtyczki MQTT w Domoticzu: przygotuj koordynator Zigbee (np. z oprogramowaniem Tasmota lub firmwarem koordynatora), uruchom Zigbee2MQTT i połącz go z Domoticzem poprzez broker MQTT.