Skip to content

Latest commit

 

History

History
70 lines (48 loc) · 2.78 KB

README.md

File metadata and controls

70 lines (48 loc) · 2.78 KB

SymconBTP

SymconBTP ist eine Erweiterung für die Heimautomatisierung IP Symcon. Diese Erweiterung stellt eine alternative zum gängigen Geofancing dar. Dabei dient das Bluetoothgeräte (meist das Mobiltelefon) als Erkennungsmerkmal. Wird beim Scan ein Gerät mit der hinterlegten MAC-Adresse gefunden, so wird der Status auf Anwesend gesetzt. Zusätzlich wird zum Status noch das Datum des Zustandwechsel sowie der Gerätename gespeichert.

Inhaltverzeichnis

  1. Funktionsumfang
  2. Voraussetzungen
  3. Software-Installation
  4. Einrichten der Instanzen in IP-Symcon
  5. Statusvariablen und Profile
  6. WebFront
  7. PHP-Befehlsreferenz

1. Funktionsumfang

  • Erkennung von Bluetooth Geräten
  • Ermittlung seit das Gerät anwesend bzw. abwesend ist.

2. Voraussetzungen

  • IP-Symcon ab Version 4.0
  • Linux
  • Bluetooth Dongle
  • Bluez (sudo apt-get install bluez)

3. Software-Installation

Über das Modul-Control folgende URL hinzufügen.
git://github.com/traxanos/SymconBTP.git

4. Einrichten der Instanzen in IP-Symcon

Die Einrichtung erfolgt über die Modulverwaltung von Symcon. Nach der Installation des Moduls sollte der Dienst neugestartet werden. Danach kann man pro Gerät eine Instanz vom Typ "Presence Device" anlegen.

Konfigurationsseite:

Name Beschreibung
MAC-Addresse Die MAC-Addrese z.B. vom Smartphone
Bluetooth LE Soll ein Spezieller Suchmodus verwendet werden (für manche TAGs nicht aber für Gerät wie Smartphones)
Interval In welchem Abstand sollen die Geräte gesucht werden. (in Sekunden)
Button "Suchen" Suche die Bluetooth-Gerät

5. Statusvariablen und Profile

Die Statusvariablen/Kategorien werden automatisch angelegt. Das Löschen einzelner kann zu Fehlfunktionen führen.

Statusvariablen
Name Typ Beschreibung
Zustand Boolean Ist des Gerät anwesend?
Name String Names des Gerätes (nicht bei LE Scans)
Abwesend Integer Seit wann ist das Gerät abwesend. (Wird ausgeblendet wenn Anwesend)
Anwesend Integer Seit wann ist das Gerät anwesend. (Wird ausgeblendet wenn Abwesend)
Profile:

Es werden keine weiteren Profile benötigt.

6. WebFront

Zeigt den Zustand des Bluetoothgerät an.

7. PHP-Befehlsreferenz

BTP_Scan(integer $InstanzID); Sucht das Gerät mit der InstanzID $InstanzID. Es kann nur 1 Scan parallel gestartet werden. Nach 5 Sekunden bricht der Scan ab falls noch ein anderer Scan läuft. Die Funktion liefert keinerlei Rückgabewert. BTP_Scan(12345, false);