
HTTP API
EVSE-WiFi lässt sich mithilfe einer HTTP API von anderen Geräten fernsteuern. Dies ermöglicht gesteuerte Ladevorgänge und Anpassungen des Ladestroms durch andere Geräte. Die folgenden Aufrufe sind möglich:
getParameters()
gibt die folgenden Parameter im JSON-Format zurück:
Parameter Beschreibung Datentyp
vehicleState Fahrzeugstatus (1: bereit | 2: Fahrzeug angeschlossen | 3: Fahrzeug lädt) integer
evseState EVSE Status (true: EVSE freigeschaltet | false: EVSE gesperrt) boolean
maxCurrent Maximaler Ladestrom (abhängig vom PP-Widerstand und dem konfigurierten maximalen Ladestrom in EVSE-WiFi – je nachdem welcher Wert niedriger ist) integer
actualCurrent Aktueller Ladestrom in A (z.B. 20) integer
actualPower Aktuelle Ladeleistung (nur wenn Stromzähler angeschlossen ist) float
duration charging duration in milliseconds integer
alwaysActive Always Active Mode enabled (true/false) boolean
lastActionUser The user name of the user who performed the last action (activate/deactivate) String
lastActionUID The UID of the user who performed the last action (activate/deactivate) String
energy charged energy of the current charging process in kWh float
mileage charged energy in km float
meterReading actual meter reading in kWh float
currentP1 actual current in A (phase 1) float
currentP2 actual current in A (phase 2) float
currentP3 actual current in A (phase 3) float
Beispiel
GET http://192.168.4.1/getParameters
Antwort im JSON-Format:
{
"type": "parameters",
"list": [{
"vehicleState": 2,
"evseState": false,
"maxCurrent": 32,
"actualCurrent": 32,
"actualPower": 5.79,
"duration": 1821561,
"alwaysActive": false,
"lastActionUser": "GUI",
"lastActionUID": "GUI",
"energy": 9.52,
"mileage": 82.3,
"meterReading": 54.35,
"currentP1": 8.54,
"currentP2": 8.54,
"currentP3": 8.54
}]
}
getLog()
gibt die folgenden Parameter im JSON-Format zurück:
Parameter Beschreibung Datentyp
uid UID des RFID Tags mit dem der Ladevorgang freigeschalten wurde
„GUI“: Der Ladevorgang wurde über die Weboberfläche freigegeben
„API“: Der Ladevorgang wurde über die HTTP API freigegeben
„Button“: Der Ladevorgang wurde über den Taster freigegeben String
username Der zugehörige Benutzername, bei RFID-Freischaltung, ansonsten analog Parameter „uid“ String
timestamp Unix-Zeitstempel in Sekunden an dem der Ladevorgang gestartet wurde integer
duration Ladedauer in Millisekunden integer
energy Geladene Energiemenge in kWh float
price Zum Zeitpunkt des Ladevorgangs konfigurierter Preis in ct/kWh float (bis v.0.3.1: integer)
Beispiel
GET http://192.168.4.1/getLog
Antwort im JSON-Format:
{
"type": "latestlog",
"list": [{
"uid": "ABCD1234",
"username": "GUI",
"timestamp": 1523295915,
"duration": 7504266,
"energy": 10.32,
"price": 21
}, {
"uid": "-",
"username": "GUI",
"timestamp": 1523568920,
"duration": 1152251,
"energy": 2.17,
"price": 23
}]
}
setCurrent()
mit dem Aufruf setCurrent() wird der zulässige Ladestrom gesetzt (z.B. 18A)
Parameter Beschreibung Datentyp
current Zu setzender maximaler Ladestrom integer
Beispiel
GET http://192.168.4.1/setCurrent?current=8
… setzt den zulässigen Ladestrom auf 8A und gibt zurück:
S0_set current to 8A
Im Fehlerfall werden folgende Meldungen zurückgegeben
Antwort Beschreibung
E0_could not set current – internal error Interner Fehler (unspezifiziert)
E1_could not set current – give a value between x and y Falscher Wert angegeben
E2_could not set current – wrong parameter Falscher Parameter angegeben
setStatus()
Aktiviert/Deaktiviert die EVSE WB/DIN
Parameter Beschreibung Datentyp
active true: EVSE Aktivieren
false: EVSE Deaktivieren boolean
Beispiel
GET http://192.168.4.1/setStatus?active=true
… gibt den Ladevorgang frei und gibt zurück
S0_EVSE successfully activated
Im Fehlerfall werden folgende Meldungen zurückgegeben
Antwort Beschreibung
E0_could not activate EVSE – internal error Interner Fehler (unspezifiziert)
E0_could not deactivate EVSE – internal error Interner Fehler (unspezifiziert)
E1_could not process – give a valid value (true/false) Falscher Wert angegeben
E2_could not process – wrong parameter Falscher Parameter angegeben
E3_could not activate EVSE – EVSE already activated! EVSE ist bereits aktiviert
E3_could not deactivate EVSE – EVSE already deactivated! EVSE ist bereits deaktiviert
doReboot()
startet EVSE-WiFi neu
Parameter Beschreibung Datentp
reboot true: Startet EVSE-WiFi neu boolean
Beispiel
GET http://192.168.4.1/doReboot?reboot=true
gibt zurück
S0_EVSE-WiFi is going to reboot now...
Im Fehlerfall werden folgende Meldungen zurückgegeben
Antwort Beschreibung
E1_could not do reboot – wrong value Falscher Wert angegeben
E2_could not do reboot – wrong parameter Falscher Parameter angegeben
Danke vorab schon mal
