Comment configurer NetRelay avec Home Assistant
NetRelay peut être utilisé avec Home Assistant via MQTT. Une fois la configuration terminée, vous pouvez activer et désactiver les sorties relais NetRelay, surveiller les états des entrées numériques et les utiliser dans les automatisations Home Assistant.
Ce guide est destiné aux utilisateurs qui ont peu ou pas d'expérience avec Home Assistant ou MQTT.
Important : NetRelay n'est pas ajouté directement à Apple Home ou Google Home. Connectez d’abord NetRelay à Home Assistant. L'intégration Apple Home ou Google Home peut être ajoutée ultérieurement si nécessaire.
Avant de commencer
Vous aurez besoin de :
- Une installation Home Assistant fonctionnelle
- Un appareil NetRelay
- NetRelay et Home Assistant connectés au même réseau local
- L'adresse IP de Home Assistant
- Accès à l'interface web NetRelay
Exemple:
- IP de l'assistant à domicile :
192.168.1.20 - IP NetRelay :
192.168.1.50
Vos adresses IP peuvent être différentes. Ces adresses ne sont que des exemples.
1. Installez le courtier Mosquitto MQTT
La communication entre NetRelay et Home Assistant est gérée via MQTT.
Vous pouvez considérer MQTT comme le canal de communication qui permet à NetRelay et Home Assistant d'échanger des messages.
Ouvrez Home Assistant et suivez ces étapes :
- Ouvrez Paramètres.
- Accédez à Modules complémentaires.
- Ouvrez la Magasin de modules complémentaires.
- Recherchez « Mosquitto ».
- Sélectionnez Courtier Mosquito.
- Cliquez sur Installer.
- Activez Démarrer au démarrage après l'installation.
- Cliquez sur Démarrer.
Le module complémentaire Mosquitto devrait maintenant montrer qu'il est en cours d'exécution.
2. Créez un utilisateur MQTT
NetRelay a besoin d'un nom d'utilisateur et d'un mot de passe pour se connecter à Home Assistant.
Dans Home Assistant :
- Accédez à Paramètres → Personnes.
- Ouvrez l'onglet Utilisateurs.
- Sélectionnez Ajouter un utilisateur.
- Entrez un nom d'utilisateur tel que « netrelay ».
- Créez un mot de passe.
- Enregistrez l'utilisateur.
Notez le nom d'utilisateur et le mot de passe car vous les saisirez ultérieurement dans l'interface Web NetRelay.
L'utilisateur MQTT n'a pas besoin de privilèges d'administrateur.
3. Ajoutez l'intégration MQTT
Home Assistant doit maintenant être configuré pour utiliser MQTT.
- Accédez à Paramètres → Appareils et services.
- Cliquez sur Ajouter une intégration.
- Recherchez « MQTT ».
- Sélectionnez l'intégration MQTT.
Home Assistant détectera généralement automatiquement le Mosquitto Broker.
Si un nom d'utilisateur et un mot de passe sont demandés, saisissez les informations d'identification utilisateur MQTT que vous avez créées précédemment.
Exemple:
- Nom d'utilisateur :
netrelay - Mot de passe : votre mot de passe MQTT
Si Home Assistant ne détecte pas automatiquement le courtier, utilisez l'adresse IP de Home Assistant comme adresse du courtier.
Exemple:
- Courtier :
192.168.1.20 - Port : '1883'
4. Trouvez l'adresse IP de Home Assistant
Vous devez saisir l'adresse IP de Home Assistant dans NetRelay.
Par exemple, si vous ouvrez Home Assistant en utilisant :
http://192.168.1.20:8123
alors l'adresse IP de Home Assistant est :
192.168.1.20
Soyez prudent avec le numéro de port :
- « 8123 » est le port de l'interface Web de Home Assistant.
- N'entrez pas « 8123 » comme port MQTT sur NetRelay.
- Le port MQTT doit être « 1883 ».
5. Ouvrez l'interface Web de NetRelay
Configurez maintenant le côté NetRelay.
Entrez l'adresse IP NetRelay dans votre navigateur Web.
Exemple:
http://192.168.1.50
Connectez-vous à l'interface Web NetRelay.
6. Donnez à votre NetRelay un nom d'appareil
Cette étape est facultative mais recommandée, surtout si vous disposez de plusieurs appareils NetRelay.
Ouvrez la section Paramètres de NetRelay.
Exemples de paramètres :
- Nom d'hôte :
Living-Room-Relay - ID de l'appareil :
1000
Si vous disposez de plusieurs appareils NetRelay, chaque appareil doit avoir un ID d'appareil différent.
Vous pouvez également donner des noms significatifs aux entrées et sorties.
Par exemple:
- Sortie 1 : « Lumière du salon »
- Sortie 2 : « Lumière de jardin »
- Entrée 1 : « Capteur de porte »
Enregistrez les paramètres.
7. Configurer les paramètres NetRelay MQTT
Ouvrez la section MQTT Client de l'interface Web NetRelay.
Configurez les paramètres comme suit :
- Serveur MQTT : Adresse IP de Home Assistant
- Port MQTT :
1883 - Utilisateur MQTT : Nom d'utilisateur MQTT créé dans Home Assistant
- Mot de passe MQTT : Mot de passe utilisateur MQTT
- MQTT TLS : Désactivé
- Mode client MQTT : activé
- Assistant à domicile : activé
Exemple:
Serveur MQTT : 192.168.1.20
Port MQTT : 1883
Utilisateur MQTT : netrelay
Mot de passe MQTT : ********
MQTT TLS : désactivé
Mode client MQTT : activé
Assistant à domicile : activé
Ne modifiez pas les champs Sujet ou Sous-thème lors de la configuration initiale.
Enregistrez les paramètres. NetRelay peut redémarrer.
Après le redémarrage, ouvrez la page MQTT.
Vous devriez voir :
MQTT UP
en vert.
Si MQTT UP s'affiche, NetRelay s'est connecté avec succès au courtier Home Assistant MQTT.
8. Trouvez NetRelay dans Home Assistant
Retournez à Home Assistant.
- Ouvrez Paramètres → Appareils et services.
- Sélectionnez l'intégration MQTT.
- Ouvrez la liste des appareils.
Votre NetRelay devrait apparaître en utilisant le nom d'hôte que vous avez configuré.
Par exemple:
Salon-Relais
Le périphérique NetRelay doit normalement contenir :
- 4 commutateurs : sorties relais NetRelay
- 4 capteurs binaires : Entrées numériques NetRelay
9. Testez les relais
Ouvrez l'appareil NetRelay dans Home Assistant.
Allumez le premier interrupteur relais.
Le relais correspondant sur NetRelay devrait s'activer et vous entendrez peut-être un clic provenant du relais.
Déclenchez ensuite l'une des entrées numériques.
L’état du capteur binaire correspondant dans Home Assistant devrait changer.
Si les deux tests fonctionnent, la configuration est terminée.
Micrologiciel NetRelay compatible avec Home Assistant
Vous pouvez télécharger le firmware NetRelay compatible Home Assistant à partir du lien ci-dessous :
Télécharger le micrologiciel NetRelay v3.3.5 HA
Que dois-je faire si MQTT UP n'apparaît pas ?
Si NetRelay affiche MQTT DOWN, vérifiez les éléments suivants dans l'ordre :
- Le serveur MQTT est-il défini sur la bonne adresse IP de Home Assistant ?
- Le port MQTT est-il défini sur « 1883 » ?
- Le nom d'utilisateur et le mot de passe MQTT sont-ils corrects ?
- Mosquitto Broker fonctionne-t-il dans Home Assistant ?
- NetRelay et Home Assistant sont-ils sur le même réseau ?
- Le Mode client MQTT est-il activé sur NetRelay ?
MQTT est UP mais NetRelay n'apparaît pas dans Home Assistant
Si MQTT est connecté mais que l'appareil n'apparaît pas :
- Assurez-vous que l'option Home Assistant est activée sur NetRelay.
- Vérifiez que l'intégration MQTT est installée dans Home Assistant.
- Actualisez la page Home Assistant.
- Redémarrez NetRelay.
Puis-je utiliser Apple Home ou Google Home ?
Oui, mais NetRelay n'est pas connecté directement à Apple Home ou Google Home.
Le flux de connexion correct est :
NetRelay → Assistant domestique → Apple Home / Google Home
Pour Apple Home, vous pouvez utiliser l'intégration HomeKit Bridge dans Home Assistant.
Pour le support Apple Home et Google Home, une solution Matter Hub appropriée peut également être utilisée.
Cette étape est facultative. Apple Home ou Google Home n'est pas requis pour utiliser NetRelay avec Home Assistant.
Résumé de la configuration rapide
Voici la configuration complète en quelques étapes simples :
- Connectez NetRelay et Home Assistant au même réseau.
- Installez Mosquitto Broker dans Home Assistant.
- Créez un utilisateur MQTT.
- Ajoutez l'intégration MQTT à Home Assistant.
- Notez l'adresse IP de Home Assistant.
- Ouvrez l'interface Web NetRelay.
- Entrez l'adresse IP de Home Assistant comme serveur MQTT.
- Définissez le port MQTT sur « 1883 ».
- Saisissez le nom d'utilisateur et le mot de passe MQTT.
- Activez le Mode client MQTT.
- Activez Home Assistant.
- Enregistrez les paramètres et recherchez MQTT UP.
- Recherchez NetRelay sous les appareils MQTT dans Home Assistant.
- Testez les sorties relais et les entrées numériques.
Une fois la configuration terminée, vous pouvez contrôler les sorties relais NetRelay depuis Home Assistant, surveiller les entrées numériques et utiliser les entrées et les sorties dans vos scénarios d'automatisation Home Assistant.