====== 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 =====