UniFi Präsenz

Autor
Logo

Status

STABLE

Version1.0.2
Min. LB Version

LB 2.2.Y

Downloadhttps://github.com/LoxYourLife/unifi-presence/archive/1.0.2.zip
ZweckPräsenzerkennung über UniFi Wifi Geräte
LanguagesEN, DE
DiskussionBeitrag im LoxForum
Min. UniFi
Controller Version
>= 6.4.54
Erforderliche PluginsMQTT Gateway >= 2.0.4


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:

  • Verbindung mit WiFi
  • Trennung des WiFi
  • Synchronisation

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, CABLE)
  • name: Name
  • userid: Userid
  • experience: Erfahrung
  • connected: Verbunden
  • ap: Access Point
    • 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.


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

MQTT Einstellungen

Topic: Das MQTT Topic in dem die Werte für die Geräte geschickt werden sollen.

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.

Wifi 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

  • Langzeittest

Fragen stellen und Fehler melden

Bekannte Fehler

  • Liste der Geräte taucht nicht auf
    • Überprüfe, dass dein Unifi Controller mindestens Version 6.4.54 installiert hat.
  • Keine Daten im MQTT Topic
    • Überprüfe ob das MQTT Topic auf dem aktuellen Stand ist. Version 2.0.4 muss mindestens vorhanden sein.

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