Piloter Domoticz via l’API JSON, configurer le connecteur Homy MQTT

L’API JSON de Domoticz peut être pilotée très simplement à l’aide de messages MQTT. En connectant votre serveur Domoticz à un broker en ligne tel que cloudMQTT, vous pourrez très facilement piloter vos accessoires domotiques et recevoir des changements d’état ou de mesure quasi instantanément même lorsque vous n’êtes pas chez vous*.

(*) A condition de disposer d’une connexion internet 3G / 4G ou d’être connecté à un réseau WiFi évidemment.

Créer un broker MQTT gratuit sur cloudMQTT

cloudMQTT est un broker (serveur) MQTT en ligne qui propose une offre gratuite. L’offre gratuite est limitée à 5 connexions simultanées mais c’est largement suffisant pour un usage personnel. Vous trouverez d’autres brokers en ligne gratuit ici.

Si vous disposez d’une flotte importante de capteurs et actionneurs qui utilisent MQTT, je vous conseille de concentrer tous vos objets sur un serveur local Mosquitto par exemple et d’utiliser Node-RED pour connecter votre broker local à cloudMQTT.

Créez un compte gratuit sur cloudMQTT. Vous aurez juste besoin d’un email. Une fois connecté, cliquez sur Create New Instance.

1 cloudmqtt create instance

Donnez un nom à votre instance le continuez

cloudmqtt instance domoticz mqtt

Sélectionnez le plan Cute Cate qui est gratuit (mais limité à 5 connexions simultanées). Continuez en cliquant sur Select Region.

 cloudmqtt plan prix

cloudMQTT utilise les serveurs d’Amazon AWS pour fonctionner. Vous pouvez choisir le serveur sur lequel vos données vont transiter. Ici, elles vont passer par l’Ireland. Ne vous inquiétez pas, le choix à peu d’impact sur la performance de votre connexion. Amazon AWS est un leader du cloud…

Terminez avec Review

cloudmqtt localisation serveur aws

Finalisez la création de l’instance à la page suivante en cliquant sur Create Instance

cloudmqtt create instance domoticz homy

La nouvelle instance est ajoutée à la liste.

cloudmqtt instance domoticz created

Cliquez sur le nom de l’instance pour ouvrir les paramètres de connexion :

  • Server : le nom de domaine de connexion
  • User et password
  • Plusieurs ports sont disponibles.

cloudmqtt mqtt instance info connexion

Configurer la connexion MQTT sur Domoticz

Ouvrez la liste des matériels et ajoutez un matériel de type MQTT Client Gateway with Lan Interface. Saisissez les paramètres de cloudMQTT

  • adresse distance : celle indiquée dans l’instance
  • port : ici le 16338 mais il peut être différent pour vous
  • identifiant et mot de passe
  • topic : choisis

Terminez par Ajouter

cloudmtt domoticz mqtt connexion configuration

Remarque. Le plugin MQTT pour Domoticz ne supporte pas (pour le moment j’espère) l’échange des messages MQTT via une connexion sécurisée et cryptée. Il faut donc obligatoirement vous connecter sur le port standard. La connexion via le port SSL conduira à un échec de connexion.

Vérifier que Domoticz est correctement connecté à cloudMQTT

Pour savoir si Domoticz s’est correctement connecté à cloudMQTT, il suffit d’ouvrir le journal (log). Si tel n’était pas le cas, changez le port

domoticz check cloudmqtt mqtt connexion ok

Tout est prêt, vous pouvez retourner sur Homy pour configurer le connecteur.

Configurer le connecteur MQTT pour Homy

Ouvrez la page de configuration

homy settings

Ouvrez la liste de connecteurs

Cliquez sur le Plus.

Choisissez MQTT dans la liste des connecteurs.

homy connector broker mqtt cloudmqtt mosquitto

Configurer le connecteur MQTT avec les paramètres de connexion d’une instance cloudMQTT

Renseignez les paramètres suivants :

  • Nommez le connecteur. Facultatif
  • Cochez Actif pour activer le connecteur. En décochant cette option, vous pouvez suspendre la communication avec le broker temporairement
  • IP externe ou nom de domaine. Indiquez le nom du serveur (server) cloudMQTT
  • Port. Saisissez le port Websockets Port (TLS only) de l’instance cloudMQTT. Ici 36338. Le port est attribué aléatoirement au moment de la création de l’instance.
  • Protocole : choisir WSS (sécurisé) pour cloudMQTT
  • Saisissez enfin l’utilisateur et le mot de passe de votre instance
  • Testez la connexion. Cliquez sur “Tester la connexion”. Si Homy a pu se connecter et s’authentifier auprès de l’instance cloudMQTT, la croix sera verte. Un point d’exclamation sera affiché si ce n’est pas le cas**

** Attention, le test de connexion n’est pas fiable à 100%. Recommencez à plusieurs reprises en attendant quelques secondes entre chaque essai si le retour est négatif et que vos paramètres semblent corrects.

homy mqtt connector cloudmqtt mosquitto

Autres options (facultatives)

Vous pouvez laisser Homy ajouter automatiquement tous les nouveaux appareils domotiques découverts sur le serveur en cochant l’option de synchronisation

homy ajout automatique nouveau accessoires domoticz mqtt

Contrairement à l’interface HTTP, il n’existe aucune fonction pour récupérer avec une seule commande l’état (et la configuration) de tous les accessoires disponibles. Pour contourner ce problème Homy scanne les accessoires jusqu’à la limite fixée par le champ auto exploration. C’est une solution temporaire faute de mieux. Si vous constatez qu’il manque des accessoires, pensez à ajuster le seuil d’auto-exploration en indiquant le plus grand IDX de la table des dispositifs.

Si vous disposez de plusieurs appareils (smartphone, tablette…) sur lequel vous avez installé Homy, vous pouvez synchroniser les réglages d’Homy entre vos appareils. Toutes vos données sont synchronisées via le broker MQTT. Aucune information ne transite par un serveur tiers. Vous garder la main sur 100% de vos données personnelles !

Attention, la synchronisation des réglages est encore expérimentale

Limitations du connecteur MQTT pour Domoticz

L’API JSON via les messages MQTT offrent moins de fonctionnalités que l’API HTTP. Les spécifications techniques sont disponibles sur le Wiki officiel ici.

En plus des limitations de l’API, il n’est pas possible de réaliser les opérations suivantes en se connectant à Domoticz via un broker MQTT :

  • La récupération de l’historique n’est pas possible

Autres tutoriels sur le même thème

 

Tous les tutoriels Homy

Inscrivez-vous à la newsletter hebdomadaire

Aucun spam et aucun autre usage ne sera fait de votre email. Vous pouvez vous désinscrire à tout moment.

Promos à ne pas louper

Poster un Commentaire

Laisser un commentaire

Ce site utilise Akismet pour réduire les indésirables. En savoir plus sur comment les données de vos commentaires sont utilisées.

  S’abonner  
Notifier de
Domotique et objets connectés à faire soi-même