Integrace RichPear Home

Cisco Mobility Express

Cisco Mobility Express přidává detekci přítomnosti podle klientů připojených k bezdrátovému controlleru Cisco Mobility Express.

Začít nastavení Zpět na integrace

Doména: cisco_mobility_express
Kategorie: detekce přítomnosti
Komunikace: lokální dotazování
Nastavení: ruční konfigurace v YAML
Výstup: device tracker podle Wi-Fi klientů

Co integrace přidá

Integrace se přihlašuje k Cisco Mobility Express controlleru a čte seznam asociovaných bezdrátových klientů. Každý nalezený klient se sleduje podle MAC adresy.

U nalezeného klienta může být k dispozici také název klienta a další atributy vrácené controllerem, například SSID, typ připojení nebo typ zařízení. Skutečný rozsah závisí na datech, která controller vrátí.

Integrace je lokální, nepotřebuje cloudový účet a nastavuje se ručně v konfiguraci RichPear Home.

Kontrolní témata

Vyžaduje Cisco Mobility Express wireless controller.
Potřebuje IP adresu controlleru, uživatelské jméno a heslo.
Volitelně podporuje HTTPS a ověřování SSL certifikátu.
Nastavuje se ručně v konfiguraci RichPear Home.

Příprava před přidáním

Před přidáním si připravte IP adresu controlleru, administrátorské uživatelské jméno a heslo. Ověřte, že je controller dostupný z instance RichPear Home a že přihlášení vrací seznam bezdrátových klientů.

RichPear Home se v domácí síti běžně otevírá na http://rphome.local:8123. Pokud tato adresa v dané síti neodpoví, použijte http://IP-ADRESA:8123.

Pokud controller používá vlastní nebo self-signed certifikát, rozhodněte předem, zda chcete používat HTTPS a zda bude RichPear Home ověřovat SSL certifikát.

Nastavení v RichPear Home

Tato integrace se nastavuje ručně v konfiguraci. Doplňte položku do sekce device_tracker, restartujte RichPear Home a potom ověřte integraci v Nastavení → Zařízení a služby.

device_tracker:
  - platform: cisco_mobility_express
    host: CONTROLLER_IP_ADDRESS
    username: YOUR_ADMIN_USERNAME
    password: YOUR_ADMIN_PASSWORD

Volitelně můžete doplnit ssl: true pro připojení přes HTTPS. Pokud používáte self-signed certifikát a nemáte v systému nainstalovanou odpovídající certifikační autoritu, nastavte verify_ssl: false.

Kontrola entit a funkcí

Po restartu otevřete detail integrace a kartu entit. Detekovaná zařízení odpovídají klientům, které controller aktuálně hlásí jako asociované.

Projděte MAC adresy, názvy klientů a dostupné atributy. Názvy se mohou lišit podle toho, jak je controller pro dané zařízení zná, proto je po ověření přejmenujte do srozumitelné podoby.

Po nastavení

Ověřte, že controller vrací seznam asociovaných klientů.
Pojmenujte detekovaná zařízení podle MAC adres a skutečných uživatelů.
Zkontrolujte dostupné atributy, například SSID nebo typ zařízení, pokud je controller poskytuje.
Teprve potom stavy použijte pro automatizace přítomnosti.

Použití v automatizacích

Detekci používejte hlavně pro režimy domácnosti, informativní přítomnost a upozornění. Bezdrátová přítomnost může reagovat se zpožděním podle chování klienta, úsporného režimu a roamingu.

U automatizací, které mění zabezpečení nebo vytápění, kombinujte přítomnost z controlleru s další podmínkou, například časem, ručním režimem nebo jiným senzorem.

Provoz a údržba

Po změně hesla, certifikátu controlleru, síťového oddělení, SSID nebo firmwaru zkontrolujte konfiguraci, logy a stavy zařízení. Pokud přepnete controller na HTTPS, upravte také volby ssl a verify_ssl.

Pravidelně kontrolujte, že RichPear Home vidí controller přes síť, protože bez přístupu ke controlleru nelze obnovovat přítomnost klientů.

Řešení problémů

Když integrace nefunguje podle očekávání, ověřte IP adresu controlleru, přihlašovací údaje, HTTP/HTTPS režim, ověřování SSL certifikátu, firewall mezi VLAN a syntaxi konfigurace. Potom otevřete Nastavení → Systém → Logy a hledejte chyby podle domény cisco_mobility_express.

Pokud se klient nezobrazuje, ověřte přímo v controlleru, že je skutečně asociovaný a že controller vrací jeho MAC adresu v seznamu klientů.