Control a TP-Link smart plug with Arduino Cloud

TP-Link HS100

Node-RED

Kasa Smart

Arduino IoT Cloud

<html><body>This project shows how to control and monitor TP-Link smart plugs using Arduino Cloud and Node-RED. <h3>Introduction</h3>We're surrounded by systems in our homes that help us control and manage our environment. From controlling the heating system and monitoring the temperature to managing the lights and more, these systems make our lives easier. While we can control most of these systems through PC or mobile apps, they are usually locked-in and it can get sometimes not practical to have multiple applications. That's where an integrated platform comes in, offering a centralized hub for all our customized dashboards. But additionally, sometimes, we want to combine data from different applications to trigger actions on other systems. And if you're an Arduino enthusiast like me, you'd want to integrate all of it with your Arduino projects. Arduino Cloud is an excellent solution for that, but integrating external platforms can be a bit tricky, especially with many commercial products lacking direct integration. That's where Node-RED comes to the rescue! It helps us redirect and manage the traffic between these commercial products and Arduino Cloud. This project is part of a series that I've created to showcase how I manage my home systems by integrating them with Arduino Cloud. In addition to this project, I've also worked on integrating <a href="https://projecthub.arduino.cc/dbeamonte_arduino/home-energy-monitoring-with-a-tuya-compatible-energy-meter-and-arduino-cloud-9e41c0">Tuya Energy meters </a>and Honeywell <a href="https://projecthub.arduino.cc/dbeamonte_arduino/connect-your-evohome-heating-system-with-arduino-cloud-c2c510">Evohome heating system </a>, so you can check those out too! <h3>What are TP-Link smart plugs and Kasa?</h3><a href="https://www.tp-link.com/es/home-networking/smart-plug/">TP-Link Smart Wi-Fi Plugs </a>are devices designed to make your everyday appliances and electronics smarter by allowing you to control them remotely through your Wi-Fi network. These plugs are part of TP-Link's smart home ecosystem, designed to provide more convenience and control over your devices. <a href="https://www.kasasmart.com/">Kasa Smart </a>is the platform developed by TP-Link to manage and control these smart devices through a user-friendly app, allowing you to remotely control, schedule, and automate your connected devices for added convenience and efficiency. It provides an API which is very convenient to integrate these devices with other platforms. <h3>What is Arduino Cloud?</h3><a href="https://cloud.arduino.cc">Arduino Cloud </a>is a platform that simplifies the process of developing, deploying, and managing IoT devices. It supports various hardware, including Arduino boards, ESP32, and ESP8266 based boards, and makes it easy for makers, IoT enthusiasts, and professionals to build connected projects without coding expertise. The platform's IoT Cloud tool allows for easy management and monitoring of connected devices through customizable dashboards, which provide real-time visualisations of the device's data. The dashboards can be accessed remotely through the mobile app Arduino IoT Cloud Remote, which is available for both Android and iOS devices, allowing users to manage their devices from anywhere. <h3>What is Node-RED?</h3><a href="https://nodered.org/">Node-RED </a>is an open-source visual programming tool designed for connecting and automating devices, services, and APIs. It provides a browser-based flow editor that allows users to create flows by dragging and dropping nodes onto a canvas and connecting them together. Each node represents a specific functionality or service, such as data input/output, data transformation, or communication with external systems. With its intuitive interface and extensive library of pre-built nodes, Node-RED enables users to quickly and easily create complex workflows without the need for traditional coding. It is particularly popular in the Internet of Things (IoT) domain, where it simplifies the integration of various sensors, devices, and cloud services, allowing users to build powerful IoT applications and automation systems. <h3>Pre-requisites</h3>You need: <ol><li>a TP-Link smart WIFI plug like the <a href="https://www.tp-link.com/es/home-networking/smart-plug/hs100/">HS100</a> </li><li>The Kasa app installed in your mobile phone </li><li>an Arduino Cloud account (https://cloud.arduino.cc) </li><li>an instance of Node-RED (running on a local or Cloud machine). You can find more information about how to install Node-RED [here](https://nodered.org/docs/getting-started/local). </li></ol> You don't need: <ol><li>any Arduino, ESP32 or ESP8266 devices </li></ol><h3>The process</h3>1. Configure your TP-Link smart plug 2. Create the Device and Thing in the Arduino Cloud 3. Create the Node RED flow 4. Create the Arduino Cloud Dashboard 5. Test everything <h3>1. Configure your TP-Link smart plug</h3>The goal is to add your TP-Link smart plug to the Kasa app in your mobile phone. This process connects the device to your WIFI network and internet. You can find the instructions in a leaflet in your smart plug box or in the <a href="https://www.tp-link.com/es/support/download/hs100/">support page </a>. <blockquote>Note: If you are using a different smart plug, you will need to locate the right instructions </blockquote>Note down the IP address of your device. <h3>2. Create the Device in the Arduino Cloud</h3>Create the Device Go to the <a href="https://create.arduino.cc/iot/devices">Devices </a>section of the Arduino IoT Cloud and click on ADD. Select "Any Device" and follow the instructions on the wizard. Note: Save your Device ID and Secret Key. We are not going to use them (as we will use the API key), but it can be helpful for other use cases. Create the Thing In the Devices list, find the device you just created and click on CREATE THING and assign a name to it. Create the Variables Add the variables clicking on the ADD button. At the end of the process, your list of variables should look like this. <figure><img src="https://projects.arduinocontent.cc/4c66556f-1ff2-4e51-87c5-6144e0d17099.png"/><figcaption>Arduino Cloud - Thing variables</figcaption></figure><blockquote>Note: All the variables have to be READ-WRITE. You can define the periodicity you wish or set them with the policy ON-CHANGE. </blockquote>Get an Arduino Cloud API key Go to <a href="https://cloud.arduino.cc/home/api-keys">https://cloud.arduino.cc/home/api-keys </a>. Click on CREATE API KEY , enter a name. Note down the Client ID and Client Secret or download the PDF. We will use these credentials in the Node-RED node. <h3>3. Create the Node-RED flow</h3>Access your Node-RED instance (typically `http://&lt;YOUR_IP&gt;:1880`) and import the code: 1. Select Import in the menu a. Paste the code that you can find in the following <a href="https://raw.githubusercontent.com/dbduino-prjs/arduino-cloud-tplink-plug-nodered/master/flow.json">file </a>in the github project. b. Click on Import 2. Configure the Kasa nodes a. You have to introduce the IP address of your TP-Link smart switch. You can either introduce it manually or click on the `Search` button to search for local devices <figure><img src="https://projects.arduinocontent.cc/3816e2f4-45d6-4c4e-b072-c3fd7dbf344e.png"/><figcaption>Node-RED Kasa property node</figcaption></figure>3. Configure the Arduino Cloud nodes a. Configure your connection with the Arduino Cloud API key that you created in the previous section b. Introduce your Thing and property <figure><img src="https://projects.arduinocontent.cc/121d9a34-5aa2-4089-ae52-0c11e179bc75.png"/><figcaption>Node-RED Arduino Cloud property node</figcaption></figure>Click on Deploy (top right corner of the screen) <h3>4. Create the Arduino Cloud dashboard</h3>Go to the Dashboards section and click on CREATE . You can create the dashboard as you wish. Here you have a screenshot of mine as a reference. As you can see it is fairly simple. <figure><img src="https://projects.arduinocontent.cc/731a05dd-95d3-4db5-97e4-274c5febe13d.png"/><figcaption>Arduino Cloud smart plug dashboard</figcaption></figure><h3>5. Let's test the system</h3>And that's it! Now it is time to go to your Arduino Cloud dashboard, see the status of your plug and control it with the button. </body></html>

Control a TP-Link smart plug with Arduino Cloud

Integrate a TP-Link smart WIFI plug with the rest of your projects using Arduino Cloud and Node-RED