Synoptique des animations du LAM<\/strong><\/h4>\n\n\n\n![\"API](\"https:\/\/i0.wp.com\/www.madomotic.fr\/wp-content\/uploads\/2021\/08\/API-WiFi-LAM.jpg?resize=727%2C420&ssl=1\")
<\/figure><\/div>\n\n\n\nhttp:\/\/lam\/api\/set?cmd<\/strong>=…&color<\/strong>=…&bright<\/strong>=…&led<\/strong>=…&speed<\/strong>=…&iteration<\/strong>=…&delay<\/strong>=…[&user<\/strong>=\u2026&pwd<\/strong>=…<\/em>]<\/h4>\n\n\n\nNota : L’ordre des mots cl\u00e9s n’a pas d’importance. Tous les mots cl\u00e9s ne sont pas forc\u00e9ment n\u00e9cessaires, dans le doute, faites des tests avec un navigateur internet. <\/p>\n\n\n\n
O\u00f9 cmd<\/strong>=[ on <\/strong>| off <\/strong>| pause <\/strong>| stop <\/strong>| restart <\/strong>| wheel <\/strong>| strobe <\/strong>| fade <\/strong>| fadein <\/strong>| fadeout <\/strong>| random <\/strong>| roundtrip <\/strong>| test <\/strong>]<\/p>\n\n\n\n- on, allume les leds en fixe avec la derni\u00e8re couleur et derni\u00e8re luminosit\u00e9<\/li>
- off, \u00e9teint les leds, arr\u00eate d\u00e9finitivement l\u2019animation en cours et supprime les couleurs fix\u00e9es<\/li>
- pause, suspend l\u2019animation en cours sans \u00e9teindre les leds<\/li>
- stop, arr\u00eate l\u2019animation en cours et \u00e9teint les leds<\/li>
- restart, reprend l\u2019animation qui \u00e9tait en pause ou en stop<\/li>
- wheel, animation roue (m\u00eame couleur sur toutes les leds)<\/li>
- strobe, animation flash (m\u00eame couleur sur toutes les leds)<\/li>
- fade, animation progressive fondue in\/out (m\u00eame couleur sur toutes les leds)<\/li>
- fadein, allumage progressif<\/li>
- fadeout, extinction d\u00e9gressive<\/li>
- random, animation al\u00e9atoire des couleurs (le param\u00e8tre &color sera ignor\u00e9)<\/li>
- roundtrip, autre animation roue (m\u00eame couleur sur toutes les leds)<\/li>
- test, pour tester les 3 couleurs primaires sur toutes les leds<\/li><\/ul>\n\n\n\n
O\u00f9 color<\/strong>=[red <\/strong>| green <\/strong>| blue <\/strong>| yellow <\/strong>| cyan <\/strong>| orange <\/strong>| purple <\/strong>| pink <\/strong>| white <\/strong>| black <\/strong>| rgb(r,g,b)<\/strong> | xrgb <\/strong>]
avec une couleur pr\u00e9d\u00e9finie : red, green, blue, yellow, cyan, orange, purple, pink, white, black
avec rgb(r,g,b) en valeur d\u00e9cimale ou hexad\u00e9cimale commen\u00e7ant par la lette \u2018x\u2019, exemple pour du bleu : rgb(0,0,255) ou rgb(x0,x0,xff)
avec xrgb un triplet en hexad\u00e9cimal commen\u00e7ant par la lettre \u2018x\u2019, exemple pour du bleu : x0000ff<\/p>\n\n\n\nO\u00f9 bright<\/strong>=0 \u00e0 255, correspondant \u00e0 la luminosit\u00e9 (brightness) des leds (valeur par d\u00e9faut 31 soit 1\/8 de la luminosit\u00e9 au d\u00e9marrage)<\/p>\n\n\n\nO\u00f9 led<\/strong>=0 \u00e0 nombre de leds-1, pour allumer une led de fa\u00e7on ind\u00e9pendante (ne fonctionne que pour les commandes \u00ab on \/ fadein \/ fadeout \u00bb).
La syntaxe peut \u00e9galement \u00eatre :
led<\/strong>=n[color] avec une couleur optionnelle entre crochets telle que d\u00e9crite ci-dessus,
led<\/strong>=n1-n2[color] qui permet de fixer de la led n1 \u00e0 n2 avec une couleur optionnelle,
Si le param\u00e8tre led <\/strong>est \u00e9gal \u00e0 -1, il affectera toutes les leds,
led <\/strong>peut \u00e9galement fixer des leds en s\u00e9rie avec comme s\u00e9parateur une virgule, exemple :
led<\/strong>=-1[black],2-4[blue],6[x503080]<\/p>\n\n\n\nO\u00f9 speed<\/strong>=0 \u00e0 4 294 967 295, correspondant \u00e0 la vitesse de l\u2019animation (cmd=[ wheel | strobe | fade | fadein | fadeout | random | roundtrip ]) en millisecondes, valeur par d\u00e9faut 50ms ou 3ms suivant l\u2019animation, valeur par d\u00e9faut 50ms<\/p>\n\n\n\nO\u00f9 iteration<\/strong>=n, (cmd=[ wheel | strobe | fade | random | roundtrip ]) n=-1 pour une animation permanente, ou n de 1 \u00e0 2147483647 apr\u00e8s quoi la commande cmd=stop sera automatiquement ex\u00e9cut\u00e9e<\/p>\n\n\n\nO\u00f9 delay<\/strong>=n, n=0 pour une animation permanente, \u00e0 n=4294967295, (cmd=[ on | wheel | strobe | fade | fadein | random | roundtrip ]) pour une dur\u00e9e en secondes apr\u00e8s quoi la commande cmd=stop sera automatiquement ex\u00e9cut\u00e9e<\/p>\n\n\n\nNota : it\u00e9ration <\/strong>travaille en num\u00e9rique \u00e0 la led ou avec un groupe de leds ce qui permet \u00e0 une animation un cycle complet, alors que delay <\/strong>arr\u00eate une animation au bout de n secondes m\u00eame si le cycle n’est pas complet. En cas de doute, utilisez le mot cl\u00e9 delay<\/strong>.<\/p>\n\n\n\nOptionnel, user <\/strong>(ou api_user<\/strong>) et pwd<\/strong> (ou api_secret<\/strong>) est un utilisateur et mot de passe associ\u00e9 pour ex\u00e9cuter les API s’ils sont d\u00e9finis<\/em> dans la page “Passwords”.<\/p>\n\n\n\nEn retour des API, vous obtiendrez la structure JSON suivante si la commande est valide :<\/p>\n\n\n\n
{\n \"success\": 1\n}<\/em><\/code><\/pre>\n\n\n\nQuelques exemples :<\/strong><\/p>\n\n\n\n- http:\/\/lam\/api\/set?cmd=on&color=blue<\/strong>, allume les leds en bleu<\/li>
- http:\/\/lam\/api\/set?cmd=pause<\/strong>, suspend l\u2019animation en cours<\/li>
- http:\/\/lam\/api\/set?cmd=strobe&color=white&speed=50<\/strong>, stroboscope blanc, \u00e0 une vitesse de 20 flashs par seconde,\u00a0ATTENTION AUX YEUX \u00e7a flashe, risque de c\u00e9cit\u00e9 si vous regardez les leds<\/strong><\/li>
- http:\/\/lam\/api\/set?cmd=strobe&color=blue&speed=1000&bright=20<\/strong>, allume les leds en bleu pendant 1 seconde puis \u00e9teint les leds pendant 1 seconde de fa\u00e7on p\u00e9riodique avec une luminosit\u00e9 de 8% environ<\/li>
- http:\/\/lam\/api\/set?cmd=wheel&color=red&speed=50<\/strong>, animation roue en rouge \u00e0 une vitesse de 50 millisecondes par led soit 1\/3 de seconde environ par tour<\/li>
- http:\/\/lam\/api\/set?cmd=restart<\/strong>, reprend l\u2019animation mis en pause<\/li>
- http:\/\/lam\/api\/set?cmd=fade&color=green&speed=3<\/strong>, fondue in\/out en vert avec 3 millisecondes entre chaque pas des 256 intensit\u00e9s soit un peu moins d\u2019une seconde entre chaque fondue<\/li>
- http:\/\/lam\/api\/set?cmd=off<\/strong>, \u00e9teint les leds et supprime les couleurs<\/li>
- http:\/\/lam\/api\/set?cmd=on&color=cyan&bright=20<\/strong>, allume les leds en cyan avec une luminosit\u00e9 de 8% environ<\/li>
- http:\/\/lam\/api\/set?cmd=random<\/strong>, allume les leds de fa\u00e7on al\u00e9atoire<\/li>
- http:\/\/lam\/api\/set?cmd=fadein&delay=10<\/strong>, cr\u00e9\u00e9 un allumage progressif avec la derni\u00e8re couleur fix\u00e9e, un on pendant 10 secondes, puis une extinction d\u00e9gressive<\/li>
- http:\/\/lam\/api\/set?cmd=on&led=-1[black],2-4[blue],6[x503010]<\/strong>, fixe toutes les leds en noir, fixe les leds 2 3 et 4 en bleu, la led 6 sur la couleur 0x503080 que je vous laisse deviner<\/li>
- http:\/\/lam\/api\/set?cmd=fadeint&delay=10&led=-1[black],2-4[blue],6[x503010]<\/strong>, la m\u00eame chose que la commande pr\u00e9c\u00e9dente en progressif avec un fixe de 10 secondes<\/li><\/ul>\n\n\n\n
<\/p>\n\n\n\n
http:\/\/lam\/api\/get?cmd=system<\/strong>&version<\/strong>[&user=…&pwd=…<\/em><\/strong>]<\/h4>\n\n\n\nCette API renvoie une structure JSON :<\/p>\n\n\n\n
{\n \"product\": \"W-LAM\", Nom du produit\n \"version\": \"2.00\", Version\n \"build\": \"May 11 2021 19:49\", R\u00e9alis\u00e9 le ...\n \"sn\": \"XXXXXXXXXXXX\", Num\u00e9ro de s\u00e9rie\n \"success\": 1\n}<\/em><\/code><\/pre>\n\n\n\n<\/p>\n\n\n\n
http:\/\/lam\/api\/get?cmd=system<\/strong>&information<\/strong>[&user=…&pwd=…<\/em><\/strong>]<\/h4>\n\n\n\n{\n \"product\": \"W-LAM\", Nom du produit\n \"version\": \"2.00\", Version\n \"build\": \"May 11 2021 19:49\", R\u00e9alis\u00e9 le ...\n \"sn\": \"XXXXXXXXXXXX\", Num\u00e9ro de s\u00e9rie<\/em>\n \"device\": \"LAM-W\",<\/em> Nom du device donn\u00e9 dans la page de configuration\n \"uptime\": \"0 day 0 hour 9 minutes\" <\/em> En service depuis ...\n \"ssid\": \".........\", Nom du r\u00e9seau WiFi<\/em>\n \"rssi\": \"-39\", Signal et qualit\u00e9 du r\u00e9seau WiFi<\/em>\n \"success\": 1<\/em>\n}<\/em><\/code><\/pre>\n\n\n\n<\/p>\n\n\n\n
http:\/\/lam\/api\/get?cmd=state<\/strong>[&user=…&pwd=…<\/em><\/strong>]<\/h4>\n\n\n\n{<\/em>\n \"cmd\": \"on\", Derni\u00e8re commande d'animation\n \"speed\": 0, Vitesse\n \"iteration\": 1, Nombre d'it\u00e9rations\n \"delay\": 0, D\u00e9lai\n \"bright\": 10, Luminosit\u00e9\n \"color\": \"xff0000\", Couleur RGB globale en hexad\u00e9cimal\n \"led0\": \"x000000\", Couleur impact\u00e9e de la luminosit\u00e9 pour la led 0\n \"led1\": \"xe80000\", Couleur impact\u00e9e de la luminosit\u00e9 pour la led 1\n ...\n \"led11\": \"x000000\", Couleur impact\u00e9e de la luminosit\u00e9 pour la derni\u00e8re led<\/em>\n \"success\": 1\n}<\/em><\/code><\/pre>\n\n\n\n<\/p>\n\n\n\n
http:\/\/lam\/api\/set?cmd=system<\/strong>&auto_update<\/strong>=[ yes | no ]&restore_last_set<\/strong>=[ yes | no ]&brightness<\/strong>=…&first_led<\/strong>=…[&user=…&pwd=…<\/em><\/strong>]<\/h4>\n\n\n\nNota : L’ordre des mots cl\u00e9s n’a pas d’importance. Tous les mots cl\u00e9s ne sont pas forc\u00e9ment n\u00e9cessaires.<\/p>\n\n\n\n
- auto_update, permet d’automatiser les mises \u00e0 jour au d\u00e9marrage du LAM<\/li>
- restore_last_set, permet de reprendre l’\u00e9tat en cours apr\u00e8s une coupure de courant<\/li>
- brightness, luminosit\u00e9 des leds par d\u00e9faut au d\u00e9marrage de 1 \u00e0 255<\/li>
- first_led, premi\u00e8re led pour la translation de 0 \u00e0 nombre de leds-1 (voir la disposition des leds).<\/li><\/ul>\n\n\n\n
<\/p>\n\n\n\n
Pour l’option Switch (interrupteur tactile)<\/strong><\/p>\n\n\n\nhttp:\/\/lam\/api\/set?cmd=system<\/strong>&delay<\/strong>=…&varn<\/strong>=…&url<\/strong>=…[&user=…&pwd=…<\/em><\/strong>]<\/h4>\n\n\n\n- delay=n, de 500 \u00e0 5000ms, temps d\u2019attente pour d\u00e9terminer l\u2019appui long et les appuis brefs (Delay of switch)<\/li>
- varn, avec n de 1 \u00e0 3 sont les variables de type texte d\u00e9finies dans la page de configuration ([VAR1], [VAR2], [VAR3])<\/li>
- url, contenu de l\u2019url (commande) qui sera envoy\u00e9 \u00e0 la box domotique lors d\u2019un appui sur l\u2019interrupteur, l\u2019url doit obligatoirement commencer par http:\/\/ (URL send [SWITCH])<\/li><\/ul>\n\n\n\n
<\/p>\n\n\n\n
http:\/\/lam\/api\/set?cmd=system&reboot<\/strong>[&user=…&pwd=…<\/em><\/strong>]<\/h4>\n\n\n\nPermet de red\u00e9marrer le LAM \u00e0 distance.<\/p>\n\n\n\n
http:\/\/lam\/api\/set?cmd=system&reset_all<\/strong>[&user=…&pwd=…<\/em><\/strong>]<\/h4>\n\n\n\nEfface tous les param\u00e8tres y compris le WiFi, mots de passe, etc …<\/p>\n\n\n\n
<\/p>\n\n\n\n
API en sortie du LAM avec interrupteur tactile vers une box domotique ou backend<\/strong><\/h2>\n\n\n\nhttp:\/\/box_domotique\/…actionneur=…&value=[SWITCH]<\/strong>…<\/h4>\n\n\n\nLe mot cl\u00e9 [SWITCH]<\/strong> est automatiquement remplac\u00e9 par :<\/p>\n\n\n\n
<\/figure><\/div>\n\n\n\nhttp:\/\/lam\/api\/set?cmd<\/strong>=…&color<\/strong>=…&bright<\/strong>=…&led<\/strong>=…&speed<\/strong>=…&iteration<\/strong>=…&delay<\/strong>=…[&user<\/strong>=\u2026&pwd<\/strong>=…<\/em>]<\/h4>\n\n\n\nNota : L’ordre des mots cl\u00e9s n’a pas d’importance. Tous les mots cl\u00e9s ne sont pas forc\u00e9ment n\u00e9cessaires, dans le doute, faites des tests avec un navigateur internet. <\/p>\n\n\n\n
O\u00f9 cmd<\/strong>=[ on <\/strong>| off <\/strong>| pause <\/strong>| stop <\/strong>| restart <\/strong>| wheel <\/strong>| strobe <\/strong>| fade <\/strong>| fadein <\/strong>| fadeout <\/strong>| random <\/strong>| roundtrip <\/strong>| test <\/strong>]<\/p>\n\n\n\n- on, allume les leds en fixe avec la derni\u00e8re couleur et derni\u00e8re luminosit\u00e9<\/li>
- off, \u00e9teint les leds, arr\u00eate d\u00e9finitivement l\u2019animation en cours et supprime les couleurs fix\u00e9es<\/li>
- pause, suspend l\u2019animation en cours sans \u00e9teindre les leds<\/li>
- stop, arr\u00eate l\u2019animation en cours et \u00e9teint les leds<\/li>
- restart, reprend l\u2019animation qui \u00e9tait en pause ou en stop<\/li>
- wheel, animation roue (m\u00eame couleur sur toutes les leds)<\/li>
- strobe, animation flash (m\u00eame couleur sur toutes les leds)<\/li>
- fade, animation progressive fondue in\/out (m\u00eame couleur sur toutes les leds)<\/li>
- fadein, allumage progressif<\/li>
- fadeout, extinction d\u00e9gressive<\/li>
- random, animation al\u00e9atoire des couleurs (le param\u00e8tre &color sera ignor\u00e9)<\/li>
- roundtrip, autre animation roue (m\u00eame couleur sur toutes les leds)<\/li>
- test, pour tester les 3 couleurs primaires sur toutes les leds<\/li><\/ul>\n\n\n\n
O\u00f9 color<\/strong>=[red <\/strong>| green <\/strong>| blue <\/strong>| yellow <\/strong>| cyan <\/strong>| orange <\/strong>| purple <\/strong>| pink <\/strong>| white <\/strong>| black <\/strong>| rgb(r,g,b)<\/strong> | xrgb <\/strong>]
avec une couleur pr\u00e9d\u00e9finie : red, green, blue, yellow, cyan, orange, purple, pink, white, black
avec rgb(r,g,b) en valeur d\u00e9cimale ou hexad\u00e9cimale commen\u00e7ant par la lette \u2018x\u2019, exemple pour du bleu : rgb(0,0,255) ou rgb(x0,x0,xff)
avec xrgb un triplet en hexad\u00e9cimal commen\u00e7ant par la lettre \u2018x\u2019, exemple pour du bleu : x0000ff<\/p>\n\n\n\nO\u00f9 bright<\/strong>=0 \u00e0 255, correspondant \u00e0 la luminosit\u00e9 (brightness) des leds (valeur par d\u00e9faut 31 soit 1\/8 de la luminosit\u00e9 au d\u00e9marrage)<\/p>\n\n\n\nO\u00f9 led<\/strong>=0 \u00e0 nombre de leds-1, pour allumer une led de fa\u00e7on ind\u00e9pendante (ne fonctionne que pour les commandes \u00ab on \/ fadein \/ fadeout \u00bb).
La syntaxe peut \u00e9galement \u00eatre :
led<\/strong>=n[color] avec une couleur optionnelle entre crochets telle que d\u00e9crite ci-dessus,
led<\/strong>=n1-n2[color] qui permet de fixer de la led n1 \u00e0 n2 avec une couleur optionnelle,
Si le param\u00e8tre led <\/strong>est \u00e9gal \u00e0 -1, il affectera toutes les leds,
led <\/strong>peut \u00e9galement fixer des leds en s\u00e9rie avec comme s\u00e9parateur une virgule, exemple :
led<\/strong>=-1[black],2-4[blue],6[x503080]<\/p>\n\n\n\nO\u00f9 speed<\/strong>=0 \u00e0 4 294 967 295, correspondant \u00e0 la vitesse de l\u2019animation (cmd=[ wheel | strobe | fade | fadein | fadeout | random | roundtrip ]) en millisecondes, valeur par d\u00e9faut 50ms ou 3ms suivant l\u2019animation, valeur par d\u00e9faut 50ms<\/p>\n\n\n\nO\u00f9 iteration<\/strong>=n, (cmd=[ wheel | strobe | fade | random | roundtrip ]) n=-1 pour une animation permanente, ou n de 1 \u00e0 2147483647 apr\u00e8s quoi la commande cmd=stop sera automatiquement ex\u00e9cut\u00e9e<\/p>\n\n\n\nO\u00f9 delay<\/strong>=n, n=0 pour une animation permanente, \u00e0 n=4294967295, (cmd=[ on | wheel | strobe | fade | fadein | random | roundtrip ]) pour une dur\u00e9e en secondes apr\u00e8s quoi la commande cmd=stop sera automatiquement ex\u00e9cut\u00e9e<\/p>\n\n\n\nNota : it\u00e9ration <\/strong>travaille en num\u00e9rique \u00e0 la led ou avec un groupe de leds ce qui permet \u00e0 une animation un cycle complet, alors que delay <\/strong>arr\u00eate une animation au bout de n secondes m\u00eame si le cycle n’est pas complet. En cas de doute, utilisez le mot cl\u00e9 delay<\/strong>.<\/p>\n\n\n\nOptionnel, user <\/strong>(ou api_user<\/strong>) et pwd<\/strong> (ou api_secret<\/strong>) est un utilisateur et mot de passe associ\u00e9 pour ex\u00e9cuter les API s’ils sont d\u00e9finis<\/em> dans la page “Passwords”.<\/p>\n\n\n\nEn retour des API, vous obtiendrez la structure JSON suivante si la commande est valide :<\/p>\n\n\n\n
{\n \"success\": 1\n}<\/em><\/code><\/pre>\n\n\n\nQuelques exemples :<\/strong><\/p>\n\n\n\n- http:\/\/lam\/api\/set?cmd=on&color=blue<\/strong>, allume les leds en bleu<\/li>
- http:\/\/lam\/api\/set?cmd=pause<\/strong>, suspend l\u2019animation en cours<\/li>
- http:\/\/lam\/api\/set?cmd=strobe&color=white&speed=50<\/strong>, stroboscope blanc, \u00e0 une vitesse de 20 flashs par seconde,\u00a0ATTENTION AUX YEUX \u00e7a flashe, risque de c\u00e9cit\u00e9 si vous regardez les leds<\/strong><\/li>
- http:\/\/lam\/api\/set?cmd=strobe&color=blue&speed=1000&bright=20<\/strong>, allume les leds en bleu pendant 1 seconde puis \u00e9teint les leds pendant 1 seconde de fa\u00e7on p\u00e9riodique avec une luminosit\u00e9 de 8% environ<\/li>
- http:\/\/lam\/api\/set?cmd=wheel&color=red&speed=50<\/strong>, animation roue en rouge \u00e0 une vitesse de 50 millisecondes par led soit 1\/3 de seconde environ par tour<\/li>
- http:\/\/lam\/api\/set?cmd=restart<\/strong>, reprend l\u2019animation mis en pause<\/li>
- http:\/\/lam\/api\/set?cmd=fade&color=green&speed=3<\/strong>, fondue in\/out en vert avec 3 millisecondes entre chaque pas des 256 intensit\u00e9s soit un peu moins d\u2019une seconde entre chaque fondue<\/li>
- http:\/\/lam\/api\/set?cmd=off<\/strong>, \u00e9teint les leds et supprime les couleurs<\/li>
- http:\/\/lam\/api\/set?cmd=on&color=cyan&bright=20<\/strong>, allume les leds en cyan avec une luminosit\u00e9 de 8% environ<\/li>
- http:\/\/lam\/api\/set?cmd=random<\/strong>, allume les leds de fa\u00e7on al\u00e9atoire<\/li>
- http:\/\/lam\/api\/set?cmd=fadein&delay=10<\/strong>, cr\u00e9\u00e9 un allumage progressif avec la derni\u00e8re couleur fix\u00e9e, un on pendant 10 secondes, puis une extinction d\u00e9gressive<\/li>
- http:\/\/lam\/api\/set?cmd=on&led=-1[black],2-4[blue],6[x503010]<\/strong>, fixe toutes les leds en noir, fixe les leds 2 3 et 4 en bleu, la led 6 sur la couleur 0x503080 que je vous laisse deviner<\/li>
- http:\/\/lam\/api\/set?cmd=fadeint&delay=10&led=-1[black],2-4[blue],6[x503010]<\/strong>, la m\u00eame chose que la commande pr\u00e9c\u00e9dente en progressif avec un fixe de 10 secondes<\/li><\/ul>\n\n\n\n
<\/p>\n\n\n\n
http:\/\/lam\/api\/get?cmd=system<\/strong>&version<\/strong>[&user=…&pwd=…<\/em><\/strong>]<\/h4>\n\n\n\nCette API renvoie une structure JSON :<\/p>\n\n\n\n
{\n \"product\": \"W-LAM\", Nom du produit\n \"version\": \"2.00\", Version\n \"build\": \"May 11 2021 19:49\", R\u00e9alis\u00e9 le ...\n \"sn\": \"XXXXXXXXXXXX\", Num\u00e9ro de s\u00e9rie\n \"success\": 1\n}<\/em><\/code><\/pre>\n\n\n\n<\/p>\n\n\n\n
http:\/\/lam\/api\/get?cmd=system<\/strong>&information<\/strong>[&user=…&pwd=…<\/em><\/strong>]<\/h4>\n\n\n\n{\n \"product\": \"W-LAM\", Nom du produit\n \"version\": \"2.00\", Version\n \"build\": \"May 11 2021 19:49\", R\u00e9alis\u00e9 le ...\n \"sn\": \"XXXXXXXXXXXX\", Num\u00e9ro de s\u00e9rie<\/em>\n \"device\": \"LAM-W\",<\/em> Nom du device donn\u00e9 dans la page de configuration\n \"uptime\": \"0 day 0 hour 9 minutes\" <\/em> En service depuis ...\n \"ssid\": \".........\", Nom du r\u00e9seau WiFi<\/em>\n \"rssi\": \"-39\", Signal et qualit\u00e9 du r\u00e9seau WiFi<\/em>\n \"success\": 1<\/em>\n}<\/em><\/code><\/pre>\n\n\n\n<\/p>\n\n\n\n
http:\/\/lam\/api\/get?cmd=state<\/strong>[&user=…&pwd=…<\/em><\/strong>]<\/h4>\n\n\n\n{<\/em>\n \"cmd\": \"on\", Derni\u00e8re commande d'animation\n \"speed\": 0, Vitesse\n \"iteration\": 1, Nombre d'it\u00e9rations\n \"delay\": 0, D\u00e9lai\n \"bright\": 10, Luminosit\u00e9\n \"color\": \"xff0000\", Couleur RGB globale en hexad\u00e9cimal\n \"led0\": \"x000000\", Couleur impact\u00e9e de la luminosit\u00e9 pour la led 0\n \"led1\": \"xe80000\", Couleur impact\u00e9e de la luminosit\u00e9 pour la led 1\n ...\n \"led11\": \"x000000\", Couleur impact\u00e9e de la luminosit\u00e9 pour la derni\u00e8re led<\/em>\n \"success\": 1\n}<\/em><\/code><\/pre>\n\n\n\n<\/p>\n\n\n\n
http:\/\/lam\/api\/set?cmd=system<\/strong>&auto_update<\/strong>=[ yes | no ]&restore_last_set<\/strong>=[ yes | no ]&brightness<\/strong>=…&first_led<\/strong>=…[&user=…&pwd=…<\/em><\/strong>]<\/h4>\n\n\n\nNota : L’ordre des mots cl\u00e9s n’a pas d’importance. Tous les mots cl\u00e9s ne sont pas forc\u00e9ment n\u00e9cessaires.<\/p>\n\n\n\n
- auto_update, permet d’automatiser les mises \u00e0 jour au d\u00e9marrage du LAM<\/li>
- restore_last_set, permet de reprendre l’\u00e9tat en cours apr\u00e8s une coupure de courant<\/li>
- brightness, luminosit\u00e9 des leds par d\u00e9faut au d\u00e9marrage de 1 \u00e0 255<\/li>
- first_led, premi\u00e8re led pour la translation de 0 \u00e0 nombre de leds-1 (voir la disposition des leds).<\/li><\/ul>\n\n\n\n
<\/p>\n\n\n\n
Pour l’option Switch (interrupteur tactile)<\/strong><\/p>\n\n\n\nhttp:\/\/lam\/api\/set?cmd=system<\/strong>&delay<\/strong>=…&varn<\/strong>=…&url<\/strong>=…[&user=…&pwd=…<\/em><\/strong>]<\/h4>\n\n\n\n- delay=n, de 500 \u00e0 5000ms, temps d\u2019attente pour d\u00e9terminer l\u2019appui long et les appuis brefs (Delay of switch)<\/li>
- varn, avec n de 1 \u00e0 3 sont les variables de type texte d\u00e9finies dans la page de configuration ([VAR1], [VAR2], [VAR3])<\/li>
- url, contenu de l\u2019url (commande) qui sera envoy\u00e9 \u00e0 la box domotique lors d\u2019un appui sur l\u2019interrupteur, l\u2019url doit obligatoirement commencer par http:\/\/ (URL send [SWITCH])<\/li><\/ul>\n\n\n\n
<\/p>\n\n\n\n
http:\/\/lam\/api\/set?cmd=system&reboot<\/strong>[&user=…&pwd=…<\/em><\/strong>]<\/h4>\n\n\n\nPermet de red\u00e9marrer le LAM \u00e0 distance.<\/p>\n\n\n\n
http:\/\/lam\/api\/set?cmd=system&reset_all<\/strong>[&user=…&pwd=…<\/em><\/strong>]<\/h4>\n\n\n\nEfface tous les param\u00e8tres y compris le WiFi, mots de passe, etc …<\/p>\n\n\n\n
<\/p>\n\n\n\n
API en sortie du LAM avec interrupteur tactile vers une box domotique ou backend<\/strong><\/h2>\n\n\n\nhttp:\/\/box_domotique\/…actionneur=…&value=[SWITCH]<\/strong>…<\/h4>\n\n\n\nLe mot cl\u00e9 [SWITCH]<\/strong> est automatiquement remplac\u00e9 par :<\/p>\n\n\n\n
- on, allume les leds en fixe avec la derni\u00e8re couleur et derni\u00e8re luminosit\u00e9<\/li>
- off, \u00e9teint les leds, arr\u00eate d\u00e9finitivement l\u2019animation en cours et supprime les couleurs fix\u00e9es<\/li>
- pause, suspend l\u2019animation en cours sans \u00e9teindre les leds<\/li>
- stop, arr\u00eate l\u2019animation en cours et \u00e9teint les leds<\/li>
- restart, reprend l\u2019animation qui \u00e9tait en pause ou en stop<\/li>
- wheel, animation roue (m\u00eame couleur sur toutes les leds)<\/li>
- strobe, animation flash (m\u00eame couleur sur toutes les leds)<\/li>
- fade, animation progressive fondue in\/out (m\u00eame couleur sur toutes les leds)<\/li>
- fadein, allumage progressif<\/li>
- fadeout, extinction d\u00e9gressive<\/li>
- random, animation al\u00e9atoire des couleurs (le param\u00e8tre &color sera ignor\u00e9)<\/li>
- roundtrip, autre animation roue (m\u00eame couleur sur toutes les leds)<\/li>
- test, pour tester les 3 couleurs primaires sur toutes les leds<\/li><\/ul>\n\n\n\n
O\u00f9 color<\/strong>=[red <\/strong>| green <\/strong>| blue <\/strong>| yellow <\/strong>| cyan <\/strong>| orange <\/strong>| purple <\/strong>| pink <\/strong>| white <\/strong>| black <\/strong>| rgb(r,g,b)<\/strong> | xrgb <\/strong>]
avec une couleur pr\u00e9d\u00e9finie : red, green, blue, yellow, cyan, orange, purple, pink, white, black
avec rgb(r,g,b) en valeur d\u00e9cimale ou hexad\u00e9cimale commen\u00e7ant par la lette \u2018x\u2019, exemple pour du bleu : rgb(0,0,255) ou rgb(x0,x0,xff)
avec xrgb un triplet en hexad\u00e9cimal commen\u00e7ant par la lettre \u2018x\u2019, exemple pour du bleu : x0000ff<\/p>\n\n\n\nO\u00f9 bright<\/strong>=0 \u00e0 255, correspondant \u00e0 la luminosit\u00e9 (brightness) des leds (valeur par d\u00e9faut 31 soit 1\/8 de la luminosit\u00e9 au d\u00e9marrage)<\/p>\n\n\n\n
O\u00f9 led<\/strong>=0 \u00e0 nombre de leds-1, pour allumer une led de fa\u00e7on ind\u00e9pendante (ne fonctionne que pour les commandes \u00ab on \/ fadein \/ fadeout \u00bb).
La syntaxe peut \u00e9galement \u00eatre :
led<\/strong>=n[color] avec une couleur optionnelle entre crochets telle que d\u00e9crite ci-dessus,
led<\/strong>=n1-n2[color] qui permet de fixer de la led n1 \u00e0 n2 avec une couleur optionnelle,
Si le param\u00e8tre led <\/strong>est \u00e9gal \u00e0 -1, il affectera toutes les leds,
led <\/strong>peut \u00e9galement fixer des leds en s\u00e9rie avec comme s\u00e9parateur une virgule, exemple :
led<\/strong>=-1[black],2-4[blue],6[x503080]<\/p>\n\n\n\nO\u00f9 speed<\/strong>=0 \u00e0 4 294 967 295, correspondant \u00e0 la vitesse de l\u2019animation (cmd=[ wheel | strobe | fade | fadein | fadeout | random | roundtrip ]) en millisecondes, valeur par d\u00e9faut 50ms ou 3ms suivant l\u2019animation, valeur par d\u00e9faut 50ms<\/p>\n\n\n\n
O\u00f9 iteration<\/strong>=n, (cmd=[ wheel | strobe | fade | random | roundtrip ]) n=-1 pour une animation permanente, ou n de 1 \u00e0 2147483647 apr\u00e8s quoi la commande cmd=stop sera automatiquement ex\u00e9cut\u00e9e<\/p>\n\n\n\n
O\u00f9 delay<\/strong>=n, n=0 pour une animation permanente, \u00e0 n=4294967295, (cmd=[ on | wheel | strobe | fade | fadein | random | roundtrip ]) pour une dur\u00e9e en secondes apr\u00e8s quoi la commande cmd=stop sera automatiquement ex\u00e9cut\u00e9e<\/p>\n\n\n\n
Nota : it\u00e9ration <\/strong>travaille en num\u00e9rique \u00e0 la led ou avec un groupe de leds ce qui permet \u00e0 une animation un cycle complet, alors que delay <\/strong>arr\u00eate une animation au bout de n secondes m\u00eame si le cycle n’est pas complet. En cas de doute, utilisez le mot cl\u00e9 delay<\/strong>.<\/p>\n\n\n\n
Optionnel, user <\/strong>(ou api_user<\/strong>) et pwd<\/strong> (ou api_secret<\/strong>) est un utilisateur et mot de passe associ\u00e9 pour ex\u00e9cuter les API s’ils sont d\u00e9finis<\/em> dans la page “Passwords”.<\/p>\n\n\n\n
En retour des API, vous obtiendrez la structure JSON suivante si la commande est valide :<\/p>\n\n\n\n
{\n \"success\": 1\n}<\/em><\/code><\/pre>\n\n\n\nQuelques exemples :<\/strong><\/p>\n\n\n\n
- http:\/\/lam\/api\/set?cmd=on&color=blue<\/strong>, allume les leds en bleu<\/li>
- http:\/\/lam\/api\/set?cmd=pause<\/strong>, suspend l\u2019animation en cours<\/li>
- http:\/\/lam\/api\/set?cmd=strobe&color=white&speed=50<\/strong>, stroboscope blanc, \u00e0 une vitesse de 20 flashs par seconde,\u00a0ATTENTION AUX YEUX \u00e7a flashe, risque de c\u00e9cit\u00e9 si vous regardez les leds<\/strong><\/li>
- http:\/\/lam\/api\/set?cmd=strobe&color=blue&speed=1000&bright=20<\/strong>, allume les leds en bleu pendant 1 seconde puis \u00e9teint les leds pendant 1 seconde de fa\u00e7on p\u00e9riodique avec une luminosit\u00e9 de 8% environ<\/li>
- http:\/\/lam\/api\/set?cmd=wheel&color=red&speed=50<\/strong>, animation roue en rouge \u00e0 une vitesse de 50 millisecondes par led soit 1\/3 de seconde environ par tour<\/li>
- http:\/\/lam\/api\/set?cmd=restart<\/strong>, reprend l\u2019animation mis en pause<\/li>
- http:\/\/lam\/api\/set?cmd=fade&color=green&speed=3<\/strong>, fondue in\/out en vert avec 3 millisecondes entre chaque pas des 256 intensit\u00e9s soit un peu moins d\u2019une seconde entre chaque fondue<\/li>
- http:\/\/lam\/api\/set?cmd=off<\/strong>, \u00e9teint les leds et supprime les couleurs<\/li>
- http:\/\/lam\/api\/set?cmd=on&color=cyan&bright=20<\/strong>, allume les leds en cyan avec une luminosit\u00e9 de 8% environ<\/li>
- http:\/\/lam\/api\/set?cmd=random<\/strong>, allume les leds de fa\u00e7on al\u00e9atoire<\/li>
- http:\/\/lam\/api\/set?cmd=fadein&delay=10<\/strong>, cr\u00e9\u00e9 un allumage progressif avec la derni\u00e8re couleur fix\u00e9e, un on pendant 10 secondes, puis une extinction d\u00e9gressive<\/li>
- http:\/\/lam\/api\/set?cmd=on&led=-1[black],2-4[blue],6[x503010]<\/strong>, fixe toutes les leds en noir, fixe les leds 2 3 et 4 en bleu, la led 6 sur la couleur 0x503080 que je vous laisse deviner<\/li>
- http:\/\/lam\/api\/set?cmd=fadeint&delay=10&led=-1[black],2-4[blue],6[x503010]<\/strong>, la m\u00eame chose que la commande pr\u00e9c\u00e9dente en progressif avec un fixe de 10 secondes<\/li><\/ul>\n\n\n\n
<\/p>\n\n\n\n
http:\/\/lam\/api\/get?cmd=system<\/strong>&version<\/strong>[&user=…&pwd=…<\/em><\/strong>]<\/h4>\n\n\n\n
Cette API renvoie une structure JSON :<\/p>\n\n\n\n
{\n \"product\": \"W-LAM\", Nom du produit\n \"version\": \"2.00\", Version\n \"build\": \"May 11 2021 19:49\", R\u00e9alis\u00e9 le ...\n \"sn\": \"XXXXXXXXXXXX\", Num\u00e9ro de s\u00e9rie\n \"success\": 1\n}<\/em><\/code><\/pre>\n\n\n\n<\/p>\n\n\n\n
http:\/\/lam\/api\/get?cmd=system<\/strong>&information<\/strong>[&user=…&pwd=…<\/em><\/strong>]<\/h4>\n\n\n\n
{\n \"product\": \"W-LAM\", Nom du produit\n \"version\": \"2.00\", Version\n \"build\": \"May 11 2021 19:49\", R\u00e9alis\u00e9 le ...\n \"sn\": \"XXXXXXXXXXXX\", Num\u00e9ro de s\u00e9rie<\/em>\n \"device\": \"LAM-W\",<\/em> Nom du device donn\u00e9 dans la page de configuration\n \"uptime\": \"0 day 0 hour 9 minutes\" <\/em> En service depuis ...\n \"ssid\": \".........\", Nom du r\u00e9seau WiFi<\/em>\n \"rssi\": \"-39\", Signal et qualit\u00e9 du r\u00e9seau WiFi<\/em>\n \"success\": 1<\/em>\n}<\/em><\/code><\/pre>\n\n\n\n<\/p>\n\n\n\n
http:\/\/lam\/api\/get?cmd=state<\/strong>[&user=…&pwd=…<\/em><\/strong>]<\/h4>\n\n\n\n
{<\/em>\n \"cmd\": \"on\", Derni\u00e8re commande d'animation\n \"speed\": 0, Vitesse\n \"iteration\": 1, Nombre d'it\u00e9rations\n \"delay\": 0, D\u00e9lai\n \"bright\": 10, Luminosit\u00e9\n \"color\": \"xff0000\", Couleur RGB globale en hexad\u00e9cimal\n \"led0\": \"x000000\", Couleur impact\u00e9e de la luminosit\u00e9 pour la led 0\n \"led1\": \"xe80000\", Couleur impact\u00e9e de la luminosit\u00e9 pour la led 1\n ...\n \"led11\": \"x000000\", Couleur impact\u00e9e de la luminosit\u00e9 pour la derni\u00e8re led<\/em>\n \"success\": 1\n}<\/em><\/code><\/pre>\n\n\n\n<\/p>\n\n\n\n
http:\/\/lam\/api\/set?cmd=system<\/strong>&auto_update<\/strong>=[ yes | no ]&restore_last_set<\/strong>=[ yes | no ]&brightness<\/strong>=…&first_led<\/strong>=…[&user=…&pwd=…<\/em><\/strong>]<\/h4>\n\n\n\n
Nota : L’ordre des mots cl\u00e9s n’a pas d’importance. Tous les mots cl\u00e9s ne sont pas forc\u00e9ment n\u00e9cessaires.<\/p>\n\n\n\n
- auto_update, permet d’automatiser les mises \u00e0 jour au d\u00e9marrage du LAM<\/li>
- restore_last_set, permet de reprendre l’\u00e9tat en cours apr\u00e8s une coupure de courant<\/li>
- brightness, luminosit\u00e9 des leds par d\u00e9faut au d\u00e9marrage de 1 \u00e0 255<\/li>
- first_led, premi\u00e8re led pour la translation de 0 \u00e0 nombre de leds-1 (voir la disposition des leds).<\/li><\/ul>\n\n\n\n
<\/p>\n\n\n\n
Pour l’option Switch (interrupteur tactile)<\/strong><\/p>\n\n\n\n
http:\/\/lam\/api\/set?cmd=system<\/strong>&delay<\/strong>=…&varn<\/strong>=…&url<\/strong>=…[&user=…&pwd=…<\/em><\/strong>]<\/h4>\n\n\n\n
- delay=n, de 500 \u00e0 5000ms, temps d\u2019attente pour d\u00e9terminer l\u2019appui long et les appuis brefs (Delay of switch)<\/li>
- varn, avec n de 1 \u00e0 3 sont les variables de type texte d\u00e9finies dans la page de configuration ([VAR1], [VAR2], [VAR3])<\/li>
- url, contenu de l\u2019url (commande) qui sera envoy\u00e9 \u00e0 la box domotique lors d\u2019un appui sur l\u2019interrupteur, l\u2019url doit obligatoirement commencer par http:\/\/ (URL send [SWITCH])<\/li><\/ul>\n\n\n\n
<\/p>\n\n\n\n
http:\/\/lam\/api\/set?cmd=system&reboot<\/strong>[&user=…&pwd=…<\/em><\/strong>]<\/h4>\n\n\n\n
Permet de red\u00e9marrer le LAM \u00e0 distance.<\/p>\n\n\n\n
http:\/\/lam\/api\/set?cmd=system&reset_all<\/strong>[&user=…&pwd=…<\/em><\/strong>]<\/h4>\n\n\n\n
Efface tous les param\u00e8tres y compris le WiFi, mots de passe, etc …<\/p>\n\n\n\n
<\/p>\n\n\n\n
API en sortie du LAM avec interrupteur tactile vers une box domotique ou backend<\/strong><\/h2>\n\n\n\n
http:\/\/box_domotique\/…actionneur=…&value=[SWITCH]<\/strong>…<\/h4>\n\n\n\n
Le mot cl\u00e9 [SWITCH]<\/strong> est automatiquement remplac\u00e9 par :<\/p>\n\n\n\n
- http:\/\/lam\/api\/set?cmd=pause<\/strong>, suspend l\u2019animation en cours<\/li>
- http:\/\/lam\/api\/set?cmd=on&color=blue<\/strong>, allume les leds en bleu<\/li>