Piloter Domoticz via l'API JSON, configurer le connecteur Homy MQTT • Domotique et objets connectés à faire soi-même

1Vus

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.

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

Donnez un nom à votre instance le continuez

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

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

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

La nouvelle instance est ajoutée à la liste.

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.

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

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

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

Configurer le connecteur MQTT pour Homy

Ouvrez la page de configuration

Ouvrez la liste de connecteurs

Cliquez sur le Plus.

Choisissez MQTT dans la liste des connecteurs.

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.

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

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

Avez-vous aimé cet article ?