RichPear HOME DOCS Začít

Integrace RichPear Home

Aladdin Connect

Aladdin Connect přidá do RichPear Home garážová vrata Genie ovládaná přes účet AladdinConnect. Integrace umí vrata otevřít, zavřít, sledovat jejich stav a u podporovaného pohonu zobrazit stav záložní baterie.

Začít nastaveníZpět na integrace
Doména
aladdin_connect
Nastavení
UI průvodce a externí OAuth přihlášení
Komunikace
cloud-polling každých 15 sekund
Platformy
cover, sensor
Kategorie
Cover
01

Připravte účet a garážová vrata

Nejdřív nainstalujte mobilní aplikaci AladdinConnect, vytvořte účet a přidejte do ní garážový pohon. V aplikaci ověřte, že vrata jde bezpečně otevřít i zavřít a že účet je skutečným vlastníkem daných vrat.

Integrace vyžaduje cloudovou autentizaci přes cloudovou propojovací službu. Pokud cloudová část v instalaci není aktivní, nastavení skončí chybou ještě před přihlášením k Aladdin Connect.

Před přidáním zkontrolujte

  1. Garážová vrata fungují v aplikaci AladdinConnect.
  2. Účet vrata vlastní, nevidí je jen přes sdílený přístup.
  3. RichPear Home má funkční přístup k internetu.
  4. Cloudová autentizace pro OAuth přesměrování je v instalaci aktivní.
  5. RichPear Home otevřete na http://rphome.local:8123 nebo http://IP-ADRESA:8123.
02

Vyhledejte Aladdin Connect

Otevřete Nastavení → Zařízení a služby → Přidat integraci a vyhledejte Aladdin Connect. Zařízení Aladdin Connect se mohou v síti objevit i automaticky přes DHCP discovery; pokud se zobrazí jako nalezená integrace, můžete pokračovat přímo z nalezené položky.

Při ručním přidání vyberte značku Aladdin Connect. Průvodce v RichPear Home nepožaduje lokální IP adresu ani API klíč, protože přihlášení probíhá přes účet Aladdin Connect.

Vyhledání Aladdin Connect v dialogu Přidat integraci.
03

Dokončete externí přihlášení

Po výběru integrace RichPear Home zobrazí krok, který vyžaduje otevření externí webové stránky. Tlačítko Otevřít webovou stránku přesměruje na přihlášení Aladdin Connect a po autorizaci se účet propojí zpět s RichPear Home.

Po úspěšné autorizaci se garážová vrata z účtu přidají automaticky. Během přidání se nevyplňuje lokální adresa zařízení, token ani další ruční parametr.

Aladdin Connect používá externí OAuth přihlášení k účtu Aladdin Connect.
04

Zkontrolujte vytvořené entity

Po dokončení přihlášení otevřete detail integrace a přiřaďte garážová vrata do správné oblasti. Hlavní entita je cover s třídou zařízení garáž; umí otevřít a zavřít vrata a ukazuje stavy open, opening, closed a closing.

Integrace může vytvořit také diagnostický senzor úrovně záložní baterie pohonu. Tento senzor je ve výchozím stavu vypnutý, takže ho v případě potřeby zapněte v nastavení entity.

Podporované entity

  1. cover: garážová vrata, příkazy otevřít a zavřít, stav otevřeno, otevírá se, zavřeno nebo zavírá se.
  2. sensor: procenta baterie záložního zdroje pohonu, diagnostická entita vypnutá ve výchozím stavu.
05

Použijte vrata v automatizacích opatrně

Automatizace nejdřív otestujte ručně. Garážová vrata jsou fyzické zařízení, proto používejte jasné podmínky a neposílejte příkazy opakovaně bez kontroly stavu.

Typický bezpečný scénář je upozornění, když vrata zůstanou dlouho otevřená, nebo noční zavření pouze v případě, že entita skutečně hlásí stav open.

Upozornění po 10 minutách

alias: Upozornit na otevřenou garáž
triggers:
  - trigger: state
    entity_id: cover.garage_door
    to: "open"
    for:
      minutes: 10
actions:
  - action: notify.mobile_app_telefon
    data:
      title: Garážová vrata jsou otevřená
      message: Garážová vrata jsou otevřená 10 minut.
06

Automatické zavření večer

Pokud chcete vrata večer zavřít automaticky, nechte automatizaci nejdřív jen posílat notifikaci. Teprve po ověření spolehlivosti přidejte akci cover.close_cover.

Příklad zavření ve 22:00

alias: Zavřít garáž večer
triggers:
  - trigger: time
    at: "22:00:00"
conditions:
  - condition: state
    entity_id: cover.garage_door
    state: "open"
actions:
  - action: cover.close_cover
    target:
      entity_id: cover.garage_door
07

Počítejte s cloudovým pollingem a omezeními

Stav vrat a baterie se aktualizuje dotazováním cloudové služby Aladdin Connect každých 15 sekund. Integrace nemá lokální ani push variantu, takže bez internetu nebo při výpadku služby Aladdin Connect nebude dostupná.

RichPear Home zobrazí jen vrata, která účet Aladdin Connect vlastní. Vrata nasdílená z jiného účtu nejsou v této integraci podporovaná.

Integrace neumí řízení polohy ani zastavení v konkrétní pozici. K dispozici je otevření, zavření a sledování stavu.

Řešení problémů

Když Aladdin Connect nejde přidat nebo ovládat

Průvodce hlásí, že cloud není aktivní

Ověřte cloudovou autentizaci v instalaci. Integrace používá OAuth přihlášení přes cloudovou službu a bez ní nastavení nepokračuje.

Externí přihlášení selže nebo vyprší

Zkontrolujte internetové připojení a zkuste přihlášení znovu. Pokud chyba pokračuje, otevřete mobilní aplikaci AladdinConnect, odhlaste se a přihlaste se zpět, abyste ověřili platnost údajů.

Vrata se po přihlášení nezobrazí

V aplikaci AladdinConnect ověřte, že jsou vrata přidaná pod vaším vlastním účtem. Sdílená vrata se v integraci nezobrazují.

Entita garáže je nedostupná

Nejdřív ověřte internet v RichPear Home a dostupnost služby Aladdin Connect. Potom otevřete mobilní aplikaci AladdinConnect a vyzkoušejte, jestli vrata lze ovládat i tam.

08

Odebrání integrace

Aladdin Connect nemá žádné zvláštní kroky pro odebrání. Otevřete Nastavení → Zařízení a služby, vyberte kartu integrace, otevřete konkrétní položku a přes menu se třemi tečkami zvolte Odstranit.

Po odebrání zkontrolujte automatizace, dashboardy a skripty, které používaly entitu garážových vrat nebo senzor baterie.