Geräteprofil · Wallboxen
evcc Loadpoint (MQTT)
Hinweis: Dieses Profil ist nach dem Quellcode von evcc 0.317.2 (
server/mqtt.go,core/loadpoint.go,core/loadpoint_api.go,core/keys) erstellt.
evcc ist ein quelloffener Energiemanager für das Laden von Elektroautos. evcc steuert selbst rund 100 Wallbox-Modelle und liest über die Hersteller-Clouds dutzender Fahrzeugmarken Ladestand und Reichweite. Über MQTT gibt evcc alle diese Werte weiter – mit diesem Add-on kommt also jede Wallbox und jedes Fahrzeug, das evcc unterstützt, in nomos, ohne eigenes nomos-Profil pro Hersteller.
Ein Ladepunkt (Loadpoint) ist in evcc eine Wallbox samt dem gerade angesteckten Fahrzeug. Für jeden Ladepunkt wird in nomos ein eigenes Gerät angelegt. PV, Netz, Hausbatterie und Hausverbrauch liefert das Profil evcc Site.
Voraussetzungen
- evcc 0.316 oder neuer empfohlen. Ab 0.316 kennt evcc die Lademodi
off,nowundsmartplus die Option „Immer laden“ (alwaysCharge). Ältere Versionen meldenpv/minpvstattsmart; das Profil zeigt beides an, „Smart“ und „Immer laden“ funktionieren dort aber nicht. - Ein MQTT-Broker, den evcc und nomos gemeinsam nutzen:
- entweder der Broker des nomos Controllers (Port 1883, Zugangsdaten aus den nomos-MQTT-Einstellungen),
- oder ein vorhandener Broker (z. B. Mosquitto), auf den in den nomos-MQTT-Einstellungen umgestellt wird.
- MQTT in evcc einschalten – in der
evcc.yaml(oder in der evcc-Oberfläche unter Konfiguration → MQTT):
mqtt:
broker: 192.168.1.10:1883 # IP des nomos Controllers (oder des eigenen Brokers)
topic: evcc # Wurzel-Topic, muss gesetzt sein
user: evcc # nur falls der Broker Zugangsdaten verlangt
password: geheim
evcc veröffentlicht dann jeden Wert als eigenes, retained Topic, die Ladepunkte unter evcc/loadpoints/1/..., evcc/loadpoints/2/... usw., und nimmt Änderungen unter <topic>/set entgegen.
Einrichtung
- Skills → MQTT aktivieren (falls noch nicht aktiv) und den Broker wie oben beschrieben einstellen
- Skills → Add-ons: Profil evcc Loadpoint importieren
- Gerät anlegen, Namen eingeben und als MQTT Topic
<Wurzel-Topic>/loadpoints/<Nummer>eintragen – für den ersten Ladepunkt im Normalfallevcc/loadpoints/1 - Für jeden weiteren Ladepunkt ein weiteres Gerät mit
evcc/loadpoints/2,evcc/loadpoints/3… anlegen. Die Nummer ist die Reihenfolge der Ladepunkte in evcc, beginnend bei 1 (evcc/loadpointsenthält die Anzahl).
Datenbereich
Alle Topics relativ zum MQTT Topic des Geräts (z. B. evcc/loadpoints/1/chargePower).
| Topic | nomos-Wert | Inhalt |
|---|---|---|
mode |
mode |
Lademodus: off (Aus), now (Sofort), smart; vor evcc 0.316 pv / minpv |
mode |
state |
Laden ein/aus: aus bei Modus off, sonst ein |
alwaysCharge |
always_charge |
Immer laden im Smart-Modus: off / on / once (ab 0.316) |
charging |
charging |
Fahrzeug lädt (true/false) |
connected |
vehicle_connected |
Fahrzeug angesteckt (true/false) |
enabled |
charger_enabled |
Wallbox von evcc freigegeben (ausgeblendet) |
chargerStatusReason |
status_reason |
Hinweis der Wallbox: wartet auf Autorisierung / Abstecken nötig |
chargePower |
power |
Ladeleistung, W |
chargeDuration |
charge_duration |
Ladedauer, min (evcc: Sekunden) |
chargeRemainingDuration |
charge_remaining |
Restladedauer, min (evcc: Sekunden) |
connectedDuration |
connected_duration |
Dauer angesteckt, min (ausgeblendet) |
maxCurrent, minCurrent |
amperelimit, min_current |
Max./Min. Ladestrom, A |
offeredCurrent |
offered_current |
Aktuell vorgegebener Strom, A (ausgeblendet) |
phasesConfigured |
charge_phases |
Phasen-Einstellung: 0 = automatisch, 1, 3 |
phasesActive |
phases_active |
Aktive Phasen |
limitSoc, minSoc |
charge_limit, min_soc |
Ladelimit und Mindestladung des Ladepunkts, % |
limitEnergy |
energylimit |
Energielimit, kWh (0 = aus) |
sessionEnergy |
e_session |
Geladene Energie der Session, Wh |
chargeTotalImport |
e_total |
Zählerstand der Wallbox, kWh (nur Wallboxen mit Zähler) |
sessionSolarPercentage |
solar_share |
Solaranteil der Session, % |
sessionPrice |
session_price |
Kosten der Session (nur mit Tarif) |
chargeRemainingEnergy |
charge_remaining_energy |
Restenergie bis zum Ziel, Wh (ausgeblendet) |
chargeCurrents/l1..l3 |
l1_current … l3_current |
Strom je Phase, A (nur Wallboxen mit Phasenmessung) |
chargeVoltages/l1..l3 |
l1_voltage … l3_voltage |
Spannung je Phase, V |
vehicleTitle |
vehicle |
Name des erkannten Fahrzeugs |
vehicleName |
vehicle_name |
Interner evcc-Name des Fahrzeugs (ausgeblendet) |
vehicleSoc |
battery |
Ladestand des Fahrzeugs, % |
vehicleRange |
range |
Reichweite, km |
vehicleOdometer |
odometer |
Kilometerstand, km |
vehicleLimitSoc |
vehicle_limit_soc |
Ladelimit im Fahrzeug, % (ausgeblendet) |
planActive, smartCostActive |
plan_active, smart_cost_active |
Ladeplan aktiv / günstiger Tarif aktiv (ausgeblendet) |
title |
title |
Name des Ladepunkts in evcc (ausgeblendet) |
Fahrzeugwerte gibt es nur, wenn das Fahrzeug in evcc eingerichtet ist und gerade an diesem Ladepunkt erkannt wurde.
Schreibbar (nomos sendet an <Topic>/set, nicht retained):
| nomos-Wert | Topic | Payload |
|---|---|---|
state ein / switchon |
mode/set |
now |
state aus / switchoff |
mode/set |
off |
mode |
mode/set |
off, now, smart, pv, minpv |
always_charge |
alwaysCharge/set |
off, on, once |
charge_limit |
limitSoc/set |
0–100 |
min_soc |
minSoc/set |
0–100 |
amperelimit |
maxCurrent/set |
6–32 |
min_current |
minCurrent/set |
6–32 |
charge_phases |
phasesConfigured/set |
0, 1, 3 |
energylimit |
limitEnergy/set |
0–200 |
Hinweise
- Herkunft der Angaben. Topics, Einheiten und Schreibbefehle stammen aus dem evcc-Quellcode (0.317.2).
- Laden ein schaltet auf Sofort (
now, volle Leistung, auch aus dem Netz), Laden aus auf Aus (off). Für PV-Überschussladen den Lademodus Smart wählen. - Ab evcc 0.316 nimmt evcc
pvundminpvweiter an, stellt aber aufsmartum (mit „Immer laden“ aus bzw. ein). charge_limit(limitSoc) wirkt nur bei Fahrzeugen, deren Ladestand evcc kennt; bei Fahrzeugen ohne Anbindung gilt stattdessenenergylimit.e_sessionist in Wh: die nomos-Skalierung rundet auf ganze Zahlen, eine Umrechnung in kWh würde die Nachkommastellen verlieren.- Der Ladepunkt hat keine eigene Erreichbarkeit: evcc meldet nur für die ganze Instanz
evcc/status, und das MQTT Topic des Ladepunkts (evcc/loadpoints/1) reicht nicht bis dorthin. Die Erreichbarkeit zeigt das Gerät evcc Site. - evcc meldet keinen Fehlerzustand der Wallbox und keinen Status-Code (A/B/C); es gibt deshalb weder
malfunctionnochstatus. Den Zustand zeigenchargingundvehicle_connected. - evcc löscht beim Start und beim Beenden alle seine retained Topics, indem es leere Nachrichten sendet. nomos liest eine leere Nachricht bei Ja/Nein-Werten als „ein“ –
chargingundvehicle_connectedstehen dann kurz (beim Beenden bis evcc wieder läuft) fälschlich auf „ein“, Zahlen werden leer. - Ein Fahrzeug manuell auswählen (
vehicle/set) und Ladepläne (planEnergy,planStrategy) sind nicht enthalten.