Wifi Scanner

Autor
Logo

Status

STABLE

Version2.2
Min. LB Version

1.1 = LB 0.2.3 2.2 = LB 1.4

Downloadhttps://github.com/Gagi2k/LoxBerry-Plugin-WifiScanner/archive/v2.2.zip
ZweckScannt das Netzwerk nach Geräten und sendet den Status an den Miniserver. Zum Beispiel zur Anwesenheitserkennung.
LanguagesEN, DE
Diskussion
 Version History...

Version 1.0-rc1

  • erste öffentliche Version

Version 1.1

  • Englische Übersetzung

Version 2.0

  • Neue Plugin Struktur
  • Scan nach IP-Adressen
  • Scan ohne FritzBox möglich
  • Zusätzlicher automatischer Scan mittels arping
  • Scan von Miniserver aus starten

Version 2.1

  • Korrektur der Umlaute
  • Informationen werden sofort geschickt, anstatt nur am Ende
  • MQTT-Support

Version 2.2

  • Mehr Log-Augaben
  • Automatische Ermittlung der IP-Adresse aus der MAC-Adresse
  • Konfigurationsoption ob aktiv gescannt werden soll
  • Option um ping anstatt arping zu verwenden
  • MQTT Probleme gelöst

Inhalt



Download

Alle releasese gibts hier: https://github.com/Gagi2k/LoxBerry-Plugin-WifiScanner/releases

Installation

Das Plugin wird wie alle anderen Plugins per ZIP-Datei im Loxberry installiert.

Konfigurationsoptionen

Zunächst kann der Scanner über die Schaltfläche "Scanner aktivieren" angeschalten werden.
Der Scanner scannt dann periodisch nach den eingestellten Benutzern, die im nächsten Schritt festgelegt werden.

Die ComboBox hinter der "Scanner aktivieren" Schaltfläche legt den Abfragezyklus fest.

Über den "Neuer Benutzer" Button, kann ein neuer Benutzer angelegt werden, der in den dann erscheinenen Feldern konfiguriert werden kann.

Jeder Benutzer muss mit einem eindeutigen Namen identifierbar sein. Die Software prüft die Eindeutigkeit nicht ab, aber nachdem der Name als Kennung zum Miniserver geschickt wird, treten hier spätestens Probleme auf.
Jeder Benutzer wird durch eine oder mehrere MAC-Adressen identifiziert. Mehrere MAC-Adressen können durch einen ; getrennt eingestellt werden.
Anstatt einer MAC-Adresse kann auch eine IP-Adresse verwendet werden, bzw. auch beides zusammen.

Die MAC Adressen für eure Geräte findet ihr am besten in der Netzwerkübersicht in eurer Fritzbox oder ihr benutzt eine Scanner Software wie LANScan.

In der Section "Fritzboxanbindung" könnt ihr einstellen wie eure FritzBox zu erreichen ist. In den meisten Fällen muss hier nichts verändert werden. Falls ihr keine FritzBox besitzt oder ohne die FritzBox scannen möchtet, könnt ihr den Schalter "Fritz Box Abfragen" auf "Aus" stellen.

In der "Miniserveranbindung" kann der UDP-Port  gewählt werden mit dem die Daten an den Miniserver gesendet werden.

Nach dem Aktivieren des Scanners und dem speichern der Konfiguration wird sofort ein scan durchgeführt und ihr könnt das Ergebnis in der Log-Datei sehen.
Dafür einfach mit dem "Log Datei Öffnen" Button den Logviewer starten.

Funktion des Plugins

Das Plugin basiert auf dem Script hier aus dem Wiki.
Hauptsächlich dient das Plugin zur Anwesenheitserkennung von bestimmten Benutzern im WLAN. Dafür werden den Benutzern eine oder mehrere MAC-Adressen zugeordnet und das Plugin fragt die FritzBox periodisch ab ob die eingestellten MAC-Adressen aktuell im Netzwerk verfügbar sind. Das Ergebnis wird per UDP an den Miniserver gesendet.

Einrichtung in der Loxone Config Software

Zuerst muss ein neuer Virtueller UDP Eingang angelegt werden. Der UDP Empfangsport muss passend zum gewählten Port in der Plugin Konfiguration gewählt werden. Bei Senderadresse bitte nichts eingeben, ansonsten können die Daten nicht verarbeitet werden.
Hier ein Beispiel für den Standard Port:

Für jeden Benutzer wird nun ein neuer Virtueller UDP Eingang Befehl angelegt.

Die Befehlskennung ist: \i<BENUTZER>:\i\v
<BENUTZER> muss dabei durch den eingestellten Benutzernamen in der Plugin Konfiguration ersetzt werden.
Hier ein Beispiel für den Benutzer "Dominik"

Abfrage vom Miniserver aus starten

In manchen Situationen ist es sinnvoll einen Scan zum jetztigen Zeitpunkt zu starten und ihn in kürzeren Intervallen zu wiederholen. Ein Beispiel hierfür ist zum Beispiel bei Auslösung eines Alarms, um festzustellen ob es ein "Falscher Alarm" war und die Alarmanlage automatisch abzustellen. Ein neuer Scan kann mittels eines Virtuellen Ausgangs gestartet werden. Die Adresse muss dabei auf die IP-Adresse des Loxberrys gesetzt werden. Im Virtuelle Ausgangs Befehl muss Befehl bei EIN auf folgenden Wert gesetzt werden: /plugins/wifiscanner/scan.cgi

Roadmap

  • Englische Übersetzung (1.1)
  • Scannen nach IP-Adressen (2.0)
  • Funktion unabhängig von einer FritzBox (2.0)
  • Mehrere Modi um die Abfragehäufigkeit über Loxone anzupassen (2.0 über Miniserver)
  • Update auf neue Loxberry Plugin API (2.0)
  • Loxberry Update Mechanismus (2.0)

Fragen stellen und Fehler melden

Fragen zum Plugin bitte ausschließlich im Forum stellen. Fehler bitte direkt hier eintragen.