Bevor Sie beginnen
- Eine funktionierende Ampernova-Anlage mit zugewiesenen, erreichbaren Thermostaten.
- Home Assistant und ein vom HeatingMain erreichbarer Broker.
- Zugriff auf den Controller im Ampernova-Portal. Er muss online sein, um die Broker-Einstellungen zu empfangen.
Nach der Einrichtung arbeitet MQTT lokal. Die Matter-Kopplung und das Fabric-Menü des Thermostats sind davon unabhängig.
MQTT einrichten
- In Home Assistant Einstellungen → Geräte & Dienste → Integration hinzufügen → MQTT öffnen. Unter Home Assistant OS der angebotenen Mosquitto-Einrichtung folgen. Einen bereits installierten Broker weiterverwenden.
- Einen eigenen Broker-Zugang für Ampernova erstellen. Für die offizielle Mosquitto-App unter Einstellungen → Personen → Benutzer einen Home-Assistant-Benutzer anlegen; falls der Reiter fehlt, im Profil den erweiterten Modus aktivieren. Ein einzigartiges Passwort wählen und Administratorrechte ausgeschaltet lassen.
- Bei Home Assistant Container oder einem externen Broker Mosquitto separat installieren und dessen Adresse und Zugangsdaten in der MQTT-Integration eingeben.
- Die MQTT-Erkennung mit dem Präfix
homeassistantaktiviert lassen.
Offizielle MQTT-Anleitung von Home Assistant · Mosquitto-Einrichtung und Benutzer
Ampernova verbinden
Im Ampernova-Portal den HeatingMain-Controller und anschließend Settings → MQTT broker öffnen. Alle vier Felder ausfüllen:
| Feld | Eingabe |
|---|---|
host | Die LAN-Adresse des Brokers, zum Beispiel 192.168.1.20. Für die Mosquitto-App die LAN-Adresse des Home-Assistant-Rechners verwenden. Hier kein Protokoll, keinen Pfad und keinen Port eintragen. |
port | 1883 für den lokalen MQTT-TCP-Zugang. |
user | Der eigens angelegte Broker-Benutzername. |
password | Das Broker-Passwort dieses Benutzers. Bei jeder Übernahme erneut eingeben; ein leeres Feld sendet ein leeres Passwort. |
apply broker wählen. Der Controller speichert die Einstellungen und verbindet sich automatisch neu; ein manueller Neustart ist nicht nötig. Für jeden gewünschten HeatingMain-Controller wiederholen.
„settings sent“ bestätigt den Versand. Die Verbindung anhand aktueller Messwerte in Home Assistant prüfen. Das Passwort wird nie angezeigt oder vorausgefüllt.
Ein vertrauenswürdiges lokales Netzwerk verwenden: Diese Einstellung nutzt unverschlüsseltes MQTT über TCP, kein TLS oder WebSockets. Den Broker-Port nur im LAN zugänglich machen.
Räume finden
- In Home Assistant Einstellungen → Geräte & Dienste → MQTT und dann die Geräteliste öffnen.
- Den Controller anhand seiner Geräte-ID suchen. Thermostat-Entitäten sind unter dem Controller gruppiert und tragen Kreislaufbezeichnungen wie Thermostat A1 oder Thermostat B4.
- Eine Thermostat-Entität öffnen und Raumtemperatur und Sollwerte mit dem realen Thermostat vergleichen. Die Entität nach dem Raum benennen und bei Bedarf einem Bereich zuordnen.
- Die Thermostat-Entität einem Dashboard hinzufügen. Einen Sollwert ändern und prüfen, ob er am Thermostat ankommt; eine Busrunde von etwa einer Minute abwarten.
Keine eigene Ampernova-Integration und keine manuelle Discovery-YAML sind nötig. Die verfügbaren Entitäten hängen von Kreisläufen und Firmware ab; ein Raum mit Boden- und Deckenzuweisung kann unter beiden Adressen erscheinen.
Die Temperaturziele gelten pro Raum. Heizen oder Kühlen wird für die gesamte Anlage gewählt; dafür die globale Modussteuerung im Ampernova-Portal verwenden.
Fehlerbehebung
Der Controller erscheint nicht
Broker-Adresse, Zugangsdaten und LAN-Erreichbarkeit vom Controller prüfen. Die LAN-IP des Broker-Rechners verwenden, nicht localhost oder core-mosquitto. Im Mosquitto-Protokoll nach Verbindungs- oder Anmeldefehlern suchen und alle vier Felder erneut übernehmen.
MQTT ist verbunden, aber Räume fehlen
Prüfen, ob die Thermostate online und zugewiesen sind. In den MQTT-Optionen von Home Assistant muss die Erkennung mit Präfix homeassistant aktiviert sein. Sobald die Räume online sind, die Broker-Einstellungen erneut übernehmen, um die Erkennung neu zu senden.
Entitäten erscheinen, sind aber nicht verfügbar
Der Broker speichert Erkennungsbeschreibungen auch nach Verbindungsende. Die aktuelle Verbindung von Controller und Thermostaten prüfen und neue Messwerte abwarten. Ein gespeicherter Geräteeintrag beweist allein keine aktive Verbindung.
Was bewirkt „use default broker“?
Die Portal-Einstellung wird entfernt und der bei der Bereitstellung konfigurierte Broker wiederhergestellt. Ohne Standardbroker wird lokales MQTT beendet. Für einen eigenen Broker dessen Daten eingeben und apply broker wählen.