Skip to content
This repository has been archived by the owner on Aug 21, 2019. It is now read-only.

Latest commit

 

History

History
121 lines (82 loc) · 5.63 KB

README.md

File metadata and controls

121 lines (82 loc) · 5.63 KB
Raw

Geofency

Die aktuelle Version dieses Moduls ist nicht mehr in SymconMisc verfügbar. Die aktuelle Version finden Sie in dem seit Version 5.1 verfügbaren Module Store. Alternativ können Sie es über das Module Control installieren: https://github.com/symcon/Geofency

Das Modul dient zum empfangen von Geofency Daten.

Inhaltverzeichnis

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

1. Funktionsumfang

  • Pro Gerät eine eigene Standortliste
  • Benutzername und Passwort Identifikation innerhalb von IP-Symcon.
  • Richtet automatisch den Webhook "/hook/geofency" ein.
  • Es wird empfohlen dies in Kombination mit dem Connect Modul zu nutzen.
  • Optional kann der aktuelle Standort von Geofency übermittelt werden

2. Voraussetzungen

  • IP-Symcon ab Version 4.x
  • Geofency App für Apple iOS

3. Software-Installation

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

4. Geofency Konfiguration

In der Geofency App mit + einen neuen Standort hinzufügen. Dann auf die 3 Punkte rechts klicken um das Menü zu öffnen. Hier ist Webhook auszuwählen.

Event

Als URL wird jeweils die Domain eingetragen unter der IP-Symcon zu erreichen ist gefolgt von /hook/geofency Am einfachtsen ist es dort die IP-Symcon Connect Adresse einzutragen gefolgt von /hook/geofency

Optional kann Aktuelle Position senden aktiviert werden.

POST Format

Einstellung bleibt auf Default, JSON-enkodiert ist deaktiv und wird nicht ausgewählt

Authentifizierung

Name HTTP Basic Authentifizierung
Username Der Webhook Benutzername der dann in IP-Symcon hinterlegt wird
Passwort Das Webhook Passwort das dann in IP-Symcon hinterlegt wird

5. Einrichten der Instanzen in IP-Symcon

  • Unter "Instanz hinzufügen" ist das 'Geofency'-Modul unter dem Hersteller '(Kern)' aufgeführt.

Konfigurationsseite:

Name Beschreibung
Benutzername Benutzername, welcher in der Geofency App angegeben werden muss, um IP-Symcon Daten schicken zu können.
Passwort Passwort, welches in der Geofency App angeben werden muss.

Werden diese Daten Leer gelassen kann jeder über den Hook Daten an IP-Symcon schicken.

6. Statusvariablen und Profile

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

Statusvariablen

Die Variablen werden anhand der Geräte ID und beim erstmaligen senden innerhalb des Geofency Moduls automatisch angelegt. Es können mehrere Geräte über einen Hook laufen. Jedes Gerät wird unter seiner eigenen "Kategorie" eingerichtet.

Name Typ Beschreibung
Gerätename Instanz (Dummy) Dient als "Kategorie" in der sich alle überwachten Standorte, sowie der Zeitstempel und Längen-/Breitengrad befinden. Wird pro Gerät erstellt.
Latitude Float Breitengrad (Mitte des Geofences) der letzten Aktivität
Longitude Float Längengrad (Mitte des Geofences) der letzten Aktivität
CurrentLatitude Float Proximity-Koordinaten, also die aktuellen Koordinaten bei Ein- oder Austritt (äusserer Umkreis des Geofences), falls „Aktuelle Position senden“ in der App beim Webhook gewählt wurde
CurrentLongitude Float Proximity-Koordinaten, also die aktuellen Koordinaten bei Ein- oder Austritt (äusserer Umkreis des Geofences), falls „Aktuelle Position senden“ in der App beim Webhook gewählt wurde
Direction Integer Azimutwinkel (Richtung in Grad) des aktuellen Ein-/Austrittspunktes bezogen auf die Mitte des Geofence-Kreises, falls „Aktuelle Position senden“ in der App beim Webhook gewählt wurde
Distance Float Abstand (in Meter) des aktuellen Ein-/Austrittspunktes bezogen auf die Mitte des Geofence-Kreises, falls „Aktuelle Position senden“ in der App beim Webhook gewählt wurde
Orientation Float Himmelsrichtung (als Name) des aktuellen Ein-/Austrittspunktes bezogen auf die Mitte des Geofence-Kreises, falls „Aktuelle Position senden“ in der App beim Webhook gewählt wurde
Timestamp Integer UnixTimestamp der letzten Aktivität.
Beispielstandort (Büro) Boolean Present oder Absent. Information wird von Gefency geliefert.
aktuelle Longitude Float Aktueller Breitengrad
aktuelle Latitude Float Aktueller Längengrad
Motion Integer aktueller Bewegungszustand wie Gehen, Autofahren etc.
WifiBSSD String BSSID des verbundenen WLANs
WifiSSID String SSID des verbundenen WLANs

Beispiel:

Profile:

Es werden keine zusätzlichen Profile hinzugefügt

7. WebFront

Es gibt keine native Darstellung via WebFront oder in den mobilen Apps. Geräte und Variablen, welche angezeigt werden sollen, können via Link angezeigt werden.

8. PHP-Befehlsreferenz

Es sind keine PHP-Skriptbefehle vorhanden.