Skip to content

Commit 01160c9

Browse files
committed
update device guides
1 parent 87811f1 commit 01160c9

File tree

13 files changed

+180
-29
lines changed

13 files changed

+180
-29
lines changed

content/arduino-cloud/01.guides/00.overview/overview.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: "Getting Started"
3-
description: 'The Arduino Cloud is an online platform that makes it easy for you to code, deploy and monitor IoT projects.'
2+
title: 'Getting Started with Arduino Cloud'
3+
description: 'Get started with the Arduino Cloud, an online platform that makes it easy for you to code, deploy and monitor IoT projects.'
44
tags: [Arduino Cloud, Getting Started]
55
author: 'Karl Söderby'
66
---

content/arduino-cloud/01.guides/02.arduino-c/arduino-c.md

Lines changed: 21 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -16,16 +16,23 @@ Whenever you create a [Thing](/arduino-cloud/cloud-interface/things) in the Ardu
1616

1717
## Requirements
1818

19-
- [Registered account at Arduino](https://login.arduino.cc/login),
20-
- [Cloud compatible board](/arduino-cloud/hardware/devices#type-of-devices)
19+
For this guide, you will need to have a registered account at Arduino. Register through the link below:
20+
- [Create an Arduino account](https://login.arduino.cc/login)
21+
22+
You will also need a supported board:
23+
- [Official Arduino Wi-Fi® boards](/arduino-cloud/hardware/wifi)
24+
- [ESP32 / ESP8266 boards](/arduino-cloud/hardware/wifi#configure-esp-boards)
25+
- [Official LoRaWAN® boards](/arduino-cloud/hardware/lora)
26+
- [Official Ethernet setups](/arduino-cloud/hardware/ethernet)
27+
- [Official cellular boards (GSM/NB-IoT)](/arduino-cloud/hardware/cellular)
2128

2229
## Setup
2330

2431
In this section, we will go through the steps necessary to connect your Arduino board to the Arduino Cloud. To follow these steps, please make sure you have a [registered Arduino account](https://login.arduino.cc/login), and that you have access to the [Arduino Cloud](app.arduino.cc).
2532

2633
### Configure Device
2734

28-
First navigate to [Arduino Cloud](app.arduino.cc), and click on the **Devices** tab. Here you can see all your devices, and configure a new one. Depending on what type of board you have, the configuration will vary.
35+
First navigate to [Arduino Cloud](app.arduino.cc), and click on the **Devices** tab. Here you can see all your devices, and configure a new one. Depending on what type of board you have, the configuration will vary.
2936

3037
***For more details, see the [documentation for devices](/arduino-cloud/hardware/devices).***
3138

@@ -39,13 +46,17 @@ A "Thing" is a virtual twin of your hardware, and it is here that we create vari
3946

4047
1. First, let's attach the device we want to use, by clicking the **"Select Device"** button in the **"Associated Devices"** section to the right.
4148
2. let's create a new variable, call it `test`, and select it to be a `boolean` type and with a **read/write** permission.
42-
3. finally, configure your network in the **Network** section. Here you will enter your Wi-Fi® credentials, and if you are using an ESP32 based board, you need to enter the secret key here.
49+
3. finally, configure your network in the **Network** section. Here you will enter your Wi-Fi® credentials, and if you are using an ESP32 based board, you need to enter the secret key here.
50+
51+
![Enter network credentials.](assets/esp32-only.png)
52+
53+
***Your secret key is obtained during the device configuration. Read more at [Configuring ESP boards](/arduino-cloud/hardware/wifi#configure-esp-boards).***
4354

4455
All the above configurations have now been generated into a set of files that can be accessed in the **Sketch** tab.
4556

4657
***For more details, see the [documentation for Things](/arduino-cloud/cloud-interface/things).***
4758

48-
### Complete Sketch
59+
### Create Sketch
4960

5061
The automatically generated sketch is now available to be edited. This sketch includes all necessities to connect to the cloud, and has a callback function generated for each **read/write** variable.
5162

@@ -91,10 +102,11 @@ void onTestChange() {
91102

92103
When our sketch is ready, we can **compile & upload** our sketch to our board. This process can take some time, depending on how large your sketch is.
93104

94-
1. First, make sure your board is connected and visible in the board selection menu.
95-
2. Click the verify/upload button.
96-
3. Wait until the code has successfully been uploaded.
97-
4. Open the serial monitor tool to check for debug messages. If your board is failing to connect, it will print the errors here.
105+
1. First make sure that you have the [Create Agent](https://create.arduino.cc/getting-started/plugin/welcome) installed. This allows Arduino Cloud to communicate with your board in the web interface.
106+
2. Check that your board is connected and visible in the board selection menu.
107+
3. Click the verify/upload button.
108+
4. Wait until the code has successfully been uploaded.
109+
5. Open the serial monitor tool to check for debug messages. If your board is failing to connect, it will print the errors here.
98110

99111
### Verify Connection
100112

1.64 MB
Loading

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

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,8 @@
11
---
22
title: 'MicroPython'
3-
description: 'Learn how to use the MicroPython library to connect to the Arduino IoT Cloud and control an LED.'
3+
description: 'Learn how to connect to the Arduino Cloud using MicroPython.'
44
tags:
5+
- Arduino Cloud
56
- IoT
67
- MicroPython
78
author: 'Sebastian Romero'

content/arduino-cloud/02.hardware/01.devices/devices.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Devices Overview
2+
title: Device Types
33
description: Learn about devices in the Arduino Cloud and how to configure them.
44
tags: [Arduino Cloud, Devices]
55
author: Karl Söderby
1.85 MB
Loading
90.2 KB
Loading
1.69 MB
Loading
365 KB
Loading
67 KB
Loading

0 commit comments

Comments
 (0)