MagicShutter HomeAssistant Dokumentáció

Bevezetés

A MagicShutter egy Home Assistant integráció, amely lehetővé teszi a MagicShutter okosredőnyök vezérlését és állapotának követését. Az alábbi dokumentáció lépésről lépésre bemutatja, hogyan lehet telepíteni, konfigurálni és használni az integrációt.

Verzió történet

Az integráció licence köteles aminek a dokumentációja itt található: Licence feltételek

Licence kulcsot a következő linken lehet igényelni: Licence igénylő

Telepítés

Kövesse az alábbi lépéseket az integráció telepítéséhez:

Letöltés: Terminal ablak szükséges hozzá, melyben a következő kódot kell futtatni curl -sSL https://mshut.firstmyadmin.hu/HomeAssistant-MagicShutter-integration/package/install.sh | bash Itt kell megadni a korábban említett licence kulcsot, amit előre kell igényelni.
Újraindítás: Indítsa újra a Home Assistant rendszert.
Integráció hozzáadása: A Home Assistant felületén válassza az Integráció hozzáadása opciót, majd keresse meg a "MagicShutter" integrációt.
HACS kiegészítő telepítése (a kártyák megjelenítéséhez): Kattintson ide a részletekért.

Konfiguráció

A MagicShutter integráció konfigurálása az alábbi adatokat igényli:

Eszköz azonosító (Device_ID): Az okosredőny egyedi azonosítója. Ezt a MagicShutter mobil alkalmazásban lehet beállítani.
Eszköz kulcs (Device_key): Az eszköz titkos kulcsa. Ezt a MagicShutter mobil alkalmazásba lehet tokenként generálni.
Eszköz neve: Egy egyedi név az eszköz azonosításához. Ezt fogják használni az entitások is.
Frissítési intervallum: Az eszköz adatainak frissítési időköze másodpercekben aktív időszakban. 3mp-15mp-ig állítható. Alapértelmezett 7mp.
Aktivitás utáni időtartam: Az eszköz adatainak frissítési ideje aktív időszak után. 60mp-180mp-ig állítható. Alapértelmezett 60mp.
Inaktív frissítési intervallum: Az eszköz adatainak frissítési időköze másodpercekben inaktív időszakban. 5p-30p-ig állítható. Alapértelmezett 10p.

A konfigurációt a Home Assistant felületén a "MagicShutter" integráció beállításainál adhatja meg.

Ezzel alapjába véve még nem működik, mert az aktivitást is figyelni kell. Itt van a configuration.yaml kommentelve.

Homekit használat esetén automatizálást is szükséges létrehozni ami egy virtuális kapcsolók bekapcsolása esetén számolja az aktív eszközöket. Ezt a automations.yaml fájlba kell integrálni.

Kártyák/jelvények létrehozása

Minden kártya/jelvény yaml kódsorral lesz megadva.

Használat

Az integráció sikeres beállítása után az alábbi funkciók érhetők el:

Redőny nyitása, zárása, megállítása és vizuális módban való pozíció beállítása.
Redőny sebesség beállítása (Lassú, Közepes, Gyors).
Redőny gyors gombok beállítása és azokkal való vezérlés.
Redőny állásának követése (0-100%) és előzmények visszakövetése állapotra, sebességre és pozícióra.
Frissítési időköz módosítása az "Opciók" menüben (Mozgás közbeni frissítés 1mp ami nem állítható).

Hibaelhárítás

Ha problémákba ütközik, kövesse az alábbi lépéseket:

Győződjön meg róla, hogy az eszköz azonosítója (device_id) és kulcsa helyes (device_key).
Ellenőrizze a Home Assistant naplóit hibaüzenetekért, elsősorban a magicshutter tartalmúakat.
Frissítse a Home Assistantot és az integrációt a legújabb verzióra.
Vegye fel a kapcsolatot a fejlesztővel további segítségért. mshuthomebridgelog@gmail.com

# Debug logok bekapcsolása logger: default: warning logs: # custom_components.magicshutter: debug # Aktivitást figyelő API sensor: - platform: websocket_api # Események rögzítése recorder: include: entities: - cover.eloszoba - sensor.eloszoba_pozicio - select.eloszoba_speed - input_number.position_1 - input_number.position_2 - input_number.position_3 - input_number.position_4 - input_number.position_5 - input_number.magicshutter_homekit_trigger - input_boolean.show_position_1 - input_boolean.show_position_2 - input_boolean.show_position_3 - input_boolean.show_position_4 - input_boolean.show_position_5 - input_boolean.homekit_opened - sensor.connected_clients - sensor.filtered_connected_clients_original - sensor.magicshutter_homekit_trigger template: # A redőny pozízióját %-osan is meg tudjuk jeleníteni - sensor: - name: "Elõszoba Pozíció" unit_of_measurement: "%" state: > {{ state_attr('cover.eloszoba', 'current_position') }} # Szűrt aktivitás figyelő szenzor - name: "Filtered Connected Clients Original" state: > {{ ((states('sensor.connected_clients') | int(0)) / 2 + (states('sensor.magicshutter_homekit_trigger') | int(0))) | int(0) }} # Homekit aktivitást figyelő szenzor - name: "MagicShutter Homekit Trigger" state: "{{ states('input_number.magicshutter_homekit_trigger') | int }}" attributes: description: "MagicShutter Homekit trigger állapota" # Pozíció állító csúszkák gyorsgombokhoz input_number: position_1: name: Pozíció 1 min: 0 max: 100 step: 1 position_2: name: Pozíció 2 min: 0 max: 100 step: 1 position_3: name: Pozíció 3 min: 0 max: 100 step: 1 position_4: name: Pozíció 4 min: 0 max: 100 step: 1 position_5: name: Pozíció 5 min: 0 max: 100 step: 1 # Homekit eszközök aktivitását számoló szenzor magicshutter_homekit_trigger: name: MagicShutter Homekit Trigger min: 0 max: 5 step: 1 mode: box input_boolean: # Gyorsgombokhoz tartozó aktiválási kapcsolók show_position_1: name: Pozíció 1 Kapcsoló show_position_2: name: Pozíció 2 Kapcsoló show_position_3: name: Pozíció 3 Kapcsoló show_position_4: name: Pozíció 4 Kapcsoló show_position_5: name: Pozíció 5 Kapcsoló # 1db Eszköz Homekit aktivitására kialakított kapcsoló homekit_opened: name: HomeKit Opened

type: vertical-stack cards: - type: custom:button-card name: Redőny gyorsgombok beállítása show_icon: false show_state: false styles: card: - text-align: center - font-size: 20px - font-weight: bold - background-color: var(--card-background-color) - box-shadow: none - padding: 16px - border-radius: 8px - type: vertical-stack cards: - type: horizontal-stack cards: - type: custom:button-card entity: input_number.position_1 show_name: true show_state: false show_icon: false name: > [[[ return `Gyorsgomb 1: ${Math.round(states['input_number.position_1'].state)}%`; ]]] styles: card: - flex: 1 - height: 45px - display: flex - justify-content: center - align-items: center - background-color: var(--card-background-color) - border-radius: 8px name: - font-size: 16px - color: var(--primary-text-color) - type: custom:button-card entity: input_boolean.show_position_1 show_name: false show_state: false icon: > [[[ return states['input_boolean.show_position_1'].state === "on" ? "mdi:eye" : "mdi:eye-off"; ]]] tap_action: action: call-service service: input_boolean.toggle service_data: entity_id: input_boolean.show_position_1 styles: card: - flex: 0 - width: 45px - height: 45px - display: flex - justify-content: center - align-items: center - background-color: var(--card-background-color) - border-radius: 8px icon: - width: 24px - height: 24px - color: > [[[ return states['input_boolean.show_position_1'].state === "on" ? "lime" : "red"; ]]] - type: horizontal-stack cards: - type: custom:button-card entity: input_number.position_2 show_name: true show_state: false show_icon: false name: > [[[ return `Gyorsgomb 2: ${Math.round(states['input_number.position_2'].state)}%`; ]]] styles: card: - flex: 1 - height: 45px - display: flex - justify-content: center - align-items: center - background-color: var(--card-background-color) - border-radius: 8px name: - font-size: 16px - color: var(--primary-text-color) - type: custom:button-card entity: input_boolean.show_position_2 show_name: false show_state: false icon: > [[[ return states['input_boolean.show_position_2'].state === "on" ? "mdi:eye" : "mdi:eye-off"; ]]] tap_action: action: call-service service: input_boolean.toggle service_data: entity_id: input_boolean.show_position_2 styles: card: - flex: 0 - width: 45px - height: 45px - display: flex - justify-content: center - align-items: center - background-color: var(--card-background-color) - border-radius: 8px icon: - width: 24px - height: 24px - color: > [[[ return states['input_boolean.show_position_2'].state === "on" ? "lime" : "red"; ]]] - type: horizontal-stack cards: - type: custom:button-card entity: input_number.position_3 show_name: true show_state: false show_icon: false name: > [[[ return `Gyorsgomb 3: ${Math.round(states['input_number.position_3'].state)}%`; ]]] styles: card: - flex: 1 - height: 45px - display: flex - justify-content: center - align-items: center - background-color: var(--card-background-color) - border-radius: 8px name: - font-size: 16px - color: var(--primary-text-color) - type: custom:button-card entity: input_boolean.show_position_3 show_name: false show_state: false icon: > [[[ return states['input_boolean.show_position_3'].state === "on" ? "mdi:eye" : "mdi:eye-off"; ]]] tap_action: action: call-service service: input_boolean.toggle service_data: entity_id: input_boolean.show_position_3 styles: card: - flex: 0 - width: 45px - height: 45px - display: flex - justify-content: center - align-items: center - background-color: var(--card-background-color) - border-radius: 8px icon: - width: 24px - height: 24px - color: > [[[ return states['input_boolean.show_position_3'].state === "on" ? "lime" : "red"; ]]] - type: horizontal-stack cards: - type: custom:button-card entity: input_number.position_4 show_name: true show_state: false show_icon: false name: > [[[ return `Gyorsgomb 4: ${Math.round(states['input_number.position_4'].state)}%`; ]]] styles: card: - flex: 1 - height: 45px - display: flex - justify-content: center - align-items: center - background-color: var(--card-background-color) - border-radius: 8px name: - font-size: 16px - color: var(--primary-text-color) - type: custom:button-card entity: input_boolean.show_position_4 show_name: false show_state: false icon: > [[[ return states['input_boolean.show_position_4'].state === "on" ? "mdi:eye" : "mdi:eye-off"; ]]] tap_action: action: call-service service: input_boolean.toggle service_data: entity_id: input_boolean.show_position_4 styles: card: - flex: 0 - width: 45px - height: 45px - display: flex - justify-content: center - align-items: center - background-color: var(--card-background-color) - border-radius: 8px icon: - width: 24px - height: 24px - color: > [[[ return states['input_boolean.show_position_4'].state === "on" ? "lime" : "red"; ]]] - type: horizontal-stack cards: - type: custom:button-card entity: input_number.position_5 show_name: true show_state: false show_icon: false name: > [[[ return `Gyorsgomb 5: ${Math.round(states['input_number.position_5'].state)}%`; ]]] styles: card: - flex: 1 - height: 45px - display: flex - justify-content: center - align-items: center - background-color: var(--card-background-color) - border-radius: 8px name: - font-size: 16px - color: var(--primary-text-color) - type: custom:button-card entity: input_boolean.show_position_5 show_name: false show_state: false icon: > [[[ return states['input_boolean.show_position_5'].state === "on" ? "mdi:eye" : "mdi:eye-off"; ]]] tap_action: action: call-service service: input_boolean.toggle service_data: entity_id: input_boolean.show_position_5 styles: card: - flex: 0 - width: 45px - height: 45px - display: flex - justify-content: center - align-items: center - background-color: var(--card-background-color) - border-radius: 8px icon: - width: 24px - height: 24px - color: > [[[ return states['input_boolean.show_position_5'].state === "on" ? "lime" : "red"; ]]]

Bevezetés

Telepítés

Konfiguráció

Kártyák/jelvények létrehozása

Használat

Hibaelhárítás

Configuration.yaml

Automations.yaml

Full clients jelvény

Filter clients jelvény

Homekit clients jelvény

HACS kiegészítő telepítése

Redőny kártya kódja

Diagram Kártya

Gyors gomb beállító kártya