evcc mit Modbus & MQTT konfigurieren: so klappt es

Kurzdiagnose

evcc liest Zähler, Wechselrichter und Wallbox über Modbus (TCP oder RTU) oder über MQTT ein. Modbus passt für Geräte mit fester IP und definierten Registern, MQTT für Geräte, die ihre Werte selbst auf einen Broker schicken (etwa Shelly oder Tasmota). Verbindet sich ein Gerät nicht, liegt es fast immer an falscher IP, falschem Port, falscher Modbus-ID oder einem nicht laufenden MQTT-Broker. Prüfe diese vier Punkte zuerst.

Modbus oder MQTT: was du wann nimmst

Modbus ist das Standardprotokoll für Wechselrichter, Smart-Meter und viele Wallboxen. evcc fragt dabei in festen Intervallen einzelne Register ab, etwa die aktuelle Leistung oder den Ladestrom. Du brauchst dafür die IP-Adresse des Geräts (bei Modbus TCP) oder den seriellen Port (bei Modbus RTU über RS485), die Unit-ID und meist ein passendes Geräte-Template, das evcc bereits mitliefert.

MQTT funktioniert umgekehrt. Geräte wie Shelly 3EM oder ein Tasmota-Stromzähler publizieren ihre Messwerte auf einen MQTT-Broker, und evcc abonniert die passenden Topics. Das ist robust, wenn viele kleine Sensoren im Spiel sind, setzt aber einen laufenden Broker voraus, zum Beispiel Mosquitto. evcc selbst kann zusätzlich seinen eigenen Status per MQTT veröffentlichen, damit andere Systeme wie Home Assistant mitlesen.

Schritt für Schritt: Geräte einbinden

1. Adresse klären: Notiere IP-Adresse und Modbus-Port deines Zählers oder Wechselrichters (häufig 502 bei TCP). Bei seriellen Geräten den USB-Adapter und die Baudrate.
2. Template wählen: Suche in der evcc-Konfiguration nach einem fertigen Template für dein Gerät. Damit musst du die Register nicht selbst eintragen.
3. Werte eintragen: Trage IP, Port und Unit-ID ein. Bei MQTT trägst du stattdessen Broker-Adresse und die Topics ein, auf denen die Werte ankommen.
4. Rolle zuweisen: Lege fest, ob das Gerät als Netzzähler (grid), PV-Erzeuger (pv), Speicher (battery) oder Wallbox (charger) dient.
5. Neu starten und prüfen: Starte evcc neu und sieh im Web-Interface nach, ob Leistungswerte erscheinen. Negative Netzleistung bedeutet Einspeisung, positive bedeutet Bezug.
6. Vorzeichen kontrollieren: Stimmt das Vorzeichen nicht, dreht sich später die Überschuss-Logik um. Dann musst du die Messrichtung korrigieren.

Häufige Verbindungsfehler und ihre Ursache

Die meisten Probleme sind keine evcc-Bugs, sondern Konfigurationsdetails. Ein Modbus-Gerät antwortet nicht, weil die IP statisch sein muss, der Router sie aber per DHCP geändert hat. Vergib darum feste IP-Adressen für alle Messgeräte. Ein zweiter Klassiker ist die falsche Unit-ID: manche Geräte hören auf 1, andere auf 3 oder eine herstellerspezifische Nummer.

Bei MQTT scheitert es meist am Broker. Läuft Mosquitto nicht oder fragt er nach Benutzername und Passwort, kommen keine Werte an. Tippfehler im Topic sind ebenfalls häufig, denn MQTT ist groß- und kleinschreibungssensitiv. Prüfe mit einem Tool wie MQTT Explorer, ob die erwarteten Werte überhaupt auf dem Broker landen, bevor du in evcc den Fehler suchst.

Ein weiterer Stolperstein ist die Zuordnung der Rolle. evcc muss wissen, ob ein Wert die Netzleistung, die PV-Erzeugung, den Speicher oder die Wallbox beschreibt. Verwechselst du hier zwei Geräte, rechnet evcc mit den falschen Zahlen, obwohl die Verbindung technisch steht. Das fällt oft erst auf, wenn die Überschuss-Regelung seltsam reagiert. Kontrolliere darum nach jeder Änderung, dass jedes Gerät genau einer Rolle zugeordnet ist und die angezeigten Werte plausibel zur Tageszeit passen.

Werte überprüfen und Fehler eingrenzen

Bevor du in evcc lange suchst, prüfe die Messwerte außerhalb der Software. Bei Modbus hilft ein kleines Abfrage-Tool, das einzelne Register direkt vom Gerät liest. Antwortet das Gerät dort nicht, liegt der Fehler im Netzwerk oder in der Geräte-Konfiguration, nicht in evcc. Bei MQTT zeigt dir ein Programm wie MQTT Explorer in Echtzeit, welche Topics gefüllt sind. So trennst du sauber, ob die Daten überhaupt ankommen oder erst in evcc verloren gehen.

Achte außerdem auf das Abfrageintervall. Pollst du ein Gerät zu häufig, kann es überlastet werden und sporadisch keine Antwort liefern, was wie ein Verbindungsabbruch aussieht. Ein Intervall von wenigen Sekunden reicht für die Überschuss-Regelung völlig aus. Behalte diese Punkte im Blick:

• Feste IP-Adressen für alle Modbus-Geräte vergeben, damit DHCP sie nicht verschiebt.
• Unit-ID aus dem Datenblatt übernehmen, nicht raten.
• MQTT-Topics exakt schreiben, denn sie sind groß- und kleinschreibungssensitiv.
• Broker-Login hinterlegen, falls Mosquitto Benutzername und Passwort verlangt.
• Vorzeichen der Netzleistung gleich nach dem ersten Start kontrollieren.

Unsere Empfehlung

Nimm Modbus für Wechselrichter und Smart-Meter, wenn ein fertiges Template existiert, und MQTT für kleine Sensoren wie Shelly. Vergib feste IP-Adressen, kontrolliere früh das Vorzeichen der Netzleistung und teste MQTT-Topics außerhalb von evcc, bevor du dort suchst. Wenn die Messwerte sauber stimmen, läuft die Überschuss-Steuerung danach fast von allein. Den Aufwand investierst du einmal, danach regelt evcc das Laden zuverlässig im Hintergrund.

Häufige Fragen

Brauche ich für evcc zwingend einen MQTT-Broker?

Nein. Einen MQTT-Broker brauchst du nur, wenn du Geräte einbinden willst, die ihre Werte per MQTT senden, etwa Shelly oder Tasmota. Bindest du Wechselrichter und Zähler ausschließlich über Modbus ein, kommt evcc komplett ohne Broker aus. Optional kann evcc seinen eigenen Status trotzdem per MQTT veröffentlichen, das ist aber unabhängig vom Einlesen der Messwerte.

Warum zeigt evcc bei Einspeisung eine positive Netzleistung?

Das Vorzeichen ist vertauscht. evcc erwartet bei Netzbezug einen positiven und bei Einspeisung einen negativen Wert. Zeigt dein Zähler es umgekehrt, ist die Messrichtung am Stromwandler oder im Geräte-Template falsch herum eingestellt. Du korrigierst das in der Konfiguration des Zählers. Stimmt das Vorzeichen nicht, funktioniert später die gesamte Überschuss-Logik verkehrt.

Welcher Modbus-Port ist der richtige?

Bei Modbus TCP ist Port 502 der Standard, viele Wechselrichter und Smart-Meter nutzen ihn. Einige Hersteller weichen jedoch ab oder verlangen, dass du Modbus im Gerät erst aktivierst. Schau ins Datenblatt deines Geräts. Bei Modbus RTU gibt es keinen IP-Port, hier zählen der serielle Port des USB-Adapters und die korrekte Baudrate.

Kann ich Modbus und MQTT gleichzeitig nutzen?

Ja. evcc kann ein Gerät per Modbus abfragen und gleichzeitig andere Geräte per MQTT einlesen. Das ist sogar üblich, wenn der Wechselrichter über Modbus läuft, ein zusätzlicher Shelly aber per MQTT meldet. Wichtig ist nur, dass jede Messgröße eindeutig einer Rolle zugeordnet ist und du nicht denselben Wert versehentlich doppelt einliest.

Mehr zur Grundinstallation findest du in der evcc-Installationsanleitung, weitere Artikel rund ums Thema unter Überschussladen.