MQTT Publish (TLS-Beta)

Ce bloc fonctionnel envoie des données à un broker MQTT avec une option de sécurité TLS. Il fournit des réglages pour Broker Address, l'authentification, TLS Mode Selection, QoS, le drapeau Retain et Keep alive—vous permettant de publier des messages formatés depuis votre système vers n'importe quel Topic MQTT.

📥 Entrées (sockets)

Enable Bascule pour activer la publication. Lorsque cette entrée est TRUE, le bloc tentera d'envoyer les données fournies.

Data Les données à publier. Cette socket générique accepte du texte ou des données structurées (il est recommandé de formater en JSON ou en string).

📤 Sorties (sockets)

Ce bloc fonctionnel ne produit aucune sortie.

🕹️ Contrôles

Broker Address Saisissez l'hôte ou l'adresse IP du broker MQTT.

Port Saisissez le port du broker. Le port par défaut courant est 1883.

Topic Le Topic MQTT sur lequel publier les messages.

Username Nom d'utilisateur optionnel pour l'authentification auprès du broker.

Password Mot de passe optionnel pour l'authentification (masqué dans l'UI).

TLS Mode Selection Choisissez le comportement TLS. Options : None, Auto (utilise le certificat système/racine), ou des versions TLS spécifiques avec un fichier de certificat personnalisé.

Cert File Path Chemin optionnel vers un fichier .crt lorsque vous utilisez une configuration TLS personnalisée.

Quality of Service Choisissez le niveau de livraison du message (0, 1 ou 2).

Keep alive (s) Réglez l'intervalle de keepalive en secondes.

Retain Activez pour publier des messages conservés (retained) sur le broker.

🎯 Principales fonctionnalités

• Publication sécurisée avec options TLS sélectionnables, incluant la gestion automatique des certificats ou un fichier de certificat personnalisé.

• Prise en charge de l'authentification via Username/Password.

• QoS et drapeau Retain pour garantir la livraison et la persistance des messages.

• Tentatives de reconnexion automatiques en cas de perte de connexion et journalisation simple pour diagnostiquer les problèmes.

• Contrôles UI simples pour tous les paramètres MQTT courants — aucune programmation requise.

📝 Comment utiliser

1. Remplissez Broker Address et Port pour pointer vers votre broker MQTT.

2. Définissez Topic pour les messages cibles.

3. Si nécessaire, fournissez Username et Password. Laissez-les vides pour les brokers anonymes.

4. Choisissez TLS Mode Selection. Utilisez Auto pour des connexions sécurisées standard sans fournir de fichier de certificat, ou indiquez Cert File Path si votre broker exige un .crt spécifique.

5. Configurez Quality of Service, Keep alive (s) et activez Retain si vous souhaitez que les messages soient conservés sur le broker.

6. Alimentez la donnée à envoyer dans l'entrée Data. Utilisez Enable pour déclencher l'envoi (TRUE pour activer).

7. Surveillez les logs affichés par le bloc pour l'état de connexion et le statut de publication.

📊 Que se passe-t-il lors de l'exécution

Lorsque le bloc est activé, il vérifie les paramètres de connexion et tente de se connecter ou de se reconnecter au broker si nécessaire. Une fois connecté, il publie les Data fournis sur le Topic configuré en utilisant le Quality of Service et les options Retain sélectionnées. Les problèmes de connexion et les résultats de publication sont signalés via le statut/les messages de journal du bloc.

💡 Astuces et conseils

• Combinez avec Data to JSON pour convertir plusieurs champs de données en un seul message JSON adapté aux tableaux de bord IoT.

• Utilisez String Merge pour construire un message texte personnalisé (par exemple fusionner device id + status).

• Ajoutez Date-Time pour inclure des horodatages dans vos messages pour la journalisation ou les graphiques chronologiques.

• Déclenchez la publication sur des événements en couplant ce bloc avec Logic Input ou Rising Edge afin que les messages ne soient envoyés que lorsqu'un événement pertinent se produit.

• Utilisez MQTT Subscribe (TLS-Beta) dans une instance séparée du même type de bloc pour vérifier que les messages sont bien reçus sur le broker (utile pour des tests end-to-end).

• Avant d'envoyer des données volumineuses en images, pensez à utiliser Image Logger ou Image Write pour enregistrer les images localement et ne publier que des métadonnées ou un chemin de fichier via MQTT afin de réduire la bande passante.

🛠️ Dépannage

• Connexion échouée : vérifiez Broker Address, Port, le pare-feu et la connectivité réseau. Essayez un client MQTT simple pour confirmer que le broker est joignable.

• Erreurs de certificat/TLS : basculez TLS Mode Selection sur Auto si vous n'avez pas de fichier de certificat, ou fournissez le bon Cert File Path lorsque TLS personnalisé est requis.

• Échec d'authentification : vérifiez Username et Password auprès de votre broker.

• Messages non visibles sur le broker : confirmez Topic, QoS et Retain ; utilisez MQTT Subscribe (TLS-Beta) pour surveiller le Topic localement.

• Format de données inattendu : prévisualisez ou journalisez votre message avant publication en utilisant Debug Input, String Merge, ou Data to JSON pour vous assurer que le format correspond aux attentes des abonnés.