UniFi Präsenz

Version History...

Repository: https:%%//%%github.com/LoxYourLife/unifi-presence

Master-Download: https://github.com/LoxYourLife/unifi-presence/archive/master.zip

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.

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.

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.

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

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.

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:

MQTT Gateway Dokumentation

• Langzeittest

GitHub: https://github.com/LoxYourLife/unifi-presence/issues