====== Easee Home Wallbox ====== ++++ 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.  **Version 0.2.4** * Besser Handling von Datentypen * Autoupdate aktiviert **Version 0.2.7** * Die Abfragen für ongoing und latest haben einen Prefix bekommen da sie sich sonst gegenseitig überschreiben.  * Solltet ihr ihr ongoing und latest in eurer Config nutzen muss die Befehlserkennung geändert werden EHxxxxxx_ongoing_...... EHxxxxxx_lastest_.......\\ **Version 0.2.9** * MQTT wurde nicht gesendet wenn Json Ausagbe aktiv war. **Version 0.3.0** * fix - Token wurde nicht richtig erzeugt. **Version 0.3.1** * fix - Token Aktivierung-Timer nach dem speichern eingebaut **Version 0.3.2** * improve - Mehr Infos in error.log **Version 0.3.3** * fix - Token Erzeugung in WebUI **Version 0.3.4** * Stromstärke für den Sicherungskreis kann eingestellt werden "post_dynamicCurrent" * Infos über den Stromkreis kann abgerufen werden "circuits" ++++ ---- ===== 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 Antwort 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. {{plugins:easee_home_wallbox:1269957078.png?1000}} ===== Einrichtung in der Loxone Config Software ===== **Abfrage / Einstellungen ändern**\\ ** **Um den Empfang von Daten anzufordern oder Werte zu ändern, werden virtuelle Ausgänge angelegt. Die aktuellen Werte aus der Easee Cloud lassen sich dann über virtuelle Eingänge empfangen und weiterverarbeiten. Hinweis: Das Plugin fragt die Werte nicht selbständig ab (kein polling). Um die aktuellen Daten zu holen muss zunächst z. B. der Parameter "config" oder "state" (vollständige Liste siehe [[https://developer.easee.cloud]]) per virtuellem Ausgangsbefehl gesendet werden. Mit einem Implusgeber kann dies bei Bedarf alle paar Sekunden automatisch geschehen. \\ Als IP gebt ihr die IP des Loxberry auf dem das Plugin installiert ist an.\\ {{plugins:easee_home_wallbox:1269957055.png?250}}\\ \\ 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 | | | config | Gibt die aktuelle Geräte-Konfiguration zurück (Empfang über virtuelle Eingänge). | | state | Gibt den aktuellen Status und Werte zurück(Empfang über virtuelle Eingänge). | | circuits | Gibt den aktuellen Status der Einstellungen für den Stromkreis zurück | | start_charging | Starte das laden wenn ein Fahrzeug angeschlossen ist. | | stop_charging | Stoppt das laden wenn über ein Zeitprofil geladen wird. Wurde manuell gestartet kann nur mit Start/Pause/Resume gearbeitet werde. | | pause_charging | Pausiert das Laden. | | resume_charging | Startet das Laden erneut nachdem es pausiert wurde. | | reboot | Startet die Wallbox neu. | | force_reboot | Startet die Wallbox neu auch wenn z.B. gerade geladen wird. (nur im Notfall nutzen) | | latest | Gibt Verbrauchswerte des letzten Ladevorgang zurück. | | ongoing | Gibt Verbrauchswerte des aktuell laufenden Ladevorgang zurück. | | post_settings | Schreibt Werte ins Gerät. | | post_lock_state | Ver-/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) | | enableIdleCurrent | Aktiviert die Freigabe auch Strom zu liefern wenn die Batterie voll ist, z.B. für Standheizung (&value=true/false) | | limitToSinglePhaseCharging | Sperrt das3 Phasen laden,z.B. bei Renault Zoe nötig. (&value=true/false) | | lockCablePermanently | Sperrt das Kabel permanent. (&value=true/false) | | smartButtonEnabled | Aktiviert den SmartButton am Gerät. (&value=true/false) | | phaseMode | Stell den Lademodus mit 1/3 Phasen oder automatisch ein. (&value=1/2/3)\\ 1=1Ph/2=Auto/3=3Ph. | |  smartCharging | Aktiviert 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) | | offlineChargingMode | Legt 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. | | authorizationRequired | Schaltet die RFID Freigabe am Gerät ein/aus. (&value=true/false) | | remoteStartRequired | (&value=true/false) | | ledStripBrightness | Steuert die Helligkeit des LED-Streifen am Gerät. (&value=0-100) | | maxChargerCurrent | Gibt die maximale Stromstärke zu Ladung vor. (&value=6-xx) | | dynamicChargerCurrent | Gibt 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=EHxxxxxxxx | Befehl zum verriegeln des Ladekabel.  (&value=true/false) | | ?do=post_dynamicCurrent&value=P1,P2,P3&id=EHxxxxxxxx | Mit diesen Befehl kann die Stromstärke je Phase dynamisch eingestellt werden.\\ Diese Einstellung bezieht sich auf den ganzen Kreislauf, wenn z.B. mehrere Box an diesem Kreis hängen sind alle Boxen betroffen.\\ \\ Als value= müssen immer die Werte aller 3 Phasen mit gesendet werden\\ \\ Beispiel\\ value=16,0,0 oder value=16,16,16....\\ Wird der Wert für mehr als 4 Stunden nicht geändert fällt der Kreis zurück auf den fest eingestellten Standard | {{plugins:easee_home_wallbox:1269957054.png}} 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/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 im Plugin 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.\\ \\ {{plugins:easee_home_wallbox:1269957058.png?62}} Beim UDP Empfangsport gebt ihr den gleichen an den ihr im Plugin vorgegeben habt. Optional tragt ihr auch die Senderadress ein. Das ist dann der Loxberry hostname oder die IP (ohne http:%%//%%)\\ {{plugins:easee_home_wallbox:1269957057.png?180}} **Erkennung z.B. für die Spannung**.\\ Es fäng immer mit der ID EHxxxxxxxx_ an gefolgt von den Wertenamen. {{plugins:easee_home_wallbox:1269957059.png?97}} Eine UDP Vorlage mit den grundlegenden Parametern findet ihr hier: {{:plugins:easee_home_wallbox:udp_vorlage_easeewallbox.zip|UDP Vorlage für LoxConfig}}. Die IP und der Port müssen auf den jeweiligen Loxberry angepasst werden. Das gleiche gilt für den ID-Platzhalter der Easee Box. **Status des Chargers inkl. Weiterverarbeitung:** Mit dem "State" Befehlt, liefert die API eine Reihe von Ergebnissen zurück, welche über die UDP Eingänge aufgenommen werden können. Im Rückgabefeld "EHXXXX_chargerOpMode" erhält man Auskunft über den aktuellen Betriebs-Status in Form einer Zahl. Diese Zahl lässt sich am besten durch den Status Baustein übersetzen und dann vereinfacht für den Wallbox Baustein weiterverarbeiten. So wird in diesem Beispiel nur noch digital unterschieden, um damit den **Vc** Eingang des Wallbox Bausteins zu versorgen. 1=Auto verbunden, 0=Kein Auto verbunden {{plugins:easee_home_wallbox:pasted:20230124-144859.png}}\\ ** ** **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: [[https://developer.easee.cloud]] (/api/chargers/{id}/config) und (/api/chargers/{id}/state) \\ ===== Diskussion ===== [[https://www.loxforum.com/forum/projektforen/loxberry/plugins/295020-plugin-easee-home-wallbox|Plugin: Easee Home - Wallbox - loxforum.com]] \\