fr:reference:mqtt

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

fr:reference:mqtt [2018/07/17 17:45] – créée kniwwelinofr:reference:mqtt [2018/07/18 11:33] (Version actuelle) – kniwwelino
Ligne 1: Ligne 1:
 +====== Messages / MQTT ======
 +
 +===== API =====
 +
 +==== void MQTTsetGroup(String group) ====
 +Changer le groupe MQTT dans lequel tous les messages sont envoyés et les inscriptions sont faites.
 +
 +Peut être utilisé pour séparer facilement les applications/utilisateurs/groupes
 +
 +par exemple spécifiez un groupe pour un jeu ou un groupe pour les cartes jouant au même jeu.
 +
 +==== void MQTTonMessage(void (cb)(String &topic, String &message)) ====
 +Modifie la fonction d'appel qui appelle un message MQTT est reçut pour un des sujets inscrits.
 +Sets the callback function that is called one a MQTT message is received for one of the subscribed topics.
 +
 +nécessite une fonction d'appel avec la signature suivante :
 +
 +''topic - chaîne de caractères définissant le topic sur lequel le message va être envoyé / reçu\\
 +message - chaîne de caractère contenant le message envoyé/reçu.''
 +
 +
 +==== boolean MQTTpublish(const char topic[], String message) ====
 +Envoi un message sur un topic MQTT spécifique.
 +
 +si un groupe MQTT est indiqué, le topic est automatiquement précédé par le nom du groupe.
 +
 +''topic - sujet sur lequel le message sera envoyé\\
 +message - contenu du message.''
 +
 +     
 +==== boolean MQTTpublish(String topic, String message) ====
 +Envoi a message sur le topic MQTT spécifié.
 +
 +si un groupe MQTT est indiqué, le topic est automatiquement précédé par le nom du groupe.
 +
 +''topic - sujet sur lequel le message sera envoyé\\
 +message - content of the message.''
 +
 +
 +==== boolean MQTTsubscribe(const char topic[]) ====
 +S'inscrit au topic MQTT spécifié. Une fois qu'un message est reçu pour un topic spécifié, la fonction MQTTonMessage est appelée.
 +
 +Si un groupe MQTT est indiqué, le topic est automatiquement précédé par le nom du groupe.
 +voir https://www.hivemq.com/blog/mqtt-essentials-part-5-mqtt-topics-best-practices pour plus d'informations concernant les inscriptions à un topic.
 +
 +''topic - sujet auquel on s'inscrit''
 +
 +==== boolean MQTTsubscribe( String s_topic) ====
 +Souscrit à un topic spécifique. Quand un message est reçu sur un topic auquel on s'inscrit, la fonction MQTTonMessage est appelée.
 +
 +si un groupe MQTT est indiqué, le topic est automatiquement précédé par le nom du groupe.
 +voir https://www.hivemq.com/blog/mqtt-essentials-part-5-mqtt-topics-best-practices pour plus d'informations sur les inscriptions aux topics.
 +
 +''topic - sujet auquel on s'inscrit''
 +
 +==== boolean MQTTunsubscribe(const char topic[]) ====
 +Désincrit d'un topic MQTT spécifié.
 +
 +si un groupe MQTT est indiqué, le topic est automatiquement précédé par le nom du groupe.
 +
 +''topic - sujet duquel on se désinscrit''
 +
 +==== void MQTTconnectRGB() ====
 +Inscrit la LED RVB de la carte Kniwwelino à un topic MQTT spécific. Si un message est reçu, la couleur de la LED est modifiée.
 +
 +si un groupe MQTT est indiqué, le topic est automatiquement précédé par le nom du groupe.
 +
 +La carte écoutera les messages envoyés sur le topic //group/RGB/COLOR// .
 +
 +**Format du message :** 
 +
 +''"FF00FF", les deux premiers chiffres spécifient le ROUGE, les 2 chiffres suivants spécifient le VERT, les 2 derniers chiffres spécifient la composante BLEU.''
 +
 +
 +
 +==== void MQTTconnectMATRIX() ====
 +Inscrit la matrice à un topic MQTT spécifique.
 +
 +si un groupe MQTT est indiqué, le topic est automatiquement précédé par le nom du groupe.
 +
 +La carte écoutera les messages envoyés sur le groupe //group/MATRIX/ICON// pour les icônes. Si une icône est reçue, alors elle sera affichée.
 +
 +**Format des messages :**
 +
 +''"B1111100000111110000011111" 25 pixels binaires l'un après l'autre avec le préfixe B ou \\
 +"0x7008E828A0" un byte de 5 pixel pour chacune des lignes, préfixe 0x''
 +
 +La carte écoutera les messages envoyés sur le groupe //group/MATRIX/TEXT// pour le texte. Si un message texte est reçu, le texte sera affiché
 +
 +**Format du message:** 
 +
 +''"Hello World!"''
 +
 +
 +
 +===== Wiring =====
 +
 +===== Examples =====
 +