Skip to content

Commit 2179036

Browse files
committed
link fixes until cloud interface
1 parent 044c2b9 commit 2179036

File tree

27 files changed

+108
-108
lines changed

27 files changed

+108
-108
lines changed
Loading
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,17 @@
11
---
22
title: "Getting Started"
33
description: 'The Arduino Cloud is an online platform that makes it easy for you to code, deploy and monitor IoT projects.'
4-
tags:
5-
- Arduino Cloud, IoT Cloud
4+
tags: [Arduino Cloud, Getting Started]
65
author: 'Karl Söderby'
76
---
87

9-
The [Arduino Cloud](app.arduino.cc) is a platform for developing Arduino projects and connecting them to the world. It supports secure connections with boards via [Wi-Fi®](), [LoRa®](), [Ethernet]() and [Cellular (GSM/NB-IoT)]().
8+
The [Arduino Cloud](app.arduino.cc) is a platform for developing Arduino projects and connecting them to the world. It supports secure connections with boards via [Wi-Fi®](/arduino-cloud/hardware/wifi), [LoRa®](/arduino-cloud/hardware/lora), [Ethernet](/arduino-cloud/hardware/ethernet) and [Cellular (GSM/NB-IoT)](/arduino-cloud/hardware/cellular).
109

1110
The Arduino Cloud platform includes:
1211
- an **Integrated Development Environment (IDE)** for programming your boards,
13-
- a **cloud backend service** for synchronizing data from Arduino boards, but also from [Python]() & [JavaScript]() clients,
14-
- a **graphical tool (dashboard)** for controlling and monitoring your board (as well as an [mobile app]()).
15-
- [REST API]() and [command line tools]() for larger scale automations.
12+
- a **cloud backend service** for synchronizing data from Arduino boards, but also from [Python](/arduino-cloud/guides/python) & [JavaScript](/arduino-cloud/guides/javascript) clients,
13+
- a **graphical tool (dashboard)** for controlling and monitoring your board (as well as an [mobile app](/arduino-cloud/iot-remote-app/getting-started)).
14+
- [REST API](/arduino-cloud/api/arduino-iot-api) and [command line tools](/arduino-cloud/arduino-cloud-cli/getting-started) for larger scale automations.
1615

1716
Very simply explained, with the Arduino Cloud you can:
1817
1. Create a program for an Arduino based on a brilliant idea you just hatched.
@@ -31,7 +30,7 @@ And if you want to read the value of a sensor connected to your device, it would
3130

3231
Networking code and data synchronizing is **automatically done**, so just focus on the project, and let the Arduino Cloud handle the rest.
3332

34-
***This document will help you get familiar with the [Arduino Cloud]() service, and once you've got a good hang of it, you can explore the [rest of the documentation]().***
33+
***This document will help you get familiar with the [Arduino Cloud](app.arduino.cc) service, and once you've got a good hang of it, you can explore the [rest of the documentation](/arduino-cloud/).***
3534

3635
## Compatible Boards
3736

@@ -42,25 +41,27 @@ Compatibility with the Arduino Cloud is divided into two categories:
4241
- **IoT Cloud Support** - board with a radio module (e.g. Wi-Fi®) are supported. ESP32 based boards are also supported.
4342

4443
For more information and list of supported boards, see the links below:
45-
- [Wi-Fi®]()
46-
- [LoRaWAN®]()
47-
- [Ethernet]()
48-
- [Cellular]()
44+
- [Wi-Fi®](/arduino-cloud/hardware/wifi)
45+
- [LoRa®](/arduino-cloud/hardware/lora)
46+
- [Ethernet](/arduino-cloud/hardware/ethernet)
47+
- [Cellular (GSM/NB-IoT)](/arduino-cloud/hardware/cellular).
48+
49+
***You can also create something called [manual devices](/arduino-cloud/hardware/devices#manual-devices), which allows you to create a virtual instance directly on your computer using JavaScript, Python or MicroPython.***
4950

5051
## Overview
5152

5253
![The Arduino Cloud home page.](assets/home.png)
5354

5455
Anything in the Arduino Cloud can be accessed via the left action bar. In the list below, some with links to a documentation pages.
5556

56-
- **[Sketches]()** - your sketches (programs) are stored here, divided into either a "normal" or "cloud" sketch.
57-
- **[Devices]()** - here you can configure your Arduino boards, ESP32 devices, manual devices (Python, JavaScript and more).
58-
- **[Things]()** - a Thing is a project configuration, where you select device, create variables to synchronize, and enter credentials.
59-
- **[Dashboards]()** - dashboards are used to monitor & control your board through widgets. There's also a [mobile version]() available.
60-
- **[Triggers]()** - triggers can be used to send emails and push notifications based on a value change of a variable.
57+
- **[Sketches](/arduino-cloud/cloud-interface/sketches)** - your sketches (programs) are stored here, divided into either a "normal" or "cloud" sketch.
58+
- **[Devices](/arduino-cloud/hardware/devices)** - here you can configure your Arduino boards, ESP32 devices, manual devices (Python, JavaScript and more).
59+
- **[Things](/arduino-cloud/cloud-interface/things)** - a Thing is a project configuration, where you select device, create variables to synchronize, and enter credentials.
60+
- **[Dashboards](/arduino-cloud/cloud-interface/dashboard-widgets)** - dashboards are used to monitor & control your board through widgets. There's also a [mobile version](/arduino-cloud/iot-remote-app/getting-started) available to view your dashboards from a smartphone.
61+
- **[Triggers](/arduino-cloud/cloud-interface/triggers)** - triggers can be used to send emails and push notifications based on a value change of a variable.
6162
- **Resources** - helpful links and resources. You might have found this article here.
6263
- **Courses** - tailored content for specific products and kits connected to the Arduino Cloud.
63-
- **[Templates]()** - templates are ready-made project that will automatically configure your device, Thing,
64+
- **Templates** - templates are ready-made project that will automatically configure your device, Thing,
6465
- **Integrations** - third party services that are integrated with the Arduino Cloud.
6566

6667
## Get Started with Arduino Cloud
@@ -71,7 +72,6 @@ Setting up a project in the Arduino Cloud is easy, and can be done through a few
7172

7273
To use the Arduino Cloud, you will need an Arduino account, which you can register [here](https://login.arduino.cc/login).
7374

74-
7575
By default, you will have a **free plan**, which can be upgraded to a number of affordable plans starting at 1.99$ a month.
7676

7777
***Read more about [Arduino Cloud plans](https://cloud.arduino.cc/plans)***
@@ -84,7 +84,7 @@ First you will need to connect your board to your computer, and configure your d
8484

8585
The configurations varies between boards, but everything is covered in the installation wizard.
8686

87-
***Learn more in the documentation for [Arduino Cloud Devices]().***
87+
***Learn more in the documentation for [Arduino Cloud Devices](/arduino-cloud/hardware/devices).***
8888

8989
### 3. Create a Thing
9090

@@ -96,17 +96,17 @@ Variables we create will be used in the sketch, and will keep synchronizing as l
9696

9797
When working with your IoT projects, consider this the "main space" for configurations, as you can access your sketche from here as well.
9898

99-
***Learn more in the documentation for [Arduino Cloud Things]().***
99+
***Learn more in the documentation for [Arduino Cloud Things](/arduino-cloud/cloud-interface/things).***
100100

101101
### 4. Write a Sketch
102102

103103
Once you have done the above configurations, you can move on to **create a program/sketch**. This is where *you* decide what you want to create, and what data you want sent to the cloud.
104104

105105
![A sketch in the Arduino Cloud.](assets/editor.png)
106106

107-
When your program is ready, upload it to your board. If your board supports [Over-the-air (OTA)]() uploads, you can from now on upload without your board being connected to your computer!
107+
When your program is ready, upload it to your board. If your board supports [Over-the-air (OTA)](/arduino-cloud/features/ota-getting-started) uploads, you can from now on upload without your board being connected to your computer!
108108

109-
***Learn more in the documentation for [Arduino Cloud sketches]().***
109+
***Learn more in the documentation for [Arduino Cloud sketches](/arduino-cloud/cloud-interface/sketches).***
110110

111111
### 5. Create a Dashboard
112112

@@ -116,31 +116,31 @@ A dashboard allows you to interact with your device from a web interface or mobi
116116

117117
Choose from switches, sliders, RGB picker, message box, gauges and much more to create dashboards. Dashboards are not linked to a specific Thing/device, meaning you can control many different boards from the same dashboard.
118118

119-
Some widgets can be linked to multiple variables, for example the [Advanced Chart]() widget can graph up to 4 variables from different boards simultaneously!
119+
Some widgets can be linked to multiple variables, for example the [Advanced Chart](/arduino-cloud/cloud-interface/dashboard-widgets#advanced-chart) widget can graph up to 4 variables from different boards simultaneously!
120120

121-
***Learn more in the documentation for [Arduino Cloud dashboards]().***
121+
***Learn more in the documentation for [Arduino Cloud dashboards](/arduino-cloud/cloud-interface/dashboard-widgets).***
122122

123123
### 6. Track Your Project
124124

125125
Once you done all configurations, created a program & dashboard, you can sit back and monitor & interact with your project from the web interface or the mobile app.
126126

127-
![Arduino Cloud Dashboard & IoT Remote App]()
127+
![Arduino Cloud Dashboard & IoT Remote App](assets/dashboard-app.png)
128128

129129
## Guides
130130

131131
We recommend checking out the following guides to get started with various coding frameworks:
132-
- [Arduino / C++ setup (default setup)]() - the default installation using the built-in code editor and an Arduino / ESP32 board.
133-
- [Python setup]() - set up of a manual device to run on a PC / Linux system such as Raspberry Pi.
134-
- [MicroPython setup]() - setup of MicroPython on a select number of supported boards.
135-
- [JavaScript / node.js setup]() - setup of JavaScript using node.js, perfect for integrating your front-end projects with the Arduino Cloud.
132+
- [Arduino / C++ setup (default setup)](arduino-cloud/guides/arduino-c) - the default installation using the built-in code editor and an Arduino / ESP32 board.
133+
- [Python setup](/arduino-cloud/guides/python) - set up of a manual device to run on a PC / Linux system such as Raspberry Pi.
134+
- [MicroPython setup](/arduino-cloud/guides/micropython) - setup of MicroPython on a select number of supported boards.
135+
- [JavaScript / node.js setup](/arduino-cloud/guides/javascript) - setup of JavaScript using node.js, perfect for integrating your front-end projects with the Arduino Cloud.
136136

137137
## Features
138138

139139
Make sure to explore the various features of the Arduino Cloud through the links below:
140-
- [**Data Monitoring**](/cloud/iot-cloud/tutorials/cloud-environmental-data) - learn how to easily monitor your Arduino's sensor values through a dashboard.
141-
- [**Variable Synchronisation**](https://docs.arduino.cc/cloud/iot-cloud/tutorials/device-to-device) - variable synchronisation allows you to sync variables across devices, enabling communication between devices with minimal coding.
142-
- [**Scheduler**](https://docs.arduino.cc/cloud/iot-cloud/tutorials/cloud-scheduler) - schedule jobs to go on/off for a specific amount of time (seconds, minutes, hours).
143-
- [**Over-The-Air (OTA) Uploads**](/cloud/iot-cloud/tutorials/ota-getting-started) - upload code to devices not connected to your computer.
144-
- [**Webhooks**](https://docs.arduino.cc/cloud/iot-cloud/tutorials/webhooks) - integrate your project with another service, such as IFTTT.
145-
- [**Amazon Alexa Support**](/cloud/iot-cloud/tutorials/alexa-mkr-rgb-shield) - make your project voice controlled with the Amazon Alexa integration.
146-
- [**Dashboard Sharing**](https://docs.arduino.cc/cloud/iot-cloud/tutorials/sharing-dashboards) - share your data with other people around the world.
140+
- [**Data Monitoring**](/arduino-cloud/application-notes/cloud-environmental-data) - learn how to easily monitor environmental sensor values through a dashboard.
141+
- [**Variable Synchronisation**](/arduino-cloud/features/thing-to-thing) - variable synchronisation allows you to sync variables across devices, enabling communication between devices with minimal coding.
142+
- [**Scheduler**](/arduino-cloud/features/cloud-scheduler) - schedule jobs to go on/off for a specific amount of time (seconds, minutes, hours).
143+
- [**Over-The-Air (OTA) Uploads**](/arduino-cloud/features/ota-getting-started) - upload code to devices not connected to your computer.
144+
- [**Webhooks**](/arduino-cloud/features/webhooks) - integrate your project with another service, such as IFTTT.
145+
- [**Amazon Alexa Support**](/arduino-cloud/guides/alexa) - make your project voice controlled with the Amazon Alexa integration.
146+
- [**Dashboard Sharing**](/arduino-cloud/features/sharing-dashboards) - share your data with other people around the world.

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

+11-11
Original file line numberDiff line numberDiff line change
@@ -5,47 +5,47 @@ tags: [IoT Cloud, Setup]
55
author: 'Karl Söderby'
66
---
77

8-
The default option for programming your board to connect to the Arduino IoT Cloud is by using the **Arduino / C++ language**. The configuration and connection between your board and the IoT Cloud is supported by the [ArduinoIoTCloud library]() & [Arduino_ConnectionHandler]() libraries.
8+
The default option for programming your board to connect to the Arduino IoT Cloud is by using the **Arduino / C++ language**. The configuration and connection between your board and the IoT Cloud is supported by the [ArduinoIoTCloud library](https://github.com/arduino-libraries/ArduinoIoTCloud) & [Arduino_ConnectionHandler](https://github.com/arduino-libraries/Arduino_ConnectionHandler) libraries.
99

10-
Whenever you create a [Thing]() in the IoT Cloud, you automatically start generating a set of files that will handle the configurations, credentials & connection:
10+
Whenever you create a [Thing](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/cloud-interface/things) in the IoT Cloud, you automatically start generating a set of files that will handle the configurations, credentials & connection:
1111
- `<sketchname>.ino` - your main sketch file,
1212
- `thingProperties.h` - your main configuration file,
1313
- `arduino_secrets.h` - your credentials file (for API key, Wi-Fi network etc.)
1414

1515
In this guide, we will take a look at how you can connect to the IoT Cloud using the Arduino / C++ programming language.
1616

17-
***If you want to find out more about what the Arduino IoT Cloud service, go to the [overview]() section.***
17+
***If you want to find out more about what the Arduino Cloud service can do, go to the [overview](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/guides/overview) section.***
1818

1919
## Requirements
2020

21-
- [Registered account at Arduino](),
22-
- [Cloud compatible board]()
21+
- [Registered account at Arduino](https://login.arduino.cc/login),
22+
- [Cloud compatible board](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/hardware/devices#type-of-devices)
2323

2424
## Setup
2525

26-
In this section, we will go through the steps necessary to connect your Arduino board to the IoT 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 [IoT Cloud](https://create.arduino.cc/iot/).
26+
In this section, we will go through the steps necessary to connect your Arduino board to the IoT 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).
2727

2828
### Configure Device
2929

30-
First navigate to [IoT Cloud](https://create.arduino.cc/iot/), 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.
30+
First navigate to [IoT 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.
3131

32-
***For more details, see the [documentation for IoT Cloud devices]().***
32+
***For more details, see the [documentation for IoT Cloud devices](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/hardware/devices).***
3333

3434
### Configure Thing
3535

3636
Next, navigate to the **Things** tab. Here you will see a list of your Things, and a button to create a new one. When you create a new Thing, you will open up a new configuration space.
3737

3838
![Arduino IoT Cloud Thing Interface](assets/thing-config.png)
3939

40-
A "Thing" is a virtual twin of your hardware, and it is here that we create variables that we want to synchronize between the cloud and board. Any changes we make here will be reflected in an [automatically generated sketch]().
40+
A "Thing" is a virtual twin of your hardware, and it is here that we create variables that we want to synchronize between the cloud and board. Any changes we make here will be reflected in an [automatically generated sketch](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/cloud-interface/sketches#iot-sketches).
4141

4242
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.
4343
2. let's create a new variable, call it `test`, and select it to be a `boolean` type and with a **read/write** permission.
4444
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.
4545

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

48-
***For more details, see the [documentation for IoT Cloud Things]().***
48+
***For more details, see the [documentation for IoT Cloud Things](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/cloud-interface/things).***
4949

5050
### Complete Sketch
5151

@@ -112,4 +112,4 @@ To control the state of the `test` variable, we can setup a **dashboard** and a
112112

113113
![Controlling built-in LED via a switch widget.]()
114114

115-
***You can find more details in the [Arduino IoT Cloud dashboards documentation]().***
115+
***You can find more details in the [Arduino IoT Cloud dashboards documentation](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/cloud-interface/dashboard-widgets).***

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

+3-3
Original file line numberDiff line numberDiff line change
@@ -48,8 +48,8 @@ Then, we need to configure a Thing in the [Arduino Cloud](app.arduino.cc/things)
4848

4949
![Device Key.](assets/device-key.png)
5050

51-
- Learn more about Things in the [Things documentation]()
52-
- Learn more about Devices in the [Devices documentation]()
51+
- Learn more about Things in the [Things documentation](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/cloud-interface/things)
52+
- Learn more about Devices in the [Devices documentation](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/hardware/devices)
5353

5454
### Create Variables
5555

@@ -70,7 +70,7 @@ Your Thing should look something like this when you are finished:
7070

7171
![Finished Thing interface.](assets/thing.png)
7272

73-
***Learn more about how variables work in the [Variables documentation]()***
73+
***Learn more about how variables work in the [Variables documentation](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/cloud-interface/variables)***
7474

7575
## MicroPython Setup
7676

0 commit comments

Comments
 (0)