Autor
Logo

Status

Version

1.0.2 / 2.0.1 

Min. LB Version

DownloadStable: https://github.com/LoxYourLife/unifi-presence/archive/1.0.2.zip
Beta: https://github.com/LoxYourLife/unifi-presence/archive/2.0.1.zip
ZweckPräsenzerkennung über UniFi Wifi Geräte
LanguagesEN, DE
DiskussionBeitrag im LoxForum
Min. UniFi
Controller Version
>= 6.4.54
Erforderliche Plugins

MQTT Gateway >= 2.0.4
Express Server >= 0.0.2



https://github.com/LoxYourLife/unifi-presence/releases

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


Inhalt



Einführung / Video Tutorial

Download

Repository: 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:

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.

Um die Überwachung für ein Gerät zu deaktivieren, muss einfach nur der Switch angestellt werden.

Installation

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:

MQTT Gateway Dokumentation

Roadmap


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