Skip to content

Commit d375608

Browse files
authored
Merge pull request #50 from arduino/sync/karlsoderby/iot-cloud-monitor-update-1
[MKC-330] Update IoT Cloud Getting Started
2 parents 800e962 + 0de85fe commit d375608

23 files changed

+15
-11
lines changed
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Binary file not shown.

content/cloud/iot-cloud/tutorials/01.iot-cloud-getting-started/iot-cloud-getting-started.md

Lines changed: 15 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -109,35 +109,35 @@ To starting using the Arduino IoT cloud, we first need to [log in or sign up to
109109

110110
After we have signed up, you can access the Arduino IoT Cloud from any page on [arduino.cc](https://www.arduino.cc/) by clicking on the four dots menu in the top right corner. You can also [go directly to the Arduino IoT Cloud](https://create.arduino.cc/iot/).
111111

112-
![Navigating to the cloud.](assets/accesscloud.png)
112+
![Navigating to the cloud.](assets/gs-access.png)
113113

114114
### 3. Creating a Thing
115115

116116
The journey always begin by creating a new **Thing**. In the Thing overview, we can choose what device to use, what Wi-Fi network we want to connect to, and create variables that we can monitor and control. This is the main configuration space, where all changes we make are automatically generated into a **special sketch file**.
117117

118-
![The Thing overview.](assets/thingoverview.png)
118+
![The Thing overview.](assets/gs-thing-overview.png)
119119

120120
### 4. Configuring a Device
121121

122122
Devices can easily be added and linked to a Thing. The Arduino IoT Cloud requires your computer to have the [Arduino Agent installed](https://create.arduino.cc/getting-started/plugin/welcome). The configuration process is quick and easy, and can be done by clicking on the **“Select device”** button in the Thing overview. Here, we can choose from any board that has been configured, or select the **“Configure new device”** option.
123123

124-
![Configuring a device.](assets/devicelink.png)
124+
![Configuring a device.](assets/gs-device-attach.png)
125125

126126
We can also get a complete overview of our devices by clicking the **“Devices"** tab at the top of the Arduino IoT Cloud interface. Here we can manage and add new devices.
127127

128-
![The device tab.](assets/deviceoverview.png)
128+
![The device tab.](assets/gs-device-overview.png)
129129

130130
### 5. Creating Variables
131131

132132
The variables we create are automatically generated into a sketch file. There are several data types we can choose from, such as **int, float, boolean, long, char**. There’s also special variables, such as **Temperature, Velocity, Luminance** that can be used. When clicking on the **“Add variable”** button, we can choose name, data type, update setting and interaction mode.
133133

134-
![Creating variables.](assets/variables.png)
134+
![Creating variables.](assets/gs-thing-variables.png)
135135

136136
### 6. Connecting to a Network
137137

138138
To connect to a Wi-Fi network, simply click the **“Configure”** button in the network section. Enter the credentials and click **“Save”**. This information is also generated into your sketch file!
139139

140-
![Entering network credentials.](assets/network.png)
140+
![Entering network credentials.](assets/gs-thing-network.png)
141141

142142
### 7. Editing the Sketch
143143

@@ -151,7 +151,11 @@ Additionally, each time we create a variable that has the **Read & Write** permi
151151

152152
To upload the program to our board, simply click the **"Upload"** button.
153153

154-
![Editing a sketch in the cloud editor.](assets/sketchoverview.png)
154+
![Editing a sketch in the cloud editor.](assets/gs-thing-editor.png)
155+
156+
The editor also has a **Serial Monitor Tool**, which can be opened by clicking the magnifying glass in the toolbar. Here you can view information regarding your connection, or commands printed via `Serial.print()`.
157+
158+
![The Serial Monitor Tool.](assets/gs-serial-monitor.png)
155159

156160
After we have successfully uploaded the code, we can open the **“Serial Monitor”** tab to view information regarding our connection. If it is successful, it will print **“connected to network_name”** and **“connected to cloud”**. If it fails to connect, it will print the errors here as well.
157161

@@ -165,25 +169,25 @@ Now that we have configured the device & network, created variables, completed t
165169

166170
Dashboards are visual user interface for interacting with your boards over the cloud, and we can setup many different setups depending on what your IoT project needs. We can access our dashboards by clicking on the **“Dashboards”** tab at the top of the Arduino IoT Cloud interface, where we can create new dashboards, and see a list of dashboards created for other Things.
167171

168-
![Navigating to dashboards.](assets/navigatedashboard.png)
172+
![Navigating to dashboards.](assets/gs-dashboards.png)
169173

170174
If we click on **“Create new dashboard”**, we enter a dashboard editor. Here, we can create something called **widgets**. Widgets are the visual representation of our variables we create, and there are many different to choose from. Below is an example using several types of widgets.
171175

172-
![The different widgets available.](assets/dashboard2.png)
176+
![The different widgets available.](assets/gs-dashboard-widgets.png)
173177

174178
When we create widgets, we also need to **link them to our variables**. This is done by clicking on a widget we create, select a Thing, and select a variable that we want to link. Once it is linked, we can either interact with it, for example a button, or we can monitor a value from a sensor. As long as our board is connected to the cloud, the values will update!
175179

176180
Let's say we have a **temperature widget** that we want to link to the **temperature** variable inside the **Cloud project** thing.
177181

178-
![Linking a variable to a widget.](assets/dashboard3.png)
182+
![Linking a variable to a widget.](assets/gs-dashboard-link.png)
179183

180184
***Note that not all widgets and variables are compatible. A switch and an integer can for example not be linked, and will not be an option while setting up your dashboard.***
181185

182186
We can also have several things running at once, depending on your Arduino IoT Cloud plan, which we can include in the same dashboard. This is a great feature for tracking multiple boards in for example a larger sensor network, where boards can be connected to different networks around the world, but be monitored from the same dashboard.
183187

184188
## Congratulations
185189

186-
![Illustrated character hugging an Arduino Board](assets/endimg.png)
190+
![What will you build?](assets/endimg.png)
187191

188192
You are just a few easy steps from deploying your very own IoT project. Having a project connected to the Arduino IoT Cloud opens up many possibilities, such as tracking data in real time, triggering remote devices and building wireless systems.
189193

0 commit comments

Comments
 (0)