Xiaomi Mi Air Purifier 3H nareszcie w Home Assistant!

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.

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ń:

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.

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