Skip to end of metadata
Go to start of metadata
AutorMarcel Zoller
Logo

Status

UNSTABLE

Version2019.09.08
Min. LB Version

LB 1.X.Y

Downloadhttps://github.com/marcelzoller/loxberry-plugin-sureflap/archive/2019.09.08.zip
ZweckAnsteuern und Abfragen vom SureFlap Geräten via Sure Petcare. https://surepetcare.io/
LanguagesEN, DE
Diskussion
 Version History...

Version 2019.09.08

  • erste öffentliche Version

https://github.com/marcelzoller/loxberry-plugin-sureflap

Inhalt



Mit diesen Plugin können Geräte von SureFlap via Sure Petcare (https://surepetcare.io/) abgefragt oder angesteuert werden. 

Aktuell können die folgenden Informationen von Sure Petcare Portal abgefragt oder angesteuert werden.

Abfragen:

  • SurFlap Geräte Abfrage (getDevices.php)
  • Haustiere Abfragen (getPet.php)
  • Aktuelle Positionen (Innen/Aussen von den Haustieren Abfragen (getPetLocation.php

Ansteuern:

  • SureFlap Türe Lock Mode setzten (setLockMode.php)
  • Haustier Position (Innen/Aussen) setzten (setPetLocation.php)
  • SureFlap Hub LED Helligkeit setzten (setHubLedBrightness.php) 

Download

Funktion des Plugins

Von der Loxone können mit virtuellen Ein-/Ausgängen Werte abgefragt oder geschrieben werden.

Installation und Konfigurationsoptionen Loxberry

Plugin via Github-Link auf dem Loxberry installieren. Es müssen nur wenige Einstellungen getätigt werden.

  • E-Mail Account: Hier muss der Account vom Sure Petcare Portal (https://surepetcare.io/) eingetragen werden.
  • Passwort: Hier muss das Passwort vom Sure Petcare Portal (https://surepetcare.io/) eingetragen werden.
  • Miniserver: Auswahl des Miniserver, wo der Status hingeschickt werden sollen (Noch nicht realisiert!).

Die Einstellung können mit dem Knopf "Speichern" setzt werden.

Ob die Einstellungen stimmen, kann einfach einen URL-Link (z.B. getDevices.php) angeklickt werden. Wir einen Webseite mit allen Geräten von SureFlap dargestellt, stimmet der Account und das Passwort.

Einrichtung in der Loxone Config Software

Virtueller Eingang (HTTP) / Abfrage Haustier aktuelle Position

Um die aktuelle Position des Haustier abzufragen, muss ein Virtueller Eingang (HTTP) erstellt werden. Wichtig ist hier, dass für jedes Hauszier einen eigenen virtueller Eingang erstellt wird. Die Abfrage kann via Web "getPetLocation.php" erfolgen und als Übergabeparameter muss der Name des Haustier mitgegeben werden.

Virtueller Eingang (HTTP)


Einstellungen Virtueller Eingang (HTTP)

URL: http://<LoxBerryName oder LoxBerry IP>/plugins/sureflap/getPetLocation.php?name=<Haustierkatze>

Abfragezyklus [s]: 300 => Hier würde ich nicht zu klein gehen, damit wir das Portal von SureFlap nicht unnötig belasten. Bei mit habe ih alle 5min.


URL Bsp.: http://172.16.200.69/plugins/sureflap/getPetLocation.php?name=Testkatze

Man kann die URL auch einfach in einem Browser eingeben und man herhält den folgenden Inhalt.


Hier sind alle Seiten aufgeführt, wo Informationen abgefragt werden können:

WebpageÜbergabe ParameterOutputBespiele
getPet.php

name=Testkatze


Bei keinem Parameter werden alle Haustiere aufgelistet.

PetID@22211
PetName@Testkatze
PetDescription@Komm
PetDOB@2019-09-05
PetWeight@12 kg
PetGender@[Female|Male]
PetSpecies@[Cat|Dog]
URL: http://172.16.200.69/plugins/sureflap/getPet.php?name=Testkatze
getPetLocation.php

name=Testkatze


Bei keinem Parameter werden alle Haustiere aufgelistet.

PetID@22211
PetName@Testkatze
PetDescription: Komm
PetDOB@2019-09-05
PetWeight@12 KG
PetGender@[Female|Male]
PetSpecies@[Cat|Dog]
PetLocation@[1=Im Haus|2=Aussen]
Testkatze's Current Location@[Inside|Outside]
URL: http://172.16.200.69/plugins/sureflap/getPetLocation.php?name=Testkatze
getDevices.php

devicename=Waschküchetür


Bei keinem Parameter werden alle Geräte aufgelistet.

DeviceID@122355
DeviceType@DualScan Cat Flap Connect
DeviceName@Waschküchetür
DeviceMACAddress@5623232323232323
DeviceSerialNumber@N005-1232323
URL: http://172.16.200.69/plugins/sureflap/getDevices.php?devicename=Waschküchetür


Alle diese Information kann man in die Loxone einbinden. Hier ein Beispiel, wie man die aktuelle Position des Haustier in die Loxone ingetriert.

Virtueller Eingang (HTTP) Befehl

Befehlserkennung: \i<name>\i\v

Einheit: <v>

Die Vorlage kann unter dem folgenden Link https://raw.githubusercontent.com/marcelzoller/loxberry-plugin-sureflap/master/VI_SureFlap%20Connect%20Testkatze.xml heruntergeladen werden.

Virtueller Ausgang (HTTP) 

Um Werte zu setzten, muss ein Virtueller Ausgang (HTTP) erstellt werden. Wichtig ist hier, dass für jedes Haustier/Gerät einen eigenen virtueller Ausgang erstellt wird. Das schrieben der Werte  kann via Web "z.B.: setHubLedBrightness.php" erfolgen und als Übergabeparameter müssen verschieden Parameter gesetzt werden. Diese sind unten in der Tabelle alle aufgeführt.


Virtueller Eingang (HTTP)


Einstellungen Virtueller Ausgang (HTTP)

URL: http://<LoxBerryName oder LoxBerry IP>


Befehl bei EIN: /plugins/sureflap/setHubLedBrightness.php?modeid=2


Hier sind alle Seiten aufgeführt, wo Werte geschrieben werden können:

WebpageÜbergabe ParameterOutputBespiele
setHubLedBrightness.php

mode=[bright|dim|off]

devicename=EFH Zoller


Bei keinem Parameter werden alle Haustiere aufgelistet.

DeviceID@122356
DeviceType@Hub
DeviceName@EFH Zoller
DeviceMACAddress@5623232323232323
DeviceSerialNumber@H008-1212122

SetHubLedMode@[1=off|2=bright|3=dim]
URL: http://172.16.200.69/plugins/sureflap/setHubLedBrightness.php?devicename=EFH%20Zoller&mode=off
setLockMode.php

mode=[in|out|both|none]

oder

modeid=[1=none|2=out|3=in|4=both]

devicename=Waschküchetür


Bei keinem Parameter werden alle Haustiere aufgelistet.

DeviceID@122355
DeviceType@DualScan Cat Flap Connect
DeviceName@Waschküchetür
DeviceMACAddress@5623232323232323
DeviceSerialNumber@N005-1232323

SetLockModeID@[1=none|2=out|3=in|4=both]
URL: http://172.16.200.69/plugins/sureflap/setLockMode.php?devicename=Waschküchetür&mode=both
setPetLocation.phplocation=[1=in|2=out]PetID@22211
PetName@Testkatze
PetDescription@Komm
PetDOB@2019-09-05
PetWeight@12 kg
PetGender@[Female|Male]
PetSpecies@[Cat|Dog]
SetPetLocation@[1=Im Haus|2=Aussen]
URL: http://172.16.200.69/plugins/sureflap/setPetLocation.php?nane=Testkatze&location=1

Die Vorlage kann unter dem folgenden Link https://raw.githubusercontent.com/marcelzoller/loxberry-plugin-sureflap/master/VO_Loxberry SureFlap.xml heruntergeladen werden.


Loxone Programm

Hier ist mein kleine Loxone Programm um alle Werte zu setzten und auch den aktuellen Status des Haustier auszulesen.

Besonderen Dank

Besonderen Dank muss ich an die Vorarbeiten richten:

Alex Toft - Sureflap PHP Module

Roadmap

Noch keine speziellen Ideen.

Fragen stellen und Fehler melden

Das PlugIn wird von mir noch weiterentwickelt und ich freue mich über Anregungen und Feedback.