====== UniFi Präsenz ====== ++++ Version History...| https://github.com/LoxYourLife/unifi-presence/releases ** Neues in V3.0.1 Loxberry 3 only** * fix for reconnecting to unifi controller **Neues in V3.0.0 Loxberry 3 only** * Upgrade node to v18.12.1 * Update all dedendencies * fix for Loxberry 3.0 **Neues in V2.1.1 (pre-release)** * fix: issue with reconnecting mqtt client **Neues in V2.1.0 (pre-release)** * Required Changes for Loxberry Express 1.0 **Neues in V2.0.1** * Hotfix auf Grund eines Port Konflikts im Express Server. **Neues in V2.0.0** * Komplett neues Interface und bessere Fehlermeldungen * UDM Informationen * 2 Tabs für Einstellungen und Geräte * Such- und Filteroptionen für Geräte * Die Geräte Liste aktualisiert den Status * Kabelgebundene Geräte können mit Einschränkung des Timeouts ebenfalls überwacht werden * Unterstützung von verschiedenen Sites im UniFi Controller * Das MQTT Topic wird nun automatisch abonniert ++++ ---- ===== Einführung / Video Tutorial ===== {{youtube>3Gfai3611hg?}} ===== Download ===== Repository: [[https://github.com/LoxYourLife/unifi-presence/releases|https:%%//%%github.com/LoxYourLife/unifi-presence]] Master-Download: https://github.com/LoxYourLife/unifi-presence/archive/master.zip ===== Funktion des Plugins ===== Das Plugin verbindet sich mit deiner UniFi Dream Machine oder den UniFi Controller. Dazu muss sich der Loxberry selbstverständlich einloggen können. Wenn der Login erfolgreich war, wir dir im Plugin die Liste aller aktuell bekannten verbundenen Geräte angezeigt. Im Standard ist die Überwachung für jedes Gerät deaktiviert. Um es zu aktivieren, muss in der Liste der Switch an gestellt werden. Gespeichert wird diese Aktion automatisch. Zusätzlich verbindet sich das Plugin im Hintergrund mit dem UniFi Controller und lauscht auf Events. Wenn bei den Events ein Gerät betroffen ist, welches Überwacht werden soll, reagiert das Plugin entsprechend. Andere Events oder Geräte werden ignoriert. Die Events, die das Plugin aktuell abdeckt sind: * Verbindung mit WiFi * Trennung des WiFi * Synchronisation * Erkennung wenn Kabelgebunde Geräte Offline sind Wird ein Event für ein zu überwachendes Gerät festgestellt, werden an das entsprechende MQTT Topic alle relevanten Information zu dem Gerät geschickt. * ''%%mac:%%'' Mac Adresse * ''%%ip:%%'' Aktuelle IP * ''%%ssid:%%'' WiFi SSID * ''%%type:%%'' Typ (WIRELESS, WIRED) * ''%%name:%%'' Name * ''%%userid:%%'' Userid * ''%%experience:%%'' Erfahrung - nur bei WIFI * ''%%connected:%%'' Verbunden * ''%%signalDbm%%'': Signalstärke in DBM - nur bei WiFi * ''%%signalPercentage%%'': Prozentuale Signalstärke - nur bei WiFi * ''%%ap:%%'' Access Point - nur bei WiFi * ''%%name:%%'' Name des AP * ''%%mac:%%'' Mac Adresse des AP Um die Überwachung für ein Gerät zu deaktivieren, muss einfach nur der Switch angestellt werden. ===== Installation ===== == Achtung == Der UniFi Controller muss eine Version >= **6.4.54** haben, dass dieses Plugin funktioniert. Das MQTT Plugin muss mindestens Version 2.0.4 haben. Das Express Plugin muss zusätzlich installiert werden Wenn du das MQTT Gateway Plugin noch nicht installiert hast, dann installiere dies bitte zuerst. Dieses plugin funktioniert nur. wenn das MQTT Plugin vorhanden ist.\\ ===== Konfigurationsoptionen ===== ==== Plugin Einstellungen ==== **Topic:** Das MQTT Topic in dem die Werte für die Geräte geschickt werden sollen. **Timeout für Kabelgebundene Geräte**: UniFi erkennt selbst nicht ob ein kabelgebundenes Gerät Offline ist nicht. Die Erkennung funktioniert daher so, dass wenn über den hier definierten Zeitraum keine Daten gesendet werden, dass Gerät als Offline angezeigt wird. Es kann sein, dass ein Gerät auch mal eine Minute nichts sendet und kann dann als Offline gezeigt werden obwohl das nicht der Fall ist. ==== UniFi Controller ==== Für eine reibungslose Nutzung müssen die Zugangsdaten angegeben werden für den Controller.  **Benutzt du einen nativen UniFi Controller wie die Dream Machine?**: Mit diesem Parameter kannst du einstellen, ob dein UniFi Controller auf einem nativem Gerät läuft. Wenn dein UniFi Controller beispielsweise mit einem Port aufgerufen wird, oder das Loxberry Plugin benutzt wird, oder eine separater RaspberryPi benutzt wird, muss dies auf "Aus" gestellt werden. Zusätzlich kann mam dann einen Port angeben. **IP Adresse:** Die lokale IP-Adresse von deinem UniFi Controller **Port:** Die Eingabe vom _Port ist abhängig vom Switch "Benutzt du einen nativen UniFi Controller wie die Dream Machine?". Ist dieser auf "Aus", so wird das Feld  für den Port angezeigt. Die Einhabe ist nicht zwingend erforderlich. **Username:** Der Username bzw. die Email mit der Du ich sonst auf deinem UniFi Controller anmeldest. **Passwort:** Dein Passwort. **2FA Code:** Wenn Du 2 Faktor Authentifizierung aktiviert hast, kommt beim Speichern ein zusätzliches Feld, in dem du den code eingeben musst. **Site**: Wenn du mehrere Sites aktiviert hast, kannst du hier die Entsprechende Site einstellen ==== Geräte ==== Hier gibt es nur eine Einstellungsmöglichkeit, Überwachung aktiv oder inaktiv. Ist der Schalter auf "Ja" wird das Gerät überwacht und alle Änderungen an das entsprechende MQTT Topic weitergeleitet. ===== Einrichtung in der Loxone Config Software ===== Die Einrichtung im Miniserver besteht hauptsächlich darin die Werte zu erhalten. Da diese im MQTT Topic liegen und darüber gemanaged werden empfiehlt es sich dort zu schauen, wie man die Werte in den Miniserver bekommt: [[plugins:mqtt_gateway:start|MQTT Gateway Dokumentation]] ===== Roadmap ===== * Langzeittest GitHub: https://github.com/LoxYourLife/unifi-presence/issues