V-ZUG Home

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