Sur le même principe que le LAM, ce témoin lumineux fonctionnant en WiFi équipé d’un interrupteur tactile est pilotable par une box domotique comme l’eedomus, Jeedom, Domoticz, …, ou par un IPX.
Basé sur un ESP8266, le SLAM est équipé de 12 leds WS2812B 5050 permettant plus de 16 millions de couleurs.
Comme tous nos produits, il a été développé initialement pour un client souhaitant avoir un voyant lumineux avec un interrupteur pour déclencher des règles sur sa box domotique.
L’interrupteur est au centre, monostable, il est tactile donc pas d’usure, les leds forment une couronne autour du boitier.
Au toucher sur l’interrupteur, celui-ci s’allume pour acquitter le contact.
Nous avons décidé, compte-tenu du potentiel d’un interrupteur, de développer de 1 à 4 appuis courts et 1 appui long.

slam-switch

Les usages sont nombreux :

  • témoin bien sûr avec le choix de la couleur des leds selon la nature,
  • acquitter un état avec l’interrupteur,
  • activer un actionneur,
  • et toute votre imagination.

Doté d’API http, le SLAM permet de faire pour les leds :

  • ON/OFF, pause et reprise,
  • des animations de type roue, fondu, clignotement plus ou moins vite,
  • de répéter n fois ou sur un délai définit en secondes les animations,
  • des couleurs prédéfinies ou personnalisées,
  • de la variation de luminosité.

Pour l’interrupteur, le SLAM renvoie une valeur correspondante au nombre d’effleurements.

Facile d’installation, le SLAM est aimanté, pas de trou pour le fixer.
Sur un meuble, un réfrigérateur, un mur grâce un second aimant autocollant, il trouvera sa place facilement.

lam dessous

Encombrement réduit, il fait 56mm de diamètre par 34mm de hauteur.

Disponible en blanc ou noir, ainsi que des accessoires optionnels, comme fixation sur tube IRO, encastrement dans un pot pour Legrand Celiane, bientôt Lexman série Epure et Schneider série Odace.
La couleur de l’interrupteur pour l’acquittement n’est pas paramétrable, il faut donc choisir entre le bleu, vert, rouge ou jaune au moment de la fabrication et elle sera définitive.

slam color

Actuellement en version 1.00, le SLAM possède une fonction de mise à jour automatique qui télécharge une nouvelle version si elle existe sur nos serveurs.

Bien sûr dans le respect de votre vie privée, aucune information sur l’usage qu’il en est fait ainsi que les éléments de votre réseau informatique ne sont transmis.

Tous nos développements possèdent une interface web adaptative (PC, smartphone, tablette) que nous améliorons régulièrement.

Pour accéder au SLAM, on peut lui donner un nom (« slam-s » par défaut), suivant les caractéristiques de votre réseau cela peut-être « slam-s.local », par le service « bonjour » si votre PC Windows en est équipé, ou bien par son adresse IP une fois dans votre réseau WiFi.
Une adresse IP fixe est préférable avec une box une box domotique.

API de la version 1.00

Pour déclencher une action sur le SLAM, il suffit d’envoyer une commande à partir de votre box domotique ou bien d’un navigateur internet par un PC, smartphone ou tablette.
Dans les exemples qui vont suivre, nous utiliserons le nom « slam-s » qui peut être remplacé par l’adresse IP.

API en entrée vers le SLAM

http://slam-s/api/leds?set=xxx&color=xxx&bright=xxx&led=xxx&speed=xxx&iteration=xxx&delay=xxx

Nota : L’ordre des mots clés n’a pas d’importance. Tous les mots clés ne sont pas forcément nécessaires, dans le doute, faites des tests avec un navigateur internet.

set=[ on | off | pause | stop | restart | wheel | strobe | fade ]

  • on, allume les leds en fixe avec la dernière couleur et dernière luminosité
  • off, éteint les leds, arrête définitivement l’animation en cours et supprime les couleurs fixées
  • pause, suspend l’animation en cours sans éteindre les leds
  • stop, arrête l’animation en cours et éteint les leds
  • restart, reprend l’animation qui était en pause ou en stop
  • wheel, animation roue
  • strobe, animation flash
  • fade, animation progressive fondue in/out

color=[red | green | blue | yellow | cyan | orange | purple | pink | white | black | rgb(r,g,b) | xrgb ]
avec une couleur prédéfinie : red, green, blue, yellow, cyan, orange, purple, pink, white, black
avec rgb(r,g,b) en valeur décimale ou hexadécimale commençant par la lette ‘x’, exemple pour du bleu : rgb(0,0,255) ou rgb(x0,x0,xff)
avec xrgb un triplet en hexadécimal commençant par la lettre ‘x’, exemple pour du bleu : x0000ff

bright=0 à 255, correspondant à la luminosité (brightness) des leds (valeur par défaut 255, luminosité maxi au démarrage)

led=1 à 12 pour allumer une led de façon indépendante (set=on obligatoire)

speed=0 à 4294967295, correspondant à la vitesse de l’animation (set=[ wheel | strobe | fade] obligatoire) en millisecondes, valeur par défaut 50ms

iteration=n, (set=[ wheel | strobe | fade] obligatoire) n=-1 pour une animation permanente, ou n de 1 à 2147483647 après quoi la commande set=stop sera automatiquement exécutée

delay=n, n=0 pour une animation permanente, à n=4294967295, (set=[ on | wheel | strobe | fade] obligatoire) pour une durée en secondes après quoi la commande set=stop sera automatiquement exécutée

Nota : itération travaille en numérique à la led ou avec un groupe de leds ce qui permet à une animation un cycle complet, alors que delay arrête une animation au bout de n secondes même si le cycle n’est pas complet. En cas de doute, utilisez le mot clé delay.

En retour de cette API, vous obtiendrez la structure JSON suivante si la commande est valide (ou « success »: 0 si non valide) :
{
« success »: 1
}

Quelques exemples :

  • http://slam-s/api/leds?set=on&color=blue, allume les leds en bleu
  • http://slam-s/api/leds?set=pause, suspend l’animation en cours
  • http://slam-s/api/leds?set=strobe&color=white&speed=50, stroboscope blanc, à une vitesse de 20 flashs par seconde, ATTENTION AUX YEUX ça flashe, risque de cécité si vous regardez les leds
  • http://slam-s/api/leds?set=strobe&color=blue&speed=1000&bright=20, allume les leds en bleu pendant 1 seconde puis éteint les leds pendant 1 seconde de façon périodique avec une luminosité de 8% environ
  • http://slam-s/api/leds?set=wheel&color=red&speed=50, animation roue en rouge à une vitesse de 50 millisecondes par led soit 1/3 de seconde environ par tour
  • http://slam-s/api/leds?set=restart, reprend l’animation mis en pause
  • http://slam-s/api/leds?set=fade&color=green&speed=3, fondue in/out en vert avec 3 millisecondes entre chaque pas des 256 intensités soit un peu moins d’une seconde entre chaque fondue
  • http://slam-s/api/leds?set=off, éteint les leds
  • http://slam-s/api/leds?set=on&color=cyan&bright=20, allume les leds en cyan avec une luminosité de 8% environ

http://slam-s/api/version

Cette API renvoie une structure JSON :
{
« product »: « SLAM-S », Nom du produit
« version »: « 1.00b », Version
« device »: « SLAM-S », Nom du device donné dans la page de configuration
« uptime »: « 0 day 0 hour 9 minutes » En service depuis
}

http://slam-s/api/set?auto_update=[ yes | no]&restore_last_set=[ yes | no]&delay=xxx&varn=xxx&url=xxx

Nota : L’ordre des mots clés n’a pas d’importance. Tous les mots clés ne sont pas forcément nécessaires.

  • auto_update, permet d’automatiser les mises à jour au démarrage du SLAM
  • restore_last_set, permet de reprendre l’état en cours après une coupure de courant
  • delay=n, de 500 à 3000ms, temps d’attente total pour déterminer l’appui long et les appuis brefs
  • varn, avec n de 1 à 3 sont les variables définies dans la page de configuration
  • url, contenu de l’url (commande) qui sera envoyé à la box domotique lors d’un appui sur l’interrupteur

Nota : Vous pouvez envoyer les paramètres var en une ligne avec les autres paramètres : &var1=xxx&var2=xxx&var3=xxx

http://slam-s/api/reboot

Permet de redémarrer le SLAM à distance.

API en sortie du SLAM vers une box domotique

http://box_domotique/….actionneur=xxx&value=[SWITCH]….

Le mot clé [SWITCH] est automatiquement remplacé par :

  • 10, pour un appui long
  • 11, une pression brève
  • 12, deux pressions brèves
  • 13, trois pressions brèves
  • 14, quatre pressions brèves

Nota : La saisie de cette API s’effectue dans la page de configuration. Si l’envoi de la première commande échoue, 2 autres essais seront faits à 200ms d’intervalle, après la commande sera ignorée.

Exemple pour eedomus :

http://ip_eedomus/api/set?action=periph.value&periph_id=xxx&value=[SWITCH]&api_user=xxx&api_secret=xxx

La configuration

Alimentez le SLAM avec son adaptateur 5 volts, au bout de 5 secondes toutes les leds vont s’allumer en bleu à 5% de leur luminosité.

salm configuration

Si toutes sont en bleu fixe, vous êtes bien en mode configuration.

Connexion au SLAM

Rechercher le réseau WiFi (mode AP) commençant par « SLAM-S- » suivi par 6 caractères (représentant les 6 derniers caractères de l’adresse MAC), exemple :

slam-s AP

Connectez-vous à celui-ci avec le mot de passe tout en minuscule « rootxxxxxx » ou xxxxxx représente les 6 derniers caractères de l’adresse MAC, exemple pour le réseau WiFi ci-dessus : root3b7fbc

Ouvrez un navigateur internet et saisissez comme adresse url « http://192.168.4.1 ».
Vous pouvez maintenant configurer l’accès du SLAM dans votre réseau WiFi :

slam-s wifi

Sélectionnez votre réseau WiFi dans la liste ou saisissez le nom dans le champ « enter the SSID », puis le mot de passe du réseau WiFi dans le champ « Password ».
Cliquez sur « Apply ».
Si les éléments saisis sont corrects vous aurez un message « Success » suivi d’un bouton rouge « Reboot », le SLAM redémarre et sera en DHCP dans votre réseau, si non vérifiez vos paramètres en fonction du message qui sera affiché.

Reset WiFi du LAM

Le SLAM est alimenté, débranchez-le.
Alimentez le SLAM, au bout de 5 secondes, une animation en bleu de la led 1 à 12 avec une luminosité de 5% va apparaitre.
Pendant cette animation, débranchez-le, attention vous n’avez que 5 secondes.
Alimentez de nouveau le SLAM et suivez la procédure de connexion au SLAM.

Nota : Au lieu de débrancher le SLAM et de le rebrancher, vous pouvez utiliser l’API reboot.

Configuration IP du LAM

Trouvez l’adresse IP du SLAM et saisissez dans l’url de votre navigateur une des 3 possibilités suivantes :

  • http://adresse_ip/network
  • http://slam-s/network
  • http://slam-s.local/network
slam-s network

Vous pouvez modifier le nom du SLAM dans le champ « Name of device », attention celui-ci doit être unique dans votre réseau, les espaces dans le nom sont interdits, il ne peut faire plus de 15 caractères, et plus tard vous pourrez y accéder avec le lien http://nouveau_nom/…
Préférez DHCP sur OFF avec une adresse IP fixe unique.
Vous pouvez mettre un port autre que 80 et dans ce cas pour accéder au SLAM vous taperez l’adresse http://slam-s:numéro_du_port/…
Validez vos paramètres avec « Apply » puis « Reboot » .

Configuration des paramètres

Saisissez l’adresse suivante http://slam-s/config dans votre navigateur.

slam-s config

« Auto update » permet de définir si le SLAM doit rechercher automatiquement les mises à jour au démarrage.
« Restore last state » permet de reprendre l’état des leds après une coupure de courant.
« Delay of switch (ms) » permet de définir le temps d’attente total pour déterminer l’appui long et les appuis brefs.
« [VAR1] à [VAR3] » sont des variables. Exemple : vous pouvez mettre dans [VAR1] l’adresse IP de votre box domotique, dans [VAR2] l’identifiant de l’actionneur de votre box domotique, dans [VAR3] vos codes utilisateur API de votre box domotique.
« URL send [SWITCH] » l’url de la commande à envoyer vers votre box domotique quand vous actionnez l’interrupteur. Les variables [VARn] seront remplacées par les valeurs saisies des champs précédents et [SWITCH] sera remplacé par :

  • 10, pour un appui long
  • 11, une pression brève
  • 12, deux pressions brèves
  • 13, trois pressions bréves
  • 14, quatre pressions brèves

Nota : Dans le champ « URL send [SWITCH] », les mots clés [VAR1] [VAR2] [VAR3] et [SWITCH] doivent être en majuscule pour que le remplacement soit exécuté.

Modifier le réseau WiFi du LAM déjà configuré

Saisissez l’adresse suivante http://slam-s/wifi dans votre navigateur.

Etat et informations

Saisissez l’adresse suivante http://slam-s/info dans votre navigateur :

slam-s info
slam-s info

Mise à jour manuelle du frimware

Saisissez l’adresse suivante http://slam-s/update dans votre navigateur :

slam-s update

Sélectionnez le fichier, puis cliquez sur Update.
Le SLAM redémarrera automatiquement après la mise à jour.

La box domotique

Sur eedomus par exemple, il suffit de créer un actionneur de type http, avec les paramètres couleur, animations, etc …
Idem pour le retour d’état de l’interrupteur.

Nota : Sur eedomus le contributeur Influmam a écrit un plugin dans le store qui permet de renseigner les champs [VARn] et URL send [SWITCH] automatiquement. De plus, le plugin créé des actionneurs prédéfinis vous facilitant considérablement la tâche, ainsi qu’un actionneur d’état pour l’interrupteur.
Plugins d’Influman sur eedomus
Merci à Influmam.
Le SLAM sur eedomus

Roadmap des versions futures

Une page d’accueil protégée par mot de passe.
Un menu pour enchainer les différentes pages de configuration.

Conclusion

Voilà pour cette présentation du SLAM.
Elle est encore perfectible et s’améliorera au fil du temps.
Faites nous part de vos remarques et améliorations que vous souhaitez.

Retrouvez ces produits dans la boutique.

Laisser un commentaire