Skip to end of metadata
Go to start of metadata
Autor
Logo

Status

BETA

Version0.2.2
Min. LB Version
ZweckSchnittstelle zur easee.cloud  um Daten der Easee Home Wallbox(en) abzufragen und zu ändern.
LanguagesDE
DiskussionPlugin: Easee Home - Wallbox - loxforum.com
 Version History...

Version 0.0.1

  • erste öffentliche Version

Version 0.0.6

  • fix für die last und ongoing Session wenn noch keine vorhanden war/ist.
  • Token word jetzt überprüft nach dem speichern
  • Wenn der Token erfolgreich erstellt wurden die Wallboxen in diesem Account abgefragt und angezeigt.
  • Error-Log wird im Fehlerfall für Token und Abfragen erstellt
  • Englische Sprache hinzugefügt.

Version 0.1.1

  • Info-Log z.B. wenn neuer Token erzeugt wird
  • Token Refresh → mehr Sicherheit da nur der Token und Refresh-Token übermittelt werden aber kein User/Passwort.
    Verbindung ist aber weiterhin verschlüsselt.
  • Perfomance- und Detail-Verbesserungen
  • Abfrage für /details wurde aus dem Code genommen da hier der Pin der Box in Klartext angezeigt wird.

Version 0.2.0

  • Verbrauchswerte werden jetzt wenn die Box lädt mit aktualisiert. Normal sendet die Cloud die Werte zyklisch, und nicht bei jedem Datenabruf.
  • Daten können auch per MQTT an den MiniServer übermittelt werden.

Version 0.2.1

  • fix - lock_state 

Version 0.2.2

  • Alle Settings sind jetzt setzbar. 


Inhalt



Funktion des Plugins

Das Plugin bietet die Möglichkeit die API der easee.cloud zu nutzen um Werte der Wallbox(en) abzufragen und zu verändern.
Mit den Benutzdaten wird ein Token erstellt der für einen Tag gilt, und wenn nötig erneuert wird. 
Die Verbindung zur Cloud ist immer verschlüsselt, und die Daten werden nie im Plain-Text gesendet und sind somit nicht lesbar.

Konfigurationsoptionen

Nutzerdaten
Benutzername = Email-Adresse mit der ihr euch an der easee.cloud anmeldet
Passwort = Passwort mit der ihr euch an der easee.cloud anmeldet

MiniServer
Wenn ihr mehr als einen MiniServer habt könnt ihr hier auswählen an welchen die Antowrt gesendet wird.

Rückgabe
Ihr könnt die Werte auf 2 Arten zurück erhalten, einmal als JSON oder als UDP, das ihr mit der Befehlserkennung auswerten könnt.

Einrichtung in der Loxone Config Software

Abfrage / Einstellungen ändern
Um die Daten zu empfangen oder Werte zu ändern werden virtuelle Ausgänge angelegt.
Als IP gebt ihr die IP des Loxberry auf dem das Plugin installiert ist an.


Virtueller Ausgang Befehle
Die Basis URL die ihr bei Befehl EIN eintrag müsst ist /plugins/easee_home/easee.php gefolgt von den Parametern(?do=)(&type=)(&value=)(&id=EHxxxxxxx)

?do=xxxxxxxxxx&id=EHxxxxxxxx
configGibt die aktuelle Geräte-Konfiguration zurück.
stateGibt den aktuellen Status und Werte zurück.
start_chargingStarte das laden wenn ein Fahrzeug angeschlossen ist.
stop_chargingStoppt das laden wenn über ein Zeitprofil geladen wird. Wurde manuell gestartet kann nur mit Start/Pause/Resume gearbeitet werde.
pause_chargingPausiert das Laden.
resume_chargingStartet das Laden erneut nachdem es pausiert wurde.
rebootStartet die Wallbox neu.
force_rebootStartet die Wallbox neu auch wenn z.B. gerade geladen wird. (nur im Notfall nutzen)
latestGibt Verbrauchswerte des letzten Ladevorgang zurück.
ongoingGibt Verbrauchswerte des aktuell laufenden Ladevorgang zurück.
post_settingsSchreibt Werte ins Gerät.
post_lock_stateVer-/Entriegelt das Kabel, auch wenn z.B. kein Auto geladen wird. (Wird ein Fahrzeug geladen verriegelt die Wallbox das Kabel automatisch)
?do=post_settings&type=xxxxxxxxx&value=xxxxx&id=EHxxxxxxxx

enabled

Aktiviert oder deaktiviert die Wallbox. (&value=true/false)
enableIdleCurrentAktiviert die Freigabe auch Strom zu liefern wenn die Batterie voll ist, z.B. für Standheizung (&value=true/false)
limitToSinglePhaseChargingSperrt das3 Phasen laden,z.B. bei Renault Zoe nötig. (&value=true/false)
lockCablePermanentlySperrt das Kabel permanent. (&value=true/false)
smartButtonEnabledAktiviert den SmartButton am Gerät. (&value=true/false)
phaseModeStell den Lademodus mit 1/3 Phasen oder automatisch ein. (&value=1/2/3)
1=1Ph/2=Auto/3=3Ph.
 smartChargingAktiviert das SmartCharging um z.B. in der günstigsten Zeit zu laden. (&value=true/false)
localPreAuthorizeEnabled?? (&value=true/false)
localAuthorizeOfflineEnabled?? (&value=true/false)
allowOfflineTxForUnknownId?? (&value=true/false)
offlineChargingModeLegt fest ob auch ohne WLAN/SIM-Verbindung geladen werden darf. (&value=true/false)
Es werden keine Daten an die Cloud übertragen. Ob diese auf dem Gerät gespeichert sind kann ich nicht sagen.
authorizationRequiredSchaltet die RFID Freigabe am Gerät ein/aus. (&value=true/false)
remoteStartRequired(&value=true/false)
ledStripBrightnessSteuert die Helligkeit des LED-Streifen am Gerät. (&value=0-100)
maxChargerCurrentGibt die maximale Stromstärke zu Ladung vor. (&value=6-xx)
dynamicChargerCurrentGibt die dynamische Stromstärke vor. ((&value=6-xx)
Beim starten eines neuen Ladevorgang wird diese auf 32Azurück gesetzt.
?do=post_lock_state&value=xxxxxx&id=EHxxxxxxxxBefehl zum verriegeln des Ladekabel.  (&value=true/false)



Beispiele
Befehle zur Konfigurations- und Status-Abfrage
/plugins/easee_home/easee.php?do=state&id=EHxxxxxx
/plugins/easee_home/easee.php?do=config&id=EHxxxxxx

Befehle für Start/Stopp/Pause/Resume
/plugins/easee_home/easee.php?do=start_charging&id=EHxxxxxx
/plugins/easee_home/plugins/easee_home/easee.php?do=pause_charging&id=EHxxxxxx
/plugins/easee_home/easee.php?do=stop_charging&id=EHxxxxxx
/plugins/easee_home/easee.php?do=resume_charging&id=EHxxxxxx

Befehl zum ändern von Einstellungen
/plugins/easee_home/easee.php?do=post_settings&type=enabled&value=true&id=EHxxxxxx
/plugins/easee_home/easee.php?do=post_settings&type=maxChargerCurrent&value=10&id=EHxxxxxx
/plugins/easee_home/easee.php?
do=post_lock_state&value=true&id=EHxxxxxxxx

Tipp!
Ihr könnt nach dem ihr eure Daten im Plugin gespeichert habt auch jederzeit das ganz im Browser testen. (JSON Rückgabe aktiveren)
http://loxberry_ip//plugins/easee_home/easee.php?do=config&id=EHxxxxxx  (xxxxxxx gehen eure ID austauschen)



Empfang UDP

Für den Empfang kann man virtuelle Eingänge mit Befehlserkennung oder virtuelle UDP Eingänge anlegen.

 Beim UDP Empfangsport gebt ihr den gleichen an den ihr im Plugin vorgegeben habt.

Erkennung z.B. für die Spannung.
Es fäng immer mit der ID EHxxxxxxxx_ an gefolgt von den Wertenamen.


Empfang MQTT

Die Daten können auch per MQTT-Plugin Empfangen werden.
Alle Werte werden aus dem MQTT-Plugin geladen, das einzige was man noch machen muss, ist die Subscription easee/# 

Die Daten werden am /easee/EHxxxxx/value=x gesendet.
EH steht für die jeweilige Seriennummer der Wallbox.


Alle Werte findet ihr unter: Swagger UI (easee.cloud) (/api/chargers/{id}/config) und (/api/chargers/{id}/state)


Diskussion

Plugin: Easee Home - Wallbox - loxforum.com