MQTT-API
Der API State wird auch per MQTT veröffentlicht.
Jedes Feld wird zu einem eigenen Topic, verschachtelte Objekte und Listen werden in einzelne Sub-Topics aufgelöst (Index beginnt bei 1).
Nur lesbare Topics
Abschnitt betitelt „Nur lesbare Topics“Standort
Abschnitt betitelt „Standort“evcc/site/siteTitle: Titel des Standortsevcc/site/currency: konfigurierte Währungevcc/site/homePower: aktueller Hausverbrauch (W)evcc/site/pvPower: aktuelle PV-Erzeugung (W)evcc/site/grid/power: aktuelle Netzleistung (W, positiv = Bezug)evcc/site/battery/power: Batterieleistung (W, positiv = Entladung)evcc/site/battery/soc: Batterieladestand (%)evcc/site/greenShareHome: PV-Anteil am Hausverbrauch (0 bis 1)evcc/site/greenShareLoadpoints: PV-Anteil am Ladepunktverbrauch (0 bis 1)evcc/site/tariffGrid: aktueller Netzbezugstarifevcc/site/tariffFeedIn: aktuelle Einspeisevergütungevcc/site/tariffCo2: aktuelle CO₂-Intensitätevcc/site/batteryGridChargeActive: Netzladen der Batterie aktiv (true/false)
Ladepunkte
Abschnitt betitelt „Ladepunkte“Alle Ladepunkt-IDs beginnen bei 1.
evcc/loadpoints: Anzahl der verfügbaren Ladepunkteevcc/loadpoints/<id>/title: Ladepunkttitelevcc/loadpoints/<id>/connected: Fahrzeug verbunden (true/false)evcc/loadpoints/<id>/charging: lädt gerade (true/false)evcc/loadpoints/<id>/enabled: Ladepunkt aktiviert (true/false)evcc/loadpoints/<id>/mode: Lademodus (off,smart,now)evcc/loadpoints/<id>/alwaysCharge: Option Dauerhaft laden (off,on,once)evcc/loadpoints/<id>/chargePower: aktuelle Ladeleistung (W)evcc/loadpoints/<id>/chargedEnergy: geladene Energie im Ladevorgang (Wh)evcc/loadpoints/<id>/chargeDuration: Ladedauer (ns)evcc/loadpoints/<id>/chargeRemainingDuration: verbleibende Ladedauer (ns)evcc/loadpoints/<id>/chargeRemainingEnergy: verbleibende Energie (Wh)evcc/loadpoints/<id>/chargeTotalImport: Zählerstand Ladezähler (Wh)evcc/loadpoints/<id>/vehicleName: Fahrzeugbezeichnerevcc/loadpoints/<id>/vehicleTitle: Anzeigename des Fahrzeugsevcc/loadpoints/<id>/vehicleSoc: Fahrzeugladestand (%)evcc/loadpoints/<id>/vehicleRange: Reichweite des Fahrzeugs (km)evcc/loadpoints/<id>/phasesActive: aktive Phasenevcc/loadpoints/<id>/planActive: Ladeplan gerade aktiv (true/false)evcc/loadpoints/<id>/sessionEnergy: Energie des Ladevorgangs (Wh)evcc/loadpoints/<id>/sessionSolarPercentage: PV-Anteil des Ladevorgangs (%)evcc/loadpoints/<id>/smartCostActive: Smartes Netzladen gerade aktiv (true/false)evcc/loadpoints/<id>/effectivePriority: effektive Priorität
Schreibbare Topics
Abschnitt betitelt „Schreibbare Topics“Um den Wert eines schreibbaren Topics zu ändern, hänge /set an das Topic an und sende den neuen Wert.
mosquitto_pub -t "evcc/loadpoints/1/phasesConfigured/set" -m "3"Zeitangaben erfolgen in UTC im Format yyyy-mm-ddThh:mm:ssZ, z. B. 2023-03-05T07:00:00Z (= 5. März 2023, 8:00 Uhr MEZ).
Folgende Zeichenfolgen werden als leere Werte erkannt: nil, null, none, -.
Damit lassen sich zuvor gesetzte Schwellenwerte zurücksetzen:
mosquitto_pub -t "evcc/site/batteryGridChargeLimit/set" -m "none"Standort
Abschnitt betitelt „Standort“evcc/site/prioritySoc: Prioritäts-Ladestand der Batterieevcc/site/bufferSoc: Puffer-Ladestand der Batterieevcc/site/bufferStartSoc: Start-Ladestand für den Batteriepufferevcc/site/residualPower: Residualleistung am Netzanschlussevcc/site/batteryGridChargeLimit: Preislimit für das Netzladen der Batterieevcc/site/batteryDischargeControl: Entladesteuerung der Batterie aktivieren/deaktivieren (true/false)evcc/site/batteryMode: externer Batteriemodus (normal,hold,charge,holdcharge,discharge), steuert alle regelbaren Batterien direkt, überschreibt andere evcc-Modi und wird nach 60 s zurückgesetztevcc/site/smartCostLimit: Preislimit für smartes Netzladen aller Ladepunkteevcc/site/smartFeedInPriorityLimit: Einspeisegrenze für alle Ladepunkte
Ladepunkte
Abschnitt betitelt „Ladepunkte“evcc/loadpoints/<id>/mode: Lademodus (off,smart,now)evcc/loadpoints/<id>/alwaysCharge: Option Dauerhaft laden (off,on,once), nur im Smart-Modusevcc/loadpoints/<id>/minSoc: Mindestladungevcc/loadpoints/<id>/limitSoc: Ladelimit in %, nur für Online-Fahrzeugeevcc/loadpoints/<id>/limitEnergy: Energielimit in kWh, nur für Offline-Fahrzeugeevcc/loadpoints/<id>/planEnergy: Ladeplan-Energie (JSON-Payload:{"value": 50, "time": "2023-03-05T07:00:00Z"})evcc/loadpoints/<id>/phasesConfigured: konfigurierte Phasenevcc/loadpoints/<id>/minCurrent: minimaler Ladestromevcc/loadpoints/<id>/maxCurrent: maximaler Ladestromevcc/loadpoints/<id>/solarShare: PV-Anteil an der Mindestladeleistung (0 bis 1)evcc/loadpoints/<id>/enableThreshold: Einschaltschwelleevcc/loadpoints/<id>/enableDelay: Einschaltverzögerung (s)evcc/loadpoints/<id>/disableThreshold: Ausschaltschwelleevcc/loadpoints/<id>/disableDelay: Ausschaltverzögerung (s)evcc/loadpoints/<id>/batteryboost: Batterie Boost aktiviert (1/0)evcc/loadpoints/<id>/batteryBoostLimit: Ladestandlimit für Batterie Boostevcc/loadpoints/<id>/priority: Prioritätswertevcc/loadpoints/<id>/smartCostLimit: Preislimit für smartes Netzladenevcc/loadpoints/<id>/smartFeedInPriorityLimit: Einspeisegrenzeevcc/loadpoints/<id>/planStrategy: Ladeplan-Strategie (JSON)evcc/loadpoints/<id>/vehicle: Fahrzeug setzen (Fahrzeugname)
Fahrzeuge
Abschnitt betitelt „Fahrzeuge“Die Fahrzeugnamen findest du unter evcc/vehicles.
evcc/vehicles/<name>/minSoc: Mindestladung in %evcc/vehicles/<name>/limitSoc: Ladelimit in %evcc/vehicles/<name>/planSoc: Ladeplan-Ladestand (JSON-Payload:{"value": 50, "time": "2023-03-05T07:00:00Z"})evcc/vehicles/<name>/planStrategy: Ladeplan-Strategie (JSON)