![\"TP-Link-LB120-API-02\"](\"https:\/\/i0.wp.com\/www.fanjoe.be\/wp-content\/uploads\/2017\/12\/TP-Link-LB120-API-02.jpg?w=332&h=445&ssl=1\" "\\"TP-Link-LB120-API-02\\"")
<\/a> <\/div> <\/div> ![\"TP-Link-LB120-API-01\"](\"https:\/\/i0.wp.com\/www.fanjoe.be\/wp-content\/uploads\/2017\/12\/TP-Link-LB120-API-01.jpg?w=640&h=445&ssl=1\" "\\"TP-Link-LB120-API-01\\"")
<\/a> <\/div> <\/div> <\/div> <\/div>\nOn la trouve sur Amazon<\/a> \u00e0 un prix qui oscille entre 30\u20ac et 35\u20ac.<\/p>\n Il existe diff\u00e9rents projets sur GitHub<\/a> (et sans doute ailleurs) qui permettent de prendre le contr\u00f4le sur la lampe gr\u00e2ce \u00e0 du JavaScript, du Python ou autre… Et ce, sur le r\u00e9seau local en s’adressant directement \u00e0 la lampe ou en en passant par l’API de TP-Link Cloud<\/a>.<\/p>\n Il n’est pas ais\u00e9 de communiquer directement avec la lampe sur le r\u00e9seau local.<\/p>\n Ce d\u00e9p\u00f4t GitHub<\/a> consacr\u00e9 \u00e0 la prise Wi-Fi TP-Link HS100<\/em> en explique les raisons de mani\u00e8re d\u00e9taill\u00e9e :<\/p>\n Le TP-Link HS100 (et la famille apparent\u00e9e) est une prise Wi-Fi intelligente. Par d\u00e9faut, elle se connecte au service Kasa par lequel elle est g\u00e9r\u00e9 \u00e0 distance. Cependant, elle dispose d’une interface locale non document\u00e9e sur le port 9999, XOR-obfuscated JSON, mais qui est autrement compl\u00e8tement ouverte.<\/p>\n Cet objet intelligent ne permet pas la communication TCP directe sur le LAN local, mais permet une communication HTTP sur ce LAN. Nous utiliserons donc un proxy HTTP pour lui parler. Ce proxy LAN local permet d’envoyer des POST JSON au service et de recevoir des r\u00e9ponses JSON, avec lesquelles le gestionnaire de p\u00e9riph\u00e9riques peut travailler.<\/p><\/blockquote>\n Avec l’API du Cloud de TP-Link, il est plus facile de communiquer avec la lampe. Pour ce faire, nous enverrons une requ\u00eate avec un POST dans une commande cURL vers le serveur https:\/\/eu-wap.tplinkcloud.com. Pour l\u2019anecdote, il s’agit d’un serveur Amazon AWS \u00e0 Dublin<\/a>.<\/p>\n Une fois la requ\u00eate accept\u00e9e, le serveur TP-Link envoie un ordre \u00e0 la lampe.<\/p>\n Avant de pouvoir nous lancer et communiquer avec le serveur, nous allons r\u00e9cup\u00e9rer un TOKEN en fournissant l’adresse mail (login) et le mot de passe qui ont servi \u00e0 nous enregistrer sur l’application mobile \u00ab\u00a0Kasa\u00a0\u00bb ou sur le site web https:\/\/www.tplinkcloud.com\/<\/a> :<\/p>\n EDIT 25\/09\/2021<\/strong><\/span><\/p>\n De puis quelques jours, le requ\u00eate cURL requiert une valeur dans le champ Vous pouvez en g\u00e9n\u00e9rer une al\u00e9atoirement via ce site : https:\/\/www.uuidgenerator.net\/version4<\/a><\/p>\n Nous aurons donc une ligne similaire \u00e0 ceci :<\/p>\n R\u00e9f\u00e9rence :<\/strong><\/p>\n Vous devriez obtenir ce genre de r\u00e9ponse :<\/p>\n Pour pouvoir s’adresser au bon objet (si vous avez plusieur lampes et\/ou prises intelligentes), nous aurons besoin de son identifiant. Pour l’obtenir, nous utiliserons la m\u00eame commande cURL, mais avec ces donn\u00e9es et en rempla\u00e7ant les xxxxx par le token obtenu \u00e0 l’\u00e9tape pr\u00e9c\u00e9dente :<\/p>\n Vous devriez obtenir ce genre de r\u00e9ponse :<\/p>\n L’identifiant de l’objet (DeviceID) se situe vers la fin de la ligne.<\/p>\n Voici un petit script en BASH pour obtenir ces deux infos :<\/p>\n Vous pouvez t\u00e9l\u00e9charger ce script en cliquant sur ce lien<\/a>.<\/p>\n Pour le rendre ex\u00e9cutable :<\/p>\n Et pour l’ex\u00e9cuter :<\/p>\n La r\u00e9ponse devrait ressembler \u00e0 ceci :<\/p>\n Pour passer les donn\u00e9es par la commande cURL, voici les donn\u00e9es que nous devrons envoyer :<\/p>\n J’ai introduit quelques variables (en couleur) qui seront utilis\u00e9es dans le script ci-dessous :<\/p>\n J’ignore \u00e0 quoi sert le paramettre Voici un petit script qui vous demandera d’introduire chaque valeur \u00e0 assigner \u00e0 la lampe :<\/p>\n Vous pouvez t\u00e9l\u00e9charger ce script en cliquant sur ce lien<\/a>.<\/p>\n Pour le rendre ex\u00e9cutable :<\/p>\n Et pour l’ex\u00e9cuter :<\/p>\n Voil\u00e0, la lampe devrait maintenant r\u00e9pondre \u00e0 vos commandes au clavier… \ud83d\ude42<\/p>\n R\u00e9f\u00e9rences :<\/strong><\/p>\n Introduction La lampe <\/p>\nLes projets<\/h2>\n
\n
TP-Link Cloud API<\/h1>\n
Local ou Cloud API ?<\/h2>\n
Local<\/h3>\n
Cloud API<\/h3>\n
cURL<\/h2>\n
Token & Device ID<\/h3>\n
Token<\/h4>\n
$ curl --silent --request POST \"https:\/\/eu-wap.tplinkcloud.com\/ HTTP\/1.1\" --data '{ \"method\": \"login\", \"params\": { \"appType\": \"Kasa_Android\", \"cloudUserName\": \"MonAdresseMail<\/span>\", \"cloudPassword\": \"MonPassword<\/span>\", \"terminalUUID\": \"\" } }' --header \"Content-Type: application\/json\"<\/pre>\n
\nterminalUUID<\/code>.<\/p>\n$ curl --silent --request POST \"https:\/\/eu-wap.tplinkcloud.com\/ HTTP\/1.1\" --data '{ \"method\": \"login\", \"params\": { \"appType\": \"Kasa_Android\", \"cloudUserName\": \"MonAdresseMail<\/span>\", \"cloudPassword\": \"MonPassword<\/span>\", \"terminalUUID\": \"MonTerminalUUID<\/span>\" } }' --header \"Content-Type: application\/json\"<\/pre>\n\n
\n{\"error_code\":0,\"result\":{\"regTime\":\"2017-12-21 03:05:33\",\"email\":\"monmail@mondomaine.tld\",\"token\":\"xxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxx<\/span>\"}}<\/pre>\nDevice ID<\/h4>\n
curl --silent --request POST \"https:\/\/wap.tplinkcloud.com?token=xxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxx<\/span> HTTP\/1.1\" --data '{\"method\":\"getDeviceList\"}' --header \"Content-Type: application\/json\"<\/pre>\n{\"error_code\":0,\"result\":{\"deviceList\":[{\"fwVer\":\"1.6.0 Build 170703 Rel.141938\",\"deviceName\":\"Smart Wi-Fi LED Bulb with Tunable White Light\",\"status\":1,\"alias\":\"Mon ampoule intelligente\",\"deviceType\":\"IOT.SMARTBULB\",\"appServerUrl\":\"https:\/\/eu-wap.tplinkcloud.com\",\"deviceModel\":\"LB120(EU)\",\"deviceMac\":\"xxxxxxxxxxxx\",\"role\":0,\"isSameRegion\":true,\"hwId\":\"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\",\"fwId\":\"00000000000000000000000000000000\",\"oemId\":\"F6A0ACBBD7B8B723AE1E32C273ACB5CE\",\"deviceId\":\"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx<\/span>\",\"deviceHwVer\":\"1.0\"}]}}<\/pre>\nScript<\/h4>\n
[bash]#!\/bin\/bash\n\nLogin="monmail@mondomaine.tld"\nCloudPsw="MonPassword"\n\n# On demande le TOKEN \u00e0 partir du login et du password enregistr\u00e9 avec l'App Kasa\n# --silent : Pour \u00e9viter la barre de progression.\nCurlResult=$(curl --silent --request POST "https:\/\/eu-wap.tplinkcloud.com\/ HTTP\/1.1" \\\n--data '{ "method": "login", "params": { "appType": "Kasa_Android", "cloudUserName": '$Login', "cloudPassword": '$CloudPsw', "terminalUUID": "" } }' \\\n--header "Content-Type: application\/json")\n\n#echo R\u00e9ponse Curl compl\u00e8te : $CurlResult\n\n# On d\u00e9coupe la r\u00e9ponse pour ne grader de le TOKEN\n# Coupe apr\u00e8s le 15\u00e8me "\nToken=$(echo $CurlResult | cut -d \\" -f 16)\necho Token : $Token\n\n# On demande la liste des Devices\nCurlResult=$(curl --silent --request POST "https:\/\/wap.tplinkcloud.com?token=$Token HTTP\/1.1" \\\n--data '{"method":"getDeviceList"}' \\\n--header "Content-Type: application\/json")\n\n#echo R\u00e9ponse Curl compl\u00e8te : $CurlResult\n\n# On d\u00e9coupe la r\u00e9ponse pour ne grader de le DeviceID\n# Coupe apr\u00e8s le 55\u00e8me "\nDeviceID=$(echo $CurlResult | cut -d \\" -f 56)\necho&lt;span style="display: inline-block; width: 0px; overflow: hidden; line-height: 0;" data-mce-type="bookmark" class="mce_SELRES_start"&gt;&lt;\/span&gt; Device ID : $DeviceID\n\n[\/bash]<\/pre>\nchmod +x Token+DeviceID_Request.sh<\/pre>\n
.\/Token+DeviceID_Request.sh<\/pre>\n
Token : xxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxx<\/span>\nDevice ID : xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx<\/span><\/pre>\nAction<\/h3>\n
D\u00e9tail du data<\/h4>\n
curl --silent --request POST \"https:\/\/eu-wap.tplinkcloud.com\/?token=$Token<\/span> HTTP\/1.1\" \\<\/pre>\n --data '{\"method\":\"passthrough\", \"params\": {\n \"deviceId\": '$DeviceID<\/span>', \"requestData\": \"{\n \\\"smartlife.iot.smartbulb.lightingservice\\\":{\n \\\"transition_light_state\\\":{\n \\\"on_off\\\":'$LightState<\/span>',\n \\\"transition_period\\\":'$TransitionPeriod<\/span>',\n \\\"mode\\\":\\\"normal\\\",\n \\\"hue\\\":$Hue<\/span>,\n \\\"saturation\\\":$Saturation<\/span>,\n \\\"color_temp\\\":'$ColorTemp<\/span>',\n \\\"brightness\\\":'$Brightness<\/span>'\n }\n }\n }\"\n }\n }' \\<\/pre>\n --header \"Content-Type: application\/json\"<\/pre>\n
$Token # xxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxx<\/span>\n$DeviceID # xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx<\/span>\n\n$LightState # 1 = ON \/ 0 = OFF\n$TransitionPeriod # Dur\u00e9e de transition en ms\n$Brightness # Intensit\u00e9 limineuse en % : min = 1 \/ max = 100\n$ColorTemp # Temp\u00e9rature de couleur en Kelvin : min = 2700 \/ max = 6500<\/pre>\n$Hue<\/code> et $Saturation<\/code> ne seront utilis\u00e9s qu’avec la lampe TP-Link LB130 qui g\u00e8re la trichromie.<\/p>\nmode<\/code>. Peut-\u00eatre une s\u00e9lection entre \u00ab\u00a0normal\u00a0\u00bb et \u00ab\u00a0preset\u00a0\u00bb… Si vous le savez, indiquez-le dans les commentaires.<\/p>\nScript<\/h4>\n
[bash]#!\/bin\/bash\n\nToken=xxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxx\nDeviceID=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n\necho Token : $Token\necho Device ID : $DeviceID\necho\n\nread -p "Etat ? 1=ON 0=OFF : " LightState\nread -p "Intensit\u00e9 ? Min=1 Max=100 : " Brightness\nread -p "T. de couleur en K ? Min=2700 Max=6500 : " ColorTemp\nread -p "T. de transfert en ms ? : " TransitionPeriod\n\nCurlResult=$(curl --silent --request POST "https:\/\/eu-wap.tplinkcloud.com\/?token=$Token HTTP\/1.1" \\\n --data '{"method":"passthrough", "params": {"deviceId": '$DeviceID', "requestData": "{\\"smartlife.iot.smartbulb.lightingservice\\":{\\"transition_light_state\\":{\\"on_off\\":'$LightState',\\"transition_period\\":'$TransitionPeriod',\\"mode\\":\\"normal\\",\\"hue\\":0,\\"saturation\\":0,\\"color_temp\\":'$ColorTemp',\\"brightness\\":'$Brightness'}}}" }}' \\\n --header "Content-Type: application\/json")\n\n[\/bash]<\/pre>\nchmod +x tpl-lb.sh<\/pre>\n
.\/tpl-lb.sh<\/pre>\n
\n