HowTo: Einbindung "MyStrom WiFi Button"

[christoph.gmuer]

Anbei eine kurze Anleitung zur Einbindung von "MyStrom WiFi Button" (https://mystrom.ch/wifi-button). Aus meiner Sicht ein genialer, preiswerter kleiner "Helfer".

Loxone Konfiguration

• Erstellen eines VI (Anschlussnummer merken, z.B. VI15)
• Erstellen eines dedizierten Benutzers in Loxone und auf virtuellen Eingang berechtigen/limitieren
• Mittels folgendem Browser-Aufruf kann man den erstellen VI inkl. Benutzer/Kennwort testen
  • http://[Benutzername]:[Kennwort]@[IP-Miniserver]/dev/sps/io/vi15/1
    • Browser-Ausgabe: <LL control="dev/sps/io/vi15/1" value="1.000" Code="200"/>
  • http://[Benutzername]:[Kennwort]@[IP-Miniserver]/dev/sps/io/vi15/0
    • Browser-Ausgabe: <LL control="dev/sps/io/vi15/0" value="0.000" Code="200"/>

WiFi Button Konfiguration

• WiFi Button mittels MyStrom App in WiFi einbinden und am Besten gleich eine fixe IP vergeben beim Hinzufügen via App
• In der App müssen keinerlei weitere Einstellungen vorgenommen werden
• IP-Adresse des Button identifizieren (falls nicht fixe IP vergeben)
• WiFi Button via REST API konfigurieren (Dokumentation), dazu benötigt man die [IP] und [MAC] des WiFi Button (in App unter "Technische Daten" ersichtlich)
  • Mittels folgendem Browser-Aufruf kann man die aktuelle Konfiguration des WiFi Button ansehen: http://[IP]/api/v1/device/[MAC]
  • Wichtig: MAC-Adresse ohne ":" und in Grossbuchstaben
  • Zur Konfiguration selber verwende ich die Google Chrome Extension "Advanced REST client"
    • Request URL: http://[IP]/api/v1/device/[MAC]
    • POST
    • Other methods: application/x-www-form-urlencoded
    • Raw headers: Content-Type: application/x-www-form-urlencoded
    • Raw payload: single=get://[Benutzername]:[Kennwort]@[IP-Miniserver]/dev/sps/io/vi15/pulse&double=&long=&touch=
    • Wichtig: Nach Eingabe des Raw payload auf ENCODE PAYLOAD klicken
    • SEND
  • Erledigt, nun kann man mit http://[IP]/api/v1/device/[MAC] prüfen ob der Befehl korrekt geschrieben wurde
  • Das Beispiel hier konfiguriert nur die WiFi Button Funktion "single" (Einfachklick), kann natürlich entsprechend erweitert werden um "double" (Doppelklick), "long" und "touch"

Wichtiger Hinweis (steht auch in REST API Dokumentation)
Die Schnittstelle des WiFi Button ist transparent und verwendet keinerlei Authentifizierung. Zudem ist das Kennwort für Zugriff auf Miniserver im Klartext ersichtlich. Sichert eure WiFi entsprechend ab und verwendet den Button nicht für kritische Aufgaben!

Viel Spass

PS: Vielen Dank an MyStrom für schnelle Implementierung von "Basic Authentication". Toller Service!