Update IoT Cloud > Arduino Cloud

Author: karlsoderby

content/arduino-cloud/00.guides/03.micropython/content.md

@@ -61,8 +61,8 @@ Next step is to create some cloud variables, which we will later interact with v
 4. Create another variable, name it `ledSwitch` and select it to be `int` type.
 
 You should now have **two variables**:
-- `test_switch` 
-- `test_value`
+- `led` - boolean 
+- `ledSwitch` - boolean
 
 It is important that they are named exactly like this, as we will be using them in the example script of this guide.
 
@@ -72,8 +72,23 @@ Your Thing should look something like this when you are finished:
 
 ***Learn more about how variables work in the [Variables documentation](/arduino-cloud/cloud-interface/variables)***
 
+### Create Dashboard
+
+When finished with creating your Thing, we also need to create a dashboard, a tool to monitor & interact with the cloud variables.
+
+1. Go to the [dashboards](app.arduino.cc/dashboards) section, and **create a new dashboard.**
+2. In the dashboard, first create a **LED** widget, and link it to the `led` variable we created earlier.
+3. Create a **Switch** widget, and link it to `ledSwitch`. 
+4. You should now have two widgets, looking something like the image below:
+
+![Dashboard with LED & Switch widgets.](assets/dashboard.png)
+
+We are now finished with the Arduino Cloud configuration, and we can proceed with the MicroPython setup.
+
 ## MicroPython Setup
 
+In this section, we will install the [Arduino IoT Cloud Python](https://pypi.org/project/arduino-iot-cloud/) library on the Arduino board, and run a script that synchronizes the board with the Arduino Cloud.
+
 ### Create Secret.py File
 
 During the [device configuration](#thing--device-configuration), you obtained a  **device ID** and **secret key**. These details can be stored, along with your Wi-Fi® credentials, in a `secrets.py` file. Here is an example of how `secrets.py` should look like:
@@ -190,7 +205,7 @@ if __name__ == "__main__":
 
 ## Testing It Out
 
-Open Arduino Lab for MicroPython and connect to your board. Pasting the above code and run the script. Then open your Arduino IoT Cloud dashboard. You should see the registered "ledSwitch" and "led" widgets. Toggle the "ledSwitch", and the LED on your Arduino board should light up accordingly. The state of the "led" variable should also change, mirroring the state of the physical LED.
+Open Arduino Lab for MicroPython and connect to your board. Pasting the above code and run the script. Then open your Arduino Cloud dashboard. You should see the registered "ledSwitch" and "led" widgets. Toggle the "ledSwitch", and the LED on your Arduino board should light up accordingly. The state of the "led" variable should also change, mirroring the state of the physical LED.
 
 ## Troubleshoot
 

content/arduino-cloud/00.guides/04.python/assets/device-key.png

@@ -1,6 +1,6 @@
 ---
 title: 'Python'
-description: 'Learn how to use the Python library to connect to the Arduino IoT Cloud.'
+description: 'Learn how to use the Python library to connect to the Arduino Cloud.'
 tags: 
   - IoT
   - Python
@@ -45,6 +45,8 @@ To begin with, we need to create a manual device, and create a new [Thing](/ardu
 3. Click on **"Set Up New Device"**, and select the bottom category (**"Manual Device"**). Click continue in the next window, and choose a name for your device.
 4. Finally, you will see a new **Device ID** and a **Secret Key** generate. You can download them as a PDF. Make sure to save it as you cannot access your Secret Key again.
 
+![Device ID & Secret key.](assets/device-key.png)
+
 - Learn more about Things in the [Things documentation](/arduino-cloud/cloud-interface/things)
 - Learn more about Devices in the [Devices documentation](/arduino-cloud/hardware/devices)
 
@@ -59,6 +61,8 @@ Next step is to create some cloud variables, which we will later interact with v
 
 You should now have **two variables**, `test_switch` and `test_value`. It is important that they are named exactly like this, as we will be using them in the example script of this guide.
 
+![Complete Thing.](assets/thing.png)
+
 - Learn more about how variables work in the [Variables documentation](/arduino-cloud/cloud-interface/variables)
 
 ***Variables that we create here can also be synchronized with variables running on any other device in the platform. This makes it possible to link an Arduino boards with a Python or JavaScript project without writing any connection code!*** 
@@ -74,7 +78,7 @@ python3 --version
 
 ### Install Packages
 
-To install the [arduino-iot-cloud] client, run the following command:
+To install the Arduino IoT Cloud Python client, run the following command:
 
 ```
 pip install arduino-iot-cloud

content/arduino-cloud/00.guides/04.python/assets/thing.png

@@ -37,6 +37,8 @@ To begin with, we need to create a manual device, and create a new [Thing](/ardu
 3. Click on **"Set Up New Device"**, and select the bottom category (**"Manual Device"**). Click continue in the next window, and choose a name for your device.
 4. Finally, you will see a new **Device ID** and a **Secret Key** generate. You can download them as a PDF. Make sure to save it as you cannot access your Secret Key again.
 
+![Device credentials.](assets/device-key.png)
+
 - Learn more about Things in the [Things documentation](/arduino-cloud/cloud-interface/things)
 - Learn more about Devices in the [Devices documentation](/arduino-cloud/hardware/devices)
 
@@ -50,6 +52,8 @@ Next step is to create a cloud variable, which we will later interact with in ou
 
 You should now have a variable named `test_value`. It is important that it is named exactly like this, as we will be using it in the example script of this guide.
 
+![Complete Thing.](assets/thing.png)
+
 - Learn more about how variables work in the [Variables documentation](/arduino-cloud/cloud-interface/variables)
 
 ***Variables that we create here can also be synchronized with variables running on any other device in the platform. This makes it possible to link an Arduino boards with a Python or JavaScript project without writing any connection code!*** 

…ets/Screenshot 2023-10-24 at 16.02 1.png …ud/00.guides/04.python/assets/values.pngcontent/arduino-cloud/00.guides/04.python/assets/Screenshot 2023-10-24 at 16.02 1.png renamed to content/arduino-cloud/00.guides/04.python/assets/values.png content/arduino-cloud/00.guides/04.python/assets/Screenshot 2023-10-24 at 16.02 1.png renamed to content/arduino-cloud/00.guides/04.python/assets/values.png

@@ -13,17 +13,17 @@ author: 'Liam Aljundi'
 
 Node-RED is a programming tool for connecting hardware devices such as Arduino with other hardware devices, APIs, and online services easily using a web-based flow editor. It allows you to connect those different devices and services by connecting a combination of nodes that create your desired flow.
 
-In this tutorial, we will look into the applications of using Node-RED together with the Arduino IoT Cloud. The integration of the two platforms allows us to facilitate communications between the Arduino IoT Cloud and home automation devices, send and receive data from online services such as Email and SMS, and write JavaScript code to manipulate the data.
+In this tutorial, we will look into the applications of using Node-RED together with the Arduino Cloud. The integration of the two platforms allows us to facilitate communications between the Arduino Cloud and home automation devices, send and receive data from online services such as Email and SMS, and write JavaScript code to manipulate the data.
 
-***Note: this tutorial requires a [subscription to the Arduino IoT Cloud](https://cloud.arduino.cc/plans), all three subscriptions (Entry, Maker & Maker Plus) are valid.***
+***Note: this tutorial requires a [subscription to the Arduino Cloud](https://cloud.arduino.cc/plans), all three subscriptions (Entry, Maker & Maker Plus) are valid.***
 
 ## Goals
 
-- Set up Node-RED with the Arduino IoT Cloud.
+- Set up Node-RED with the Arduino Cloud.
 - Use simple Flows with Node-RED.
-- Build a Node-RED Flow that pulls data from Arduino IoT Cloud.
-- Manipulate data received from the Arduino IoT Cloud using JavaScript code.
-- Send email notifications with data from the Arduino IoT Cloud.
+- Build a Node-RED Flow that pulls data from Arduino Cloud.
+- Manipulate data received from the Arduino Cloud using JavaScript code.
+- Send email notifications with data from the Arduino Cloud.
 
 ## Hardware & Software Requirements
 
@@ -33,7 +33,7 @@ In this tutorial, we will look into the applications of using Node-RED together
 
 For this tutorial, you will need a cloud compatible board. You will find all compatible boards in the link below:
 
-- [Arduino IoT Cloud compatible hardware.](/cloud/iot-cloud/tutorials/iot-cloud-getting-started#compatible-hardware)
+- [Arduino Cloud compatible hardware.](/cloud/iot-cloud/tutorials/iot-cloud-getting-started#compatible-hardware)
 
 
 ## Node-RED Setup
@@ -107,7 +107,7 @@ You can run the simple flow shown below using Node-RED's default nodes:
 
 Your message should be printed to the console on the right side.
 
-In addition to the default nodes installed in node-RED, you can use the palette manager to install additional nodes that can be useful to creating more advanced flows. Follow the steps below to install the Arduino IoT Cloud nodes using the palette manager:
+In addition to the default nodes installed in node-RED, you can use the palette manager to install additional nodes that can be useful to creating more advanced flows. Follow the steps below to install the Arduino Cloud nodes using the palette manager:
 
 **1.** Click on the menu in the header bar in the top right corner.
 
@@ -119,17 +119,17 @@ In addition to the default nodes installed in node-RED, you can use the palette
 
 **5.** From the results, install **"@arduino/node-red-contrib-arduino-iot-cloud"**.
 
-![Installing the Arduino IoT Cloud Palette](assets/nodered-03.gif)
+![Installing the Arduino Cloud Palette](assets/nodered-03.gif)
 
-Now, you should be able to use the Arduino IoT Cloud nodes from the palette on the left side of the editor. There are five IoT Cloud nodes: property in, property out, historic, periodic, and inject. Each of the nodes has a description of its function, which appears when you hover over the node.
+Now, you should be able to use the Arduino Cloud nodes from the palette on the left side of the editor. There are five IoT Cloud nodes: property in, property out, historic, periodic, and inject. Each of the nodes has a description of its function, which appears when you hover over the node.
 
 ## Setting Up a Thing
 
 The Thing we will create for this example is quite simple. It is a sketch to read humidity values from a **DHT11 humidity sensor**, any other values can be used alternatively, such as temperature, soil moisture, light etc. Keep in mind that the code and example below are specific to using the DHT11 humidity sensor.
 
 Follow the steps below to set up the Thing:
 
-- Go to the Arduino IoT Cloud -> Thing -> Create a Thing
+- Go to the Arduino Cloud -> Thing -> Create a Thing
 - Add your Device and your Network credentials
 - Add an integer Variable, with the name humidity, and set permissions to Read Only
 - Go to the **"Sketch"** tab and replace the code with the code below:  
@@ -153,7 +153,7 @@ Follow the steps below to set up the Thing:
     // Defined in thingProperties.h
     initProperties();
     
-    // Connect to Arduino IoT Cloud
+    // Connect to Arduino Cloud
     ArduinoCloud.begin(ArduinoIoTPreferredConnection);
     
     setDebugMessageLevel(2);
@@ -179,15 +179,15 @@ The final step is connecting the **DHT11 humidity sensor** to our Arduino MKR Wi
 
 ## Communicating with Node-RED
 
-Use the steps below to use Node-RED with the Arduino IoT Cloud:
+Use the steps below to use Node-RED with the Arduino Cloud:
 
 **1.** Go to the [API keys section](app.arduino.cc/home/api-keys), and create a new API key.
 
 **2.** Save the Client ID and Client Secret in a safe document
 
 **3.** Go to Node-RED web page at [http://localhost:1880](http://localhost:1880)
 
-**4.** Add the Arduino IoT Cloud "**property out**" node from the palette menu on the left side
+**4.** Add the Arduino Cloud "**property out**" node from the palette menu on the left side
 
 **5.** Double click on the node -> select "Add new Arduino-connection"
 
@@ -201,11 +201,11 @@ Use the steps below to use Node-RED with the Arduino IoT Cloud:
 
 ### Creating a Flow
 
-Now that you have a node pulling data from the Arduino IoT Cloud, you need to use the *Inject* node in order to manipulate and send the data. All you need to do is dragging the *Inject* node and connect it to the property out node, then double-clicking on the inject node to ensure that the right Thing and property are selected. 
+Now that you have a node pulling data from the Arduino Cloud, you need to use the *Inject* node in order to manipulate and send the data. All you need to do is dragging the *Inject* node and connect it to the property out node, then double-clicking on the inject node to ensure that the right Thing and property are selected. 
 
-Finally, we will add a debug node from the top of the palette menu, to print the values coming from the Arduino IoT Cloud into the console. You will now be able to see the values from the humidity sensor printed into the Node-RED console.
+Finally, we will add a debug node from the top of the palette menu, to print the values coming from the Arduino Cloud into the console. You will now be able to see the values from the humidity sensor printed into the Node-RED console.
 
-The next step is adding a **function node** that processes the data coming from the Arduino IoT Cloud. This node is important when working with a constant flow of data, as it allows you to use JavaScript code to create customized triggers from the received values. After dragging the function node into the editor, double-click on the node and select **"on message"** tab, then insert the code below:
+The next step is adding a **function node** that processes the data coming from the Arduino Cloud. This node is important when working with a constant flow of data, as it allows you to use JavaScript code to create customized triggers from the received values. After dragging the function node into the editor, double-click on the node and select **"on message"** tab, then insert the code below:
 
 ```js
 let data = msg.payload;
@@ -233,7 +233,7 @@ This code will only send values when they are above 60, or when they change back
 
 ### Sending Email Notifications
 
-Now that you are able to pull and manipulate data from the Arduino IoT Cloud, it's time to use this data. In this example, we will show how to send alarm notifications to your email, using the Arduino IoT Cloud. To achieve this, we need to add an email nodes following the steps below:
+Now that you are able to pull and manipulate data from the Arduino Cloud, it's time to use this data. In this example, we will show how to send alarm notifications to your email, using the Arduino Cloud. To achieve this, we need to add an email nodes following the steps below:
 
 - Click on the menu in the header bar in the top right corner.
 - Select **"Manage palette"**.
@@ -245,8 +245,8 @@ Next, drag the email node from the palette menu on the left side into the editor
 
 ![Email node](./assets/nodered-08.png)
 
-Now, all you need to do is replace the debug node with the email node to receive email notifications with the humidity data received from the Arduino IoT Cloud. You can customize the emails using the function node if you wish.
+Now, all you need to do is replace the debug node with the email node to receive email notifications with the humidity data received from the Arduino Cloud. You can customize the emails using the function node if you wish.
 
 ## Further Applications
 
-In this tutorial we demonstrated how you can use the [Arduino IoT Cloud](https://create.arduino.cc/iot/) together with [Node-RED](https://nodered.org/) to build a more complex automation applications. The email notification is only one of the many different use cases, other applications can be creating communication between the Arduino IoT Cloud to other home automation devices, sending customized SMS and WhatsApp messages, and many more.
+In this tutorial we demonstrated how you can use the [Arduino Cloud](app.arduino.cc) together with [Node-RED](https://nodered.org/) to build a more complex automation applications. The email notification is only one of the many different use cases, other applications can be creating communication between the Arduino Cloud to other home automation devices, sending customized SMS and WhatsApp messages, and many more.