Na integrację z Home Assistant musieliśmy poczekać ponad pół roku od wypuszczenia na rynek nowej serii oczyszczaczy powietrza Xiaomi Mi Air Purifier 3H i 3. Od wersji 0.109 HA jest to nareszcie możliwe. Programiści musieli zaimplementować nowy protokół komunikacyjny Xiaomi MiOT, którym posługują się najnowsze urządzenia firmy Xiaomi. W tym artykule przedstawię instrukcję krok po kroku, co należy wykonać, aby połączyć nasze oczyszczacze z systemem Home Assistant.
Xiaomi Mi Air Purifier 3H vs 3C! – 11 różnic w 4 minuty!
Xiaomi Mi Air Purifier 3C! Znamy nowy oczyszczacz powietrza Xiaomi
Porównanie oczyszczaczy Xiaomi! Porównujemy 2S oraz 3H!
Xiaomi Mi Air Purifier 3H nareszcie w Home Assistant!
Ulepszenie trybu automatycznego w Xiaomi Mi Air Purifier 3H
Xiaomi Mijia Purifier F1 – nowy oczyszczacz od Xiaomi
Vlog SmartMe powraca w Nowym Roku – Recenzja Xiaomi Mi Air Purifier 3
Nowe produkty Xiaomi w Polsce. Nie tylko smartfony!
Xiaomi Air Purifier 3H – czy jest godnym następcą? Recenzja
Opis integracji
Integrację Xiaomi Mi Air Purifier 3H i 3 zawarto w już istniejącej integracji o nazwie Xiaomi Air Purifier (platforma xiaomi_miio). Dzięki tej samej platformie, można połączyć się ze starszymi modelami Xiaomi Mi Air Purifier 2S i 2.
Dodano dwa nowe modele do listy obsługiwanych urządzeń:
Air Purifier 3 | zhimi.airpurifier.ma4 | |
Air Purifier 3H | zhimi.airpurifier.mb3 |
Oto lista funkcjonalności i atrybutów, które dostarcza platforma dla powyższych modeli:

Na stronie integracji znajdziecie również usługi platformy xiaomi_miio, z jakich można skorzystać w swoich automatyzacjach, np. xiaomi_miio.fan_set_fan_level. Sprawdziłem, działa.

Instrukcja integracji Xiaomi Mi Air Purifier 3H
Przetestowałem dodawanie modelu 3H do Home Assistant w wersji 0.109.2. Opiszę krok po kroku, jakie czynności należy wykonać.
1. Na początek dodaj swój oczyszczacz do aplikacji Xiaomi Home (dawniej Mi Home).
2. Zanim zaczniesz konfigurację w Home Assistant, musisz dowiedzieć się, jakie IP i jaki Token otrzymał twój oczyszczacz. Instrukcja, jak to zrobić, znajduje się w poniższym artykule. Warto również przypisać IP na stałe w ustawieniach routera.
Token Xiaomi, jak go wyciągnąć? Poradnik dla urządzeń WiFi i Bluetooth

3. Jeśli masz Home Assistant w wersji 0.109 lub wyższej, to otwórz edytor pliku configuration.yaml i wklej następującą sekcję:
fan: - platform: xiaomi_miio name: Air Purifier Bedroom #Encja będzie się nazywać: fan.air_purifier_bedroom host: adres_ip_oczyszczacza token: token_oczyszczacza model: zhimi.airpurifier.mb3 #Opcjonalne, ale warto dodać. #Dla 3H: zhimi.airpurifier.mb3 #Dla 3: zhimi.airpurifier.ma4
Teraz uruchom ponownie Home Assistant (mnie zadziałało dopiero po dwóch restartach).
Po uruchomieniu powinna być dostępna nowa encja. Możemy włączyć/wyłączyć urządzenie, ustawić tryb pracy oraz zobaczyć aktualne wartości wielu atrybutów. Inne akcje możliwe są dzięki skorzystaniu z usług platformy xiaomi_miio.


4. Jeśli chcecie na podstawie encji oczyszczacza utworzyć różne sensory, to należy użyć w tym celu platformy template. W pliku configuration.yaml dodaj linijki w sekcji sensor.
sensor: - platform: template sensors: air_purifier_bedroom_aqi: friendly_name: "PM2.5" unit_of_measurement: 'μg/m³' value_template: "{{ state_attr('fan.air_purifier_bedroom', 'aqi') }}" air_purifier_bedroom_temperature: friendly_name: "Temperature" unit_of_measurement: '°C' value_template: "{{ state_attr('fan.air_purifier_bedroom', 'temperature')|float|round(2) }}" air_purifier_bedroom_humidity: friendly_name: "Humidity" unit_of_measurement: '%' value_template: "{{ state_attr('fan.air_purifier_bedroom', 'humidity') }}" air_purifier_bedroom_speed: friendly_name: "Mode" value_template: "{{ state_attr('fan.air_purifier_bedroom', 'speed') }}" air_purifier_bedroom_favorite_level: friendly_name: "Favorite Level" value_template: "{{ state_attr('fan.air_purifier_bedroom', 'favorite_level') }}" air_purifier_bedroom_motor_speed: friendly_name: "Motor Speed" unit_of_measurement: 'rpm' value_template: "{{ state_attr('fan.air_purifier_bedroom', 'motor_speed') }}"
Wybrałem tylko te, które mnie interesują. Po ponownym uruchomieniu Home Assistanta będziesz miał nowe encje sensorów do dyspozycji. Możesz je np. wyciągnąć w swoim panelu do karty Encje lub karty Sensor (aby zobaczyć wykres wartości).


Źródło: xiaomi_miio
Xiaomi 3H – wykorzystajcie kupon oraz kod, aby kupić go w cenie 487,35 zł!