V-ZUG Home
Categories:
Gesammelte Informationen über die V-ZUG Home API aus dem Internet und hoffentlich auch direkt von V-ZUG und selber Herausgefundenes
V-ZUG API
API Version abfragen
<http://{IP-Address}/ai?command=getAPIVersion>
<http://{IP-Address}/hh?command=getAPIVersion>
Neue API:
{“value”:“1.7.0”}
Alte API:
{“value”:“1.1.0”}
Bei mir funktioniert das Abfragen mit ai auch mit der neuen API.
Gerätestatus abfragen
<http://{IP-Address}/ai?command=getDeviceStatus>
<http://{IP-Address}/hh?command=getDeviceStatus>
Beispiel Output (Seriennummer und deviceUID unkenntlich gemacht):
{"DeviceName":"","Serial":"##### ######","Inactive":"true","Program":"","Status":"","ProgramEnd":{"End":"","EndType":"0"},"deviceUuid":"##########"}
Programmstatus abfragen
<http://{IP-Address}/hh?command=getProgram>
Gerätemodell abfragen
<http://{IP-Address}/ai?command=getModelDescription>
Beispiel Output:
Adora SL
oder
AdoraWash V4000
oder
AdoraDry V4000
Noch unstrukturierte Angaben von https://github.com/marcelzoller/loxberry-plugin-vzug :
# API Version Abfragen
# http://{IP-Address}/ai?command=getAPIVersion
# {"value":"1.7.0"}
# Version 1.1.0 ist die alte APIVersion
# Version 1.7.0 ist die neue APIVersion mit Abfrage mit hh?command=getProgram
# http://{IP-Address}/hh?command=getProgram
# [{"id":2500,"name":"Stark trocken","status":"active","duration":{"set":12000,"act":1271},"allowedStatusChanges":{"options":["idle","paused"]}}]
#
# http://{IP-Address}/hh?command=doTurnOff
# http://{IP-Address}/hh?command=doTurnOff
#
# http://{IP-Address}/hh?command=setDeviceName&value=' + encodeURIComponent(deviceName)
#
# http://{IP-Address}/hh?command=getZHMode
# {"value":2}
# http://{IP-Address}/ai?command=getModelDescription
# Adora SL
# http://{IP-Address}/ai?command=getLastPUSHNotifications
# [{"date":"2021-06-01T02:33:55","message":"Programm Eco-Programm gestartet"} ,{"date":"2021-05-31T22:31:38","message":"Programm Automatik beendet - Energie: <0,1 kWh, Wasser: 0 ℓ"} ,{"date":"2021-05-31T21:59:34","message":"Programm Eco-Programm beendet - Energie: <0,1 kWh, Wasser: 0 ℓ"} ]
# http://{IP-Address}/hh?command=setProgram&value=%7B%22id%22:50%7D // URL decode {"id":50}
# setProgram
# id: 50 = Eco Modus
# id: 51 = Auto
# id: 52 = ALltag Kurz
# id: 53 = Sprint
# id: 54 = Intensiv
# id: 55 = Silent
# id: 56 = Patry
# id: 57 = Glas
# id: 58 = Fondue / Raclette
# id: 59 = Hygiene
# id: 61 = Vorspülen
# http://{IP-Address}/hh?command=setProgram&value=%7B%22partialload%22:false,%22eco%22:%22none%22,%22steamfinish%22:false%7D
#
# http://{IP-Address}/hh?command=setProgram&value={"partialload":true,"steamfinish":true,"eco":"optiStart"}
# eco: energySaving
# eco: optiStart
# eco: none
# steamfinish: true / false
# partialload: true / false
Firewall Ports
Bisher herausgefunden:
- Port 7
- Port 80
- Port 443
- Port 8883 (MQTT)?
V-ZUG Developer Portal
Gemäss diesem Beitrag soll es ein Developer Portal geben. Bisher aber keine Neuigkeiten:
https://community.symcon.de/t/vzug-home-auslesen/53526/2
Offene Fragen
- Was versucht das Gerät über Port 8883 (MQTT?) ins Internet zu übermitteln?
- Wieso wird Port 7 benötigt?
Quellen
https://www.loxwiki.eu/display/LOXBERRY/V-ZUG-HOME
https://github.com/marcelzoller/loxberry-plugin-vzug
https://github.com/loleg/v-zug-recipe-parser
https://community.symcon.de/t/vzug-home-auslesen/53526