MQTT

Ahoy DTU kann Messwerte, Status- und Steuerinformationen per MQTT veröffentlichen und lässt sich darüber auch fernsteuern (z. B. Leistungsbegrenzung, Neustart). Zusätzlich unterstützt Ahoy DTU Home-Assistant-Auto-Discovery, sodass alle Sensoren und Steuerelemente automatisch in Home Assistant erscheinen, ohne manuell konfiguriert werden zu müssen.

Konfiguration

Die Einstellungen findest du in der Web-Oberfläche unter dem MQTT-Konfigurationsbereich:

Einstellung	Beschreibung
Aktiviert	Schaltet die MQTT-Anbindung ein/aus
Broker	Adresse deines MQTT-Brokers (z. B. IP oder Hostname)
Port	Broker-Port, Standard 1883
Client-ID	Eindeutige ID, mit der sich das Gerät am Broker anmeldet
Benutzer / Passwort	Zugangsdaten, falls dein Broker Authentifizierung verlangt
Topic	Basis-Präfix, unter dem alle Werte veröffentlicht werden (z. B. solar)
JSON	Wenn aktiviert, werden Werte zusätzlich/alternativ als zusammengefasstes JSON statt als Einzel-Topics gesendet
Retain	Legt fest, ob veröffentlichte Nachrichten vom Broker gespeichert (retained) werden, damit neue Abonnenten sofort den letzten Wert erhalten

Nach dem Speichern verbindet sich Ahoy DTU automatisch mit dem Broker; der Verbindungsstatus wird ebenfalls per MQTT gemeldet (Last-Will/Online-Status).

Welche Topics erwarten dich?

Alle Topics beginnen mit deinem konfigurierten Basis-Topic (<topic>), gefolgt vom Namen des jeweiligen Wechselrichters, wie du ihn in der Ahoy-DTU-Konfiguration vergeben hast.

Messwerte pro Wechselrichter

<topic>/<Wechselrichtername>/<Kategorie>/<Messgröße>

Beispiele für Messgrößen: Spannung, Strom, Leistung, Tagesertrag, Gesamtertrag, Frequenz, Temperatur, Wirkungsgrad u. a. — jeweils als eigenes Topic mit dem aktuellen Wert.

Summenwerte über alle Wechselrichter

<topic>/<Gerätename>-TOTAL/<Kategorie>/<Messgröße>

Fasst z. B. die Gesamtleistung oder den Gesamtertrag aller Wechselrichter zusammen.

Geräteinformationen

Topic	Inhalt
<topic>/<Wechselrichtername>/firmware	Firmware-Version und Build-Datum als JSON
<topic>/<Wechselrichtername>/hardware	Hardware-Teilenummer, Version, Netzprofil-Code/-Version
<topic>/<Wechselrichtername>/radio_statistics	Sende-/Empfangsstatistik der Funkverbindung (Erfolge, Fehler, Wiederholungen)

Alarme

Topic	Inhalt
<topic>/<Wechselrichtername>/alarm/cnt	Anzahl der bisher aufgetretenen Alarme
<topic>/<Wechselrichtername>/alarm/0 … /9	Details zu den letzten bis zu 10 Alarmen (Code, Text, Start-/Endzeit)

Home-Assistant-Auto-Discovery

Ist MQTT aktiv, meldet Ahoy DTU automatisch passende Sensoren, Buttons und Schalter an Home Assistant (Discovery-Präfix homeassistant/...). Du musst dafür nichts weiter konfigurieren — die Geräte erscheinen automatisch, jeweils gruppiert nach Wechselrichter (inkl. Hersteller „Hoymiles“ und Link zur Ahoy-DTU-Weboberfläche als Geräte-Konfigurationsseite).

Automatisch angelegt werden je Wechselrichter:

• Sensoren für alle Messwerte (Spannung, Strom, Leistung, Erträge, Temperatur, …)
• Neustart-Button – löst über MQTT einen Neustart des Wechselrichters aus
• Ein/Aus-Schalter – schaltet den Wechselrichter über MQTT ein oder aus
• Leistungsbegrenzung – siehe nächster Abschnitt

Leistungslimit setzen

Über Home Assistant (Prozent)

Ahoy DTU legt für jeden Wechselrichter zwei Bedienelemente für die Wirkleistungsbegrenzung an:

• einen Schieberegler (Slider)
• ein Eingabefeld (Box)

Beide steuern denselben Wert und sind ausschließlich prozentual ausgelegt: Bereich 0–100 %, Schrittweite 0,1 %. Ein direktes Setzen in Watt ist über diese Home-Assistant-Elemente nicht vorgesehen — es gibt in der Discovery-Konfiguration keine Watt-Variante.

Der Sollwert wird veröffentlicht unter:

<topic>/<Wechselrichtername>/ctrl/limit

Der aktuelle Status der Begrenzung wird gespiegelt unter:

<topic>/<Wechselrichtername>/Status/ActivePowerControl

Manuell per MQTT

Du kannst denselben Befehlstopic (<topic>/<Wechselrichtername>/ctrl/limit) auch direkt und ohne Home Assistant beschreiben, z. B. mit mosquitto_pub:

mosquitto_pub -h <broker> -t "<topic>/<Wechselrichtername>/ctrl/limit" -m "80"

Weitere Steuerbefehle

Befehl	Topic	Payload
Neustart auslösen	<topic>/<Wechselrichtername>/ctrl/restart	1
Wechselrichter ein-/ausschalten	<topic>/<Wechselrichtername>/ctrl/power	on / off