8000 Update editor.md · mc-ireiser/arduino-docs-content@5f0908f · GitHub
[go: up one dir, main page]

Skip to content

Commit 5f0908f

Browse files
committed
Update editor.md
1 parent e3439b5 commit 5f0908f

File tree

1 file changed

+60
-33
lines changed
  • content/arduino-cloud/01.guides/01.editor

1 file changed

+60
-33
lines changed

content/arduino-cloud/01.guides/01.editor/editor.md

Lines changed: 60 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -6,54 +6,81 @@ author: 'Karl Söderby'
6< 8000 /code>6

77
The [Cloud Editor](https://app.arduino.cc/sketches/) is an online code editor that is part of the [Arduino Cloud](https://app.arduino.cc/). With the Cloud Editor, you can write sketches that are automatically stored in your Cloud sketchbook, and upload them to your Arduino board.
88

9-
The Cloud Editor includes:
10-
- access to all official board packages, as well as packages for popular third party boards (e.g. ESP32),
11-
- access to 5000+ libraries normally available in the offline IDE
12-
- built-in tools for verifying and uploading code to your board,
13-
- serial monitor tool for debugging your code,
14-
- reference to the Arduino programming language.
15-
16-
To use the Cloud Editor, you will only need to [install the Cloud Agent](), a plugin that allows your browser to access USB devices (your board). You will also need an [Arduino account]().
17-
18-
## Goals
19-
20-
In this guide, we will cover:
9+
The Cloud Editor features all the necessary tools to develop and test your Arduino projects, including:
10+
- A compiler that checks that your code works on the specified board,
11+
- an upload tool that uploads a sketch to your board,
12+
- the Serial Monitor, a tool that reads the serial commands send from your board,
13+
- all board packages & libraries available without download!
2114

22-
- How to create an account (required to use the Cloud Editor).
23-
- How to download and install the [Create Plugin](https://create.arduino.cc/getting-started/plugin/welcome).
24-
- The functions of the Cloud Editor,
25-
- How to write and upload a program to your Arduino board.
15+
***To use the Cloud Editor, you will need to [install the Cloud Agent](), a plugin that allows your browser to access USB devices (your board). You will also need an [Arduino account](). The steps are covered later on in this guide.***
2616

2717
## Hardware & Software Needed
2818

29-
- [Arduino Cloud Editor](https://create.arduino.cc/editor)
30-
- [Create Agent](https://create.arduino.cc/getting-started/plugin/welcome)
19+
- [Cloud Agent](https://create.arduino.cc/getting-started/plugin/welcome)
3120
- Arduino board (all Arduino boards are supported).
3221
- USB cable (different depending on the board you are using).
3322

34-
## Cloud Editor Overview
23+
## Setup
3524

36-
The Cloud Editor features all the necessary tools to develop and test your Arduino projects, including:
37-
- A compiler that checks that your code works on the specified board,
38-
- an upload tool that uploads a sketch to your board,
39-
- the Serial Monitor, a tool that reads the serial commands send from your board.
25+
1. First, log in or create an [Arduino account]().
26+
2. Then install the [Cloud Agent](https://create.arduino.cc/getting-started/plugin/welcome).
27+
3. After installing the Cloud Agent, navigate to the [Cloud Editor](https://app.arduino.cc/sketches/).
28+
4. Now connect an Arduino board to your computer. Once you connect it, it should show up in the editor.
29+
30+
![Connect board to computer.]()
31+
32+
5. Finally, let's upload a sketch to your board. Click on the **"Examples"** icon, and navigate to **01.Basics > Blink**. Clicking the example will open a new window.
33+
34+
![Select the example.]()
35+
36+
6. With the Blink example open, click on the **"Upload"** button. This will start the upload of the Blink sketch to your board. Do **not** disconnect the board during this process.
37+
38+
![Click on the "Upload" button.]()
4039

41-
In the image below, you can get a brief overview of the available functionalities.
40+
7. You can see if it was successful or not in the console log window at the bottom. Here's an example of a successful upload:
41+
42+
![Successful upload.]()
43+
44+
8. Congratulations, you have now successfully setup and used the Cloud Editor!
45+
46+
## Cloud Editor Overview
47+
48+
Now that we are all setup, let's take a look at the main components of the editor:
4249

4350
![Cloud Editor overview.](assets/editor-overview.png)
4451

45-
1. **Arduino Cloud Menu** - quicklinks to the Arduino Cloud platform.
46-
2. **Built-in Examples** - a set of basic Arduino examples.
47-
3. **Libraries** - all libraries that are included in the Arduino library manager (5000+).
52+
1. **Arduino Cloud Menu** - navigation menu for the Arduino Cloud platform.
53+
2. **Examples** - a set of basic Arduino examples.
54+
3. **[Libraries](#)** - all libraries that are included in the Arduino library manager (5000+).
4855
4. **Reference** - the Arduino Reference provides an overview of the available methods in the Arduino programming API.
4956
5. **Editor** - the code editor area, where we write the program for our board.
50-
6. **Verify/Upload** - verify (compile) your code using the checkmark button, and upload it to your board using the right arrow.
51-
7. ****
57+
6. **Console Log** - this window informs you of the status of your compilation / upload.
58+
7. **Verify/Upload** - verify (compile) your code using the checkmark button, and upload it to your board using the right arrow.
59+
8. **Board Selection** - the board connected to your computer will be automatically displayed here. You can also manually change this.
60+
9. **Serial Monitor** - a tool that reads serial data sent from your board to the computer.
5261

53-
## Setup
62+
## Serial Monitor
63+
64+
The Serial Monitor is a tool that allows you to read serial data from your board. This is useful for any general debugging cases, such as checking if a block of code is executed, or making sure the values you are using are accurate.
65+
66+
To use the tool, you will need a board connected to your computer that sends serial data. You can for example use the **Examples > 01.Basics > AnalogReadSerial** example to test it out.
67+
68+
When clicking the Serial Monitor button, a new window will open, where you will receive the data. See the image below for a complete overview of its functions:
69+
70+
![Serial Monitor.]()
71+
72+
1.
73+
74+
## Resources
75+
76+
The resources (examples, libraries & reference) are all available from the menu on the left hand side.
77+
78+
### Examples
79+
80+
The examples found
5481

55-
### Create an Account
82+
### Libraries
5683

57-
### Install the Plugin
84+
### Reference
5885

59-
### Upload a Sketch
86+
The reference is an embedded version of the [Arduino Language Reference]().

0 commit comments

Comments
 (0)
0