{"id":5669,"date":"2021-05-12T08:06:41","date_gmt":"2021-05-12T06:06:41","guid":{"rendered":"https:\/\/www.madomotic.fr\/?p=5669"},"modified":"2021-08-22T15:59:29","modified_gmt":"2021-08-22T13:59:29","slug":"light-alarm-nouvelles-fonctionnalites-et-api-v2","status":"publish","type":"post","link":"https:\/\/www.madomotic.fr\/index.php\/2021\/05\/12\/light-alarm-nouvelles-fonctionnalites-et-api-v2\/","title":{"rendered":"Light AlarM &#8211; Nouvelles fonctionnalit\u00e9s et API v2"},"content":{"rendered":"\n<p>La s\u00e9rie des Light AlarM (LAM et SLAM) sont dot\u00e9es de nouvelles API qui seront bient\u00f4t enrichies de fonctionnalit\u00e9s suppl\u00e9mentaires.<\/p>\n\n\n\n<p>Pour compatibilit\u00e9, les anciennes API restent disponibles, toutefois sans les futures fonctionnalit\u00e9s.<\/p>\n\n\n\n<p>Retrouvez le descriptif des Light AlaM et les anciennes API sur ces liens <a href=\"https:\/\/www.madomotic.fr\/index.php\/2019\/02\/08\/light-alarm-lam\/\" data-type=\"post\" data-id=\"225\">Light AlarM \u2013 LAM<\/a> et <a href=\"https:\/\/www.madomotic.fr\/index.php\/2019\/04\/09\/super-light-alarm-slam-s\/\" data-type=\"post\" data-id=\"318\">Super Light AlarM \u2013 SLAM-Switch<\/a>.<\/p>\n\n\n\n<p>Au sommaire des nouvelles fonctionnalit\u00e9s, on trouve :<\/p>\n\n\n\n<ul><li>Une interface plus rapide dans la navigation des menus et dans la r\u00e9ponse des API.<\/li><li>Une surveillance d&#8217;accessibilit\u00e9 r\u00e9seau (watchdog) param\u00e9trable qui test la passerelle, et en cas de non disponibilit\u00e9 de celle-ci reboot l&#8217;objet.<\/li><li>D&#8217;un &#8220;Backup \/ Restore&#8221; pour sauvegarder et restaurer une configuration.<\/li><li>L&#8217;indication du signal WiFi (RSSI) dans la page &#8220;Information&#8221; et l&#8217;API correspondante.<\/li><li>La saisie obligatoire de votre adresse email afin <strong>uniquement <\/strong>de vous informer des mises \u00e0 jour.<\/li><\/ul>\n\n\n\n<p>Mais aussi de nouveaux produits \u00e0 venir dans la m\u00eame gamme de t\u00e9moins lumineux disponibles en WiFi et LoRa :<\/p>\n\n\n\n<ul><li>Le <strong>LAM<\/strong> toujours avec 7 leds (que WiFi).<\/li><li>Le <strong>SLAM<\/strong> avec ou sans l&#8217;option Switch (WiFi ou LoRa) devient le Small Light AlarM avec 12 leds, disponible \u00e9galement en version Celiane ou Lexman.<\/li><li>Le <strong>MLAM<\/strong> (WiFi ou LoRa) Medium Light AlarM avec 16 leds.<\/li><li>Le <strong>LLAM <\/strong>(WiFi ou LoRa) Large Light AlarM  avec 24 leds.<\/li><li>Le <strong>LSTP <\/strong>(WiFi ou LoRa) version Led STriP pour les rubans de leds.<\/li><li>Le <strong>LDPY <\/strong>(WiFi ou LoRa) version Led DisPlaY pour un affichage matriciel textuel et d&#8217;ic\u00f4nes.<\/li><\/ul>\n\n\n\n<p>La configuration reste inchang\u00e9e, seules les options sp\u00e9cifiques aux produits peuvent varier.<\/p>\n\n\n\n<p>Les versions LoRa incluent le param\u00e9trage WiFi dans le but des mises \u00e0 jour.<\/p>\n\n\n\n<p><\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>API de la version 2 (12\/05\/2021)<\/strong><\/h2>\n\n\n\n<p>Pour d\u00e9clencher une action sur la gamme des LAM, il suffit d&#8217;envoyer une commande \u00e0 partir de votre box domotique ou bien d&#8217;un navigateur internet, d&#8217;un PC, smartphone ou tablette.<br>Dans les exemples qui vont suivre, nous utiliserons le nom &#8220;lam&#8221; qui peut \u00eatre remplac\u00e9 par le nom du produit ou son adresse IP.<\/p>\n\n\n\n<p><\/p>\n\n\n\n<h4 class=\"wp-block-heading\">http:\/\/lam\/api\/set?<strong>cmd<\/strong>=xxx&amp;<strong>color<\/strong>=xxx&amp;<strong>bright<\/strong>=xxx&amp;<strong>led<\/strong>=xxx&amp;<strong>speed<\/strong>=xxx&amp;<strong>iteration<\/strong>=xxx&amp;<strong>delay<\/strong>=xxx[<strong><em>&amp;user=\u2026\u2026&amp;pwd=\u2026..<\/em><\/strong>]<\/h4>\n\n\n\n<p>Nota : L&#8217;ordre des mots cl\u00e9s n&#8217;a pas d&#8217;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<p>O\u00f9 <strong>cmd<\/strong>=[ on | off | pause| restart | wheel | strobe | fade | random ]<\/p>\n\n\n\n<ul><li>on, allume les leds en fixe avec la derni\u00e8re couleur et derni\u00e8re luminosit\u00e9<\/li><li>off, \u00e9teint les leds, arr\u00eate d\u00e9finitivement l&#8217;animation en cours et supprime les couleurs fix\u00e9es<\/li><li>pause, suspend l&#8217;animation en cours sans \u00e9teindre les leds<\/li><li>stop, arr\u00eate l&#8217;animation en cours et \u00e9teint les leds<\/li><li>restart, reprend l&#8217;animation qui \u00e9tait en pause ou en stop<\/li><li>wheel, animation roue<\/li><li>strobe, animation flash<\/li><li>fade, animation progressive fondue in\/out<\/li><li>random, animation al\u00e9atoire des couleurs (le param\u00e8tre &amp;color sera ignor\u00e9) <\/li><\/ul>\n\n\n\n<p>O\u00f9 <strong>color<\/strong>=[red | green | blue | yellow | cyan | orange | purple | pink | white | black | rgb(r,g,b) | xrgb ]<br>avec une couleur pr\u00e9d\u00e9finie : red, green, blue, yellow, cyan, orange, purple, pink, white, black <br>avec rgb(r,g,b) en valeur d\u00e9cimale ou hexad\u00e9cimale commen\u00e7ant par la lette \u2018x\u2019, exemple pour du bleu&nbsp;: rgb(0,0,255) ou rgb(x0,x0,xff)<br>avec xrgb un triplet en hexad\u00e9cimal commen\u00e7ant par la lettre \u2018x\u2019, exemple pour du bleu&nbsp;: x0000ff<\/p>\n\n\n\n<p>O\u00f9 <strong>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<p>O\u00f9 <strong>led<\/strong>=0 \u00e0 nombre de leds-1 pour allumer une led de fa\u00e7on ind\u00e9pendante (cmd=on obligatoire)<\/p>\n\n\n\n<p>O\u00f9 <strong>speed<\/strong>=0 \u00e0 4 294 967&nbsp;295, correspondant \u00e0 la vitesse de l\u2019animation en millisecondes, valeur par d\u00e9faut 50ms<\/p>\n\n\n\n<p>O\u00f9 <strong>iteration<\/strong>=n, (cmd=[ wheel | strobe | fade | random] obligatoire) 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<p>O\u00f9 <strong>delay<\/strong>=n, n=0 pour une animation permanente, \u00e0 n=4294967295, (cmd=[ on | wheel | strobe | fade | random ] obligatoire) pour une dur\u00e9e en secondes apr\u00e8s quoi la commande cmd=stop sera automatiquement ex\u00e9cut\u00e9e<\/p>\n\n\n\n<p>Nota : <strong>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 <strong>delay <\/strong>arr\u00eate une animation au bout de n secondes m\u00eame si le cycle n&#8217;est pas complet. En cas de doute, utilisez le mot cl\u00e9 <strong>delay<\/strong>.<\/p>\n\n\n\n<p><em>Optionnel,  <strong>user <\/strong>(ou<strong> api_user<\/strong>) et<strong> pwd<\/strong> (ou <strong>api_secret<\/strong>) est un utilisateur et mot de passe associ\u00e9 pour ex\u00e9cuter les API s&#8217;ils sont d\u00e9finis<\/em> dans la page &#8220;Passwords&#8221;.<\/p>\n\n\n\n<p>En retour des API,  vous obtiendrez la structure JSON suivante si la commande est valide :<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><em>{\n  \"success\": 1\n}<\/em><\/code><\/pre>\n\n\n\n<p>Quelques exemples :<\/p>\n\n\n\n<ul><li>http:\/\/lam\/api\/set?cmd=on&amp;color=blue, allume les leds en bleu<\/li><li>http:\/\/lam\/api\/set?cmd=pause, suspend l\u2019animation en cours<\/li><li>http:\/\/lam\/api\/set?cmd=strobe&amp;color=white&amp;speed=50, stroboscope blanc, \u00e0 une vitesse de 20 flashs par seconde, <strong>ATTENTION AUX YEUX \u00e7a flashe, risque de c\u00e9cit\u00e9 si vous regardez les leds<\/strong><\/li><li>http:\/\/lam\/api\/set?cmd=strobe&amp;color=blue&amp;speed=1000&amp;bright=20, 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><li>http:\/\/lam\/api\/set?cmd=wheel&amp;color=red&amp;speed=50, animation roue en rouge \u00e0 une vitesse de 50 millisecondes par led soit 1\/3 de seconde environ par tour<\/li><li>http:\/\/lam\/api\/set?cmd=restart, reprend l\u2019animation mis en pause<\/li><li>http:\/\/lam\/api\/set?cmd=fade&amp;color=green&amp;speed=3, 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><li>http:\/\/lam\/api\/set?cmd=off, \u00e9teint les leds<\/li><li>http:\/\/lam\/api\/set?cmd=on&amp;color=cyan&amp;bright=20, allume les leds en cyan avec une luminosit\u00e9 de 8% environ<\/li><li>http:\/\/lam\/api\/set?cmd=random, allume les leds de fa\u00e7on al\u00e9atoire<\/li><\/ul>\n\n\n\n<p><\/p>\n\n\n\n<h4 class=\"wp-block-heading\">http:\/\/lam\/api\/get?<strong>cmd=system<\/strong>&amp;<strong>version<\/strong>[<strong><em>&amp;user=\u2026\u2026&amp;pwd=\u2026..<\/em><\/strong>]<\/h4>\n\n\n\n<p id=\"block-629e58f6-a733-4ba6-9705-84e747d0db0f\">Cette API renvoie une structure JSON :<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><em>{\n  \"product\": \"LAM-W\",                   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><\/p>\n\n\n\n<h4 class=\"wp-block-heading\">http:\/\/lam\/api\/get?<strong>cmd=system<\/strong>&amp;<strong>information<\/strong>[<strong><em>&amp;user=\u2026\u2026&amp;pwd=\u2026..<\/em><\/strong>]<\/h4>\n\n\n\n<pre class=\"wp-block-code\"><code><em>{\n  \"product\": \"LAM-W\",                   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<em>  \"device\": \"LAM-W\",<\/em>                    Nom du device donn\u00e9 dans la page de configuration\n<em>  \"uptime\": \"0 day 0 hour 9 minutes\" <\/em>   En service depuis ...\n  <em>\"ssid\": \".........\",                  Nom deu r\u00e9seau WiFi<\/em>\n  <em>\"rssi\": \"-39\",                        Signal et qualit\u00e9 du r\u00e9seau WiFi<\/em>\n  <em>\"success\": 1<\/em>\n<em>}<\/em><\/code><\/pre>\n\n\n\n<h4 class=\"wp-block-heading\">http:\/\/lam\/api\/set?<strong>cmd=system<\/strong>&amp;<strong>auto_update<\/strong>=[ yes | no]&amp;<strong>restore_last_set<\/strong>=[ yes | no]&amp;<strong>brightness<\/strong>=x&amp;<strong>first_led<\/strong>=x[<strong><em>&amp;user=\u2026\u2026&amp;pwd=\u2026..<\/em><\/strong>]<\/h4>\n\n\n\n<p>Nota : L&#8217;ordre des mots cl\u00e9s n&#8217;a pas d&#8217;importance. Tous les mots cl\u00e9s ne sont pas forc\u00e9ment n\u00e9cessaires.<\/p>\n\n\n\n<ul><li>auto_update, permet d&#8217;automatiser les mises \u00e0 jour au d\u00e9marrage du LAM<\/li><li>restore_last_set, permet de reprendre l&#8217;\u00e9tat en cours apr\u00e8s une coupure de courant<\/li><li>brightness, luminosit\u00e9 des leds de 1 \u00e0 255<\/li><li>first_led, premi\u00e8re led pour la translation de 0 \u00e0 nombre de leds-1.<\/li><\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">http:\/\/lam\/api\/set?<strong>cmd=system&amp;reboot<\/strong>[<strong><em>&amp;user=\u2026\u2026&amp;pwd=\u2026..<\/em><\/strong>]<\/h4>\n\n\n\n<p>Permet de red\u00e9marrer le LAM \u00e0 distance.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">http:\/\/lam\/api\/set?<strong>cmd=system&amp;reset_all<\/strong>[<strong><em>&amp;user=\u2026\u2026&amp;pwd=\u2026..<\/em><\/strong>]<\/h4>\n\n\n\n<p>Efface tous les param\u00e8tres y compris le WiFi, mots de passe, etc &#8230;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>La s\u00e9rie des Light AlarM (LAM et SLAM) sont dot\u00e9es de nouvelles API qui seront bient\u00f4t enrichies de fonctionnalit\u00e9s suppl\u00e9mentaires. Pour compatibilit\u00e9, les anciennes API restent disponibles, toutefois sans les futures fonctionnalit\u00e9s. Retrouvez le descriptif des Light AlaM et les anciennes API sur ces liens Light AlarM \u2013 LAM et Super Light AlarM \u2013 SLAM-Switch. [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":258,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","_jetpack_memberships_contains_paid_content":false},"categories":[29,35,1,19,24],"tags":[],"jetpack_sharing_enabled":true,"jetpack_featured_media_url":"https:\/\/i0.wp.com\/www.madomotic.fr\/wp-content\/uploads\/2019\/02\/Light-Alarm-LAM.jpg?fit=480%2C443&ssl=1","jetpack-related-posts":[],"_links":{"self":[{"href":"https:\/\/www.madomotic.fr\/index.php\/wp-json\/wp\/v2\/posts\/5669"}],"collection":[{"href":"https:\/\/www.madomotic.fr\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.madomotic.fr\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.madomotic.fr\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.madomotic.fr\/index.php\/wp-json\/wp\/v2\/comments?post=5669"}],"version-history":[{"count":21,"href":"https:\/\/www.madomotic.fr\/index.php\/wp-json\/wp\/v2\/posts\/5669\/revisions"}],"predecessor-version":[{"id":5695,"href":"https:\/\/www.madomotic.fr\/index.php\/wp-json\/wp\/v2\/posts\/5669\/revisions\/5695"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.madomotic.fr\/index.php\/wp-json\/wp\/v2\/media\/258"}],"wp:attachment":[{"href":"https:\/\/www.madomotic.fr\/index.php\/wp-json\/wp\/v2\/media?parent=5669"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.madomotic.fr\/index.php\/wp-json\/wp\/v2\/categories?post=5669"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.madomotic.fr\/index.php\/wp-json\/wp\/v2\/tags?post=5669"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}