Zum Ende der Metadaten springen
Zum Anfang der Metadaten
Autor
Logo

Status

STABLE

Versionv2018.3.5
Kompatibilität

LB 0.2.3LB 1.0.3

Zweck

Der BLE-Scanner bietet die Möglichkeit, eine Anwesenheitserkennung mittels BLE-Tags (Bluetooth Low Energy) zu realisieren.

 Version History...

Inhalt


Konfigurationsoptionen

  • SUBFOLDER=Diese Option enthält den Plugin-Verzeichnisnamen. Wird während der Installation automatisch gesetzt.

  • SCRIPTNAME=Diese Option enthält den Plugin-Namen. Wird während der Installation automatisch gesetzt.

  • TAGx -  Diese Option enthält Infos über einen Tag. Mögliche Werte: <automatisch>
    Die Option wird automatisch vom Webinterface gesetzt.

  • LOXBERRY_ID - Dient zur Identifikation des LoxBerry Servers wenn mehrere im Einsatz sind.
    Die LOXBERRY_ID wird als Prefix vor den Namen des Eingangs am Loxone Miniserver gesetzt.

Download

Installation

  • Das Plugin wird über die Plugin-Verwaltung des LoxBerry installiert und benötigt einen Neustart nach der Installation.

Kompatible Bluetooth-USB-Sticks

Getestet mit folgenden Bluetooth-Sticks:

Kompatible Bluetooth-Tags

Getestet mit folgenden Bluetooth-Tags:

Die Anwesenheit über das Bluetooth-Signal von Smartphones funktioniert nicht!

Funktion des Plugins

Das Plugin durchsucht mit Hilfe eines Bluetooth USB-Sticks am LoxBerry das Funknetz im Empfangsbereich und stellt sendet den Status der BLE-Tags an den Loxone Miniserver.

Aufgerufen wird durch einen beliebigen Trigger über einen Virtuellen Ausgang 

    • http://<loxberry-hostname-oder-IP-Adresse>/plugins/ble_scanner/?mode=normal
    • Der LoxBerry beschreibt dann am Miniserver Virtuelle Eingänge.
      1. Diese müssen das folgende Format haben: Bezeichnung = BLE_xx_xx_xx_xx_xx_xx wobei die xx durch die MAC-Adresse des Tags (mit _ statt : )ersetzt werden muss.
      2. Dieser Name kann den eckigen Klammern auf der Plugin-Admin-Webseite im LoxBerry entnommen werden.
  • In Version 0.30 arbeitet das Plugin mit einer MySQL Datenbank.
  • Ab Version v2018.2.28 verwendet das Plugin eine SQlite Datenbank auf der RAM-Disk um die SD Karte zu schonen.
  • Beispiel-Konfiguration: Beispiel_BLE-Scanner.Loxone

Fehler melden / Fehlersuche / Troubleshooting

Das Plugin hat eine LogDatei. Ab v2018.2.28 hat die Adminseite einen LogViewer integriert.

Bei alten Versionen kann man auf der LoxBerry Kommandozeile tail -f /opt/loxberry/log/plugins/ble_scanner/BLE-Scanner.log benutzen.

Das Plugin kann auch über einen WebBrowser angesprochen werden. Es liefert einen JSON-kodierten String zurück.

Das Plugin hat ab v2018.2.28 eine neue Loggingfunktion. Man kann das Logging in der LoxBerry Plugin-Verwaltung einstellen.

Bei alten Versionen muss zur Fehlersuche in den folgenden Dateien per Hand editiert werden:

  • /opt/loxberry/webfrontend/cgi/plugins/ble_scanner/bin/daemon.php Zeile 15: $debug = 1;
  • /opt/loxberry/webfrontend/cgi/plugins/ble_scanner/bin/blescan.py Zeile 16: DEBUG = True
    und
  • /opt/loxberry/webfrontend/html/plugins/ble_scanner/index.php Zeile 22: $debug = 1;

Fehlerberichte bitte direkt im Repository auf GitHub melden


Das Plugin überträgt die Authentifizierungsdaten für den Miniserver in leserlicher Form im Netzwerk. Wer Zugriff auf das Netzwerk hat, könnte die Daten möglicherweise mitlesen.

15 Kommentare

    • Hinweis: Die Beispiel Datei oben ist nicht eingebunden, der Link führt auf diese Seite!
    • Ich habe im Screenshot gesehen, dass die Emfangsstärke der BLE Tags im Plugin angezeigt wird, wäre es möglich diese auch an die Loxone zu senden? Das würde die Auswertung einfacher machen und Anwendungsmöglichkeiten erweitern. Schlüssel im Haus, vor der Tür, weiter weg, dicht dran usw usw (Sicherheitsdiskussionen bitte aussen vor lassen).

    Danke für deine Arbeit! Christoph

  1. Jose Alberto sagt:

    Hallo, eine Frage: Raspberry PI3b + hat bereits Bluetooth4.2 BLE, brauchen wir auch einen Dongle für dieses Raspberry Modell? Oder kann es so konfiguriert werden, dass wir keinen externen Dongle benötigen?

    Dies ist das erste Mal, dass ich Loxberry benutze, ich lerne über deine Artikel.

    Danke für deine Arbeit

  2. Alex sagt:

    Habe das Problem dass die Tags nicht erkannt werden wenn die homebridge aktiv ist. Woran könnte es liegen?

    1. Keine Ahnung. Benutzt die bluetooth? Dann wohl daran.

      1. Alex sagt:

        Soviel ich weis wird Bluetooth nicht verwendet.

        1. Ohne Logdatei habe ich keine Idee.

  3. Sebastian sagt:

    Moin ich bekomme nach der Installation folgenden Fehler der auch nach warten und NEustart nicht beseitigt ist Fehler0003: Daemon Prozess läuft (noch) nicht:

      1. Sebastian sagt:

        Habe ich bereits gesehen, hata ber leider auch nicht geholfen

        1. $ sudo /usr/bin/hciattach /dev/ttyAMA0 bcm43xx 921600 nowflow -
          bcm43xx_init
          $ sudo connmanctl enable bluetooth
          $ bluetoothctl

          Willst du das mal probieren?

          1. Sebastian sagt:

            Kann es sein, das etwas mit dem Befehl nicht richtig ist? Danke

            1. /usr/bin/hciattach /dev/ttyAMA0 bcm43xx 921600 noflow -
              bcm43xx_init


              https://github.com/raspberrypi/linux/issues/1314#issuecomment-192919547

              1. Ansonsten probier mal 

                sudo apt-get install bluez bluez-firmware raspberrypi-sys-mods pi-bluetooth