User manual

Jour 22 : MQTT-Cheerlights
L’expérience d’aujourd’hui s’articule autour du MQTT et d’un projet présenté l’an dernier : le
projet Cheerlights de Hans Schaaler. Il s’agit de lumières multicolores raccordées dans le monde
entier, qui peuvent être commandées via Twitter.
La porte d’aujourd’hui dissimule une résistance de 1 kOhm. Le montage se compose d’une LED
RVB avec prérésistances et d’un bouton-poussoir.
Téléchargez le programme du jour. Avant de transférer le programme sur la NanoESP, installez
la bibliothèque Crossfade de Radek Wierzbiecki (sur
https://github.com/radekw/Arduino/tree/5f24ce7c8db9dfbb5252b59824c3217d851b3a3c). Pour
simplifier l’installation, une copie de la version de bibliothèque utilisée est disponible dans le
dossier Sketch sous forme de fichier ZIP. Elle peut être insérée dans l’IDE Arduino via le
gestionnaire de bibliothèque : pour cela, sélectionnez le répertoire ZIP dans le dossier Sketch
sous Sketch > Intégrer bibliothèque > Intégrer bibliothèque.ZIP. Le programme est alors
compilé et peut être téléchargé sur la NanoESP.
Une fois que le programme est chargé, retournez sur la page www.hivemq.com/try-out/ et
établissez une connexion avec le Broker broker.fkainka.de. Le topic
NanoESP/MyMQTTiD/rgb/mode
permet de changer le mode (Cheerlights ou couleur personnalisée), en publiant 1 ou 0. Pour tous
les messages, il est important de cocher la case « Retain » avant d’envoyer le message à l’aide du
bouton « Publish ». « Retain » signifie que le broker enregistre le message. A partir de
maintenant, dès qu’un appareil s’abonne au topic, le message enregistré est immédiatement
envoyé à l’appareil. Le bouton-poussoir sur la platine permet également de changer le mode via
un message avec Retain-Flag. Il n’est donc pas indispensable de retourner sur la page Try-Out
pour changer de mode.
En mode personnel (mode 0), il est possible d’associer une couleur à la LED RVB en publiant
dans le topic
NanoESP/MyMQTTiD/rgb/color
un message de la forme
rgb(X,X,X)
Le X représente une valeur PWM comprise entre 0 et 255. L’ordre des couleurs est rouge, vert,
bleu. Pour une couleur verte avec une luminosité maximale, vous devez donc publier
rgb(0,255,0)
N’oubliez pas de cocher la case Retain.
En mode Cheerlights (mode 1), la carte est abonnée à un topic qui publie la couleur Cheerlights
du moment. Pour modifier cette couleur, rédigez un message Twitter qui permettra de modifier la
couleur de votre LED et de celle de tous les autres utilisateurs Cheerlights. Le message doit
contenir #Cheerlights, @Cheerlights ou simplement le mot Cheerlights, suivi d’une des couleurs
prédéfinies :
red, green, blue, cyan, white, warmwhite, purple, magenta, yellow, orange, pink
par exemple : Testing my #cheerlights #MQTT project on my #NanoESP with the color blue