Avant de commencer
- Une installation Ampernova fonctionnelle avec des thermostats affectés et en ligne.
- Home Assistant et un courtier accessible depuis le régulateur HeatingMain.
- Un accès au régulateur dans le portail Ampernova. Il doit être en ligne pour recevoir les paramètres du courtier.
Une fois configuré, MQTT fonctionne localement. L’appairage Matter et le menu Fabric du thermostat sont indépendants de cette configuration.
Configurer MQTT
- Dans Home Assistant, ouvrez Paramètres → Appareils & services → Ajouter une intégration → MQTT. Sous Home Assistant OS, suivez la configuration Mosquitto proposée. Si un courtier est déjà installé, utilisez-le.
- Créez un compte de courtier dédié à Ampernova. Avec l’application officielle Mosquitto, créez un utilisateur Home Assistant dans Paramètres → Personnes → Utilisateurs ; activez le mode avancé dans votre profil si l’onglet Utilisateurs est masqué. Choisissez un mot de passe unique et laissez les droits administrateur désactivés.
- Avec Home Assistant Container ou un courtier externe, installez Mosquitto séparément et renseignez l’adresse et les identifiants du courtier dans l’intégration MQTT.
- Gardez la découverte MQTT activée avec le préfixe
homeassistant.
Instructions MQTT officielles de Home Assistant · Configuration et utilisateurs Mosquitto
Connecter Ampernova
Dans le portail Ampernova, ouvrez votre régulateur HeatingMain, puis Settings → MQTT broker. Remplissez les quatre champs :
| Champ | Valeur à saisir |
|---|---|
host | L’adresse LAN du courtier, par exemple 192.168.1.20. Pour l’application Mosquitto, utilisez l’adresse LAN de la machine Home Assistant. Ne saisissez ni protocole, ni chemin, ni port ici. |
port | 1883 pour la connexion MQTT TCP locale. |
user | Le nom d’utilisateur dédié au courtier que vous avez créé. |
password | Le mot de passe de cet utilisateur sur le courtier. Saisissez-le à chaque application des paramètres ; un champ vide envoie un mot de passe vide. |
Sélectionnez apply broker. Le régulateur enregistre les paramètres et se reconnecte automatiquement ; aucun redémarrage manuel n’est nécessaire. Répétez pour chaque régulateur HeatingMain souhaité dans Home Assistant.
Le message « settings sent » confirme l’envoi. Vérifiez la connexion en consultant des mesures actuelles dans Home Assistant. Le mot de passe n’est jamais affiché ni prérempli.
Utilisez un réseau local de confiance : ce réglage utilise MQTT TCP sans chiffrement, sans TLS ni WebSockets. Réservez l’accès au port du courtier à votre LAN.
Retrouver vos pièces
- Dans Home Assistant, ouvrez Paramètres → Appareils & services → MQTT, puis sa liste d’appareils.
- Retrouvez votre régulateur par son identifiant. Les entités des thermostats sont regroupées sous le régulateur avec des noms de circuits tels que Thermostat A1 ou Thermostat B4.
- Ouvrez une entité de thermostat et comparez sa température ambiante et ses consignes au thermostat physique. Renommez l’entité d’après la pièce et attribuez-lui une zone si vous le souhaitez.
- Ajoutez l’entité de thermostat à un tableau de bord. Modifiez une consigne et vérifiez sa réception sur le thermostat physique ; attendez un cycle de bus, soit environ une minute.
Aucune intégration Ampernova spécifique ni configuration YAML de découverte manuelle n’est nécessaire. Les entités disponibles dépendent des circuits et du micrologiciel ; une pièce affectée au sol et au plafond peut apparaître sous les deux adresses de circuit.
Les consignes de température sont individuelles. Le choix chauffage ou refroidissement concerne toute l’installation ; utilisez la commande de mode global du portail Ampernova.
Dépannage
Le régulateur n’apparaît pas
Vérifiez l’adresse du courtier, les identifiants et l’accès LAN depuis le régulateur. Utilisez l’IP LAN de la machine du courtier, pas localhost ni core-mosquitto. Recherchez une erreur de connexion ou d’authentification dans le journal Mosquitto, puis appliquez à nouveau les quatre champs.
MQTT est connecté, mais des pièces manquent
Vérifiez que les thermostats sont en ligne et affectés. Dans les options MQTT de Home Assistant, vérifiez que la découverte est activée avec le préfixe homeassistant. Une fois les pièces en ligne, appliquez de nouveau les paramètres du courtier pour reconnecter et renvoyer la découverte.
Les entités apparaissent, mais sont indisponibles
Le courtier conserve les descriptions de découverte après la fin d’une connexion. Vérifiez la connexion actuelle du régulateur et des thermostats et attendez de nouvelles mesures. Une entrée d’appareil conservée ne prouve pas à elle seule que le système est en ligne.
Que fait « use default broker » ?
Cette commande supprime le réglage du portail et rétablit le courtier configuré lors du provisionnement. Sans courtier par défaut, MQTT local s’arrête. Pour utiliser votre courtier, saisissez ses coordonnées et sélectionnez apply broker.