Skip to content

[MKC-1607] Updated cloud editor mentions #2074

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 10 commits into from
Sep 11, 2024
Original file line number Diff line number Diff line change
Expand Up @@ -223,7 +223,7 @@ A common trick is to add a **`delay(1500);` command after `Serial.begin(9600);`*

## Create Agent

The [Arduino Create Agent](https://github.com/arduino/arduino-create-agent) is a single binary that will appear on the menu bar and work in the background. It allows you to use the Arduino Cloud and the Arduino Web Editor to seamlessly upload code to any board directly from the browser.
The [Arduino Create Agent](https://github.com/arduino/arduino-create-agent) is a single binary that will appear on the menu bar and work in the background. It allows you to use the Arduino Cloud and the Arduino Cloud Editor to seamlessly upload code to any board directly from the browser.

Downloading and installing the Arduino Create Agent plugin can be done following [this quick and easy process](https://create.arduino.cc/getting-started/plugin/welcome).

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,13 @@ description: 'Learn about different methods when embedding your sketches in a we
author: 'Karl Söderby'
---

The Web Editor is a great tool for creating and uploading programs while also collecting all of your sketches in one place. Another great feature is embedding them as iframes, such as articles, blogposts or journals.
The Cloud Editor is a great tool for creating and uploading programs while also collecting all of your sketches in one place. Another great feature is embedding them as iframes, such as articles, blogposts or journals.

To embed an iframe is very easy, and we just need to copy and paste a link from our sketch in the Web Editor. But we can also do a series of modifications to that iframe, and in this tutorial we will take a look at how to do that.
To embed an iframe is very easy, and we just need to copy and paste a link from our sketch in the Cloud Editor. But we can also do a series of modifications to that iframe, and in this tutorial we will take a look at how to do that.

## Let's start

First of all, we need to navigate to the [Web Editor](https://create.arduino.cc/editor). If we do not have an account, we can register one with just a few simple steps.
First of all, we need to navigate to the [Cloud Editor](https://create.arduino.cc/editor). If we do not have an account, we can register one with just a few simple steps.

Then, we need to have a code. In this tutorial, we are just going to use the good old **blink** example. When we have our sketch ready, click on the **share** button next to the port selection tool. This will open up a new window, that will have two fields: **link** and **iframe**. Copy the iframe field.

Expand Down Expand Up @@ -104,9 +104,9 @@ And then using the class `arduino-sketch-iframe` in your HTML element.

## Summary

There are several cool ways of working with iframes from the Web Editor, and it is a really easy process that requires very little coding.
There are several cool ways of working with iframes from the Cloud Editor, and it is a really easy process that requires very little coding.

The Web Editor helps you keep track on all of your sketches, and with the iframes, including your projects on other pages has never been easier.
The Cloud Editor helps you keep track on all of your sketches, and with the iframes, including your projects on other pages has never been easier.

### More tutorials

Expand Down
Original file line number Diff line number Diff line change
@@ -1,25 +1,25 @@
---
title: 'Importing files to the Web Editor'
description: 'Learn how to import your local sketchbook and custom libraries to the Web Editor.'
title: 'Importing files to the Cloud Editor'
description: 'Learn how to import your local sketchbook and custom libraries to the Cloud Editor.'
---

## Import Your Sketchbook and Libraries to the Web Editor
## Import Your Sketchbook and Libraries to the Cloud Editor

Are you sticking to the desktop Arduino IDE because all your work is saved locally? That’s no longer a problem! Our brand new import tool enables you to upload your entire sketchbook with just a few clicks on the [Arduino Web Editor](https://create.arduino.cc/editor). It is particularly handy because it lets you **move all your sketches and libraries to the Cloud** in a single flow.
Are you sticking to the desktop Arduino IDE because all your work is saved locally? That’s no longer a problem! Our brand new import tool enables you to upload your entire sketchbook with just a few clicks on the [Arduino Cloud Editor](https://create.arduino.cc/editor). It is particularly handy because it lets you **move all your sketches and libraries to the Cloud** in a single flow.

Once your sketchbook is online it will be available on any device and backed up.

![import_sketch_and_library_gif_1](assets/import_sketch_and_library_gif_1.gif)

What can you import to the [Web Editor](https://create.arduino.cc/editor)?
What can you import to the [Cloud Editor](https://create.arduino.cc/editor)?

* Single sketches in `.ino`, `.pde` and `.zip` format.

* Libraries in `.zip` format.

* Zipped folders containing sketches and libraries. Make sure your libraries are in a folder called `‘libraries’`. Be sure not to mix sketches and libraries in the same folder.

But let’s import your whole sketchbook in a few clicks, so you will be all set up to start using the Arduino Web Editor.
But let’s import your whole sketchbook in a few clicks, so you will be all set up to start using the Arduino Cloud Editor.


### 1. Find your sketchbook
Expand All @@ -36,7 +36,7 @@ Make a `.zip` pack of your sketchbook, you should obtain a file called *Arduino.

### 3. Import your sketchbook to the Cloud

Go to [create.arduino.cc/editor](https://create.arduino.cc/editor). For some general information on how to get started on the Web Editor see [this tutorial](https://create.arduino.cc/projecthub/Arduino_Genuino/getting-started-with-arduino-web-editor-4b3e4a?ref=platform&ref_id=424_trending___&offset=0). When you are logged in and ready, hit the import button on the sketchbook panel. A popup with some instructions on how to import files into the Web Editor will be displayed. Press `“Import”` to continue.
Go to [create.arduino.cc/editor](https://create.arduino.cc/editor). For some general information on how to get started on the Cloud Editor see [this tutorial](https://create.arduino.cc/projecthub/Arduino_Genuino/getting-started-with-arduino-web-editor-4b3e4a?ref=platform&ref_id=424_trending___&offset=0). When you are logged in and ready, hit the import button on the sketchbook panel. A popup with some instructions on how to import files into the Cloud Editor will be displayed. Press `“Import”` to continue.

![import_sketch_and_library_img_3](assets/import_sketch_and_library_img_3.jpg)
![import_sketch_and_library_img_4](assets/import_sketch_and_library_img_4.png)
Expand Down Expand Up @@ -78,7 +78,7 @@ If you want to import multiple custom libraries at once you can do so by creatin

![import_sketch_and_library_img_9](assets/import_sketch_and_library_img_9.jpg)

Please note that **all the libraries that you have added via the Library Manager on the desktop IDE will be already available on the Web Editor without having to do anything**. If you want to see their related examples or select a specific version, look for them on the online Library Manager.
Please note that **all the libraries that you have added via the Library Manager on the desktop IDE will be already available on the Cloud Editor without having to do anything**. If you want to see their related examples or select a specific version, look for them on the online Library Manager.

More info on the online Library Manager [on this tutorial](https://create.arduino.cc/projecthub/Arduino_Genuino/getting-started-with-arduino-web-editor-4b3e4a?ref=platform&ref_id=424_trending___&offset=0#toc-libraries-and-the-arduino-web-editor).

Expand Down
Original file line number Diff line number Diff line change
@@ -1,23 +1,23 @@
---
title: 'Share Your Sketches on the Arduino Web Editor'
title: 'Share Your Sketches on the Arduino Cloud Editor'
description: 'Learn about different methods you can use to share your Arduino sketches with others.'
---

## Share Your Sketches on the Arduino Web Editor
## Share Your Sketches on the Arduino Cloud Editor

The [Arduino Web Editor](https://create.arduino.cc/editor) is the online IDE developed by the Arduino team, this web app is part of the [Arduino Cloud platform](https://cloud.arduino.cc/home/). If you are new to it you can learn all about it on this [Getting Started tutorial](/arduino-cloud/getting-started/getting-started-web-editor).
The [Arduino Cloud Editor](https://create.arduino.cc/editor) is the online IDE developed by the Arduino team, this web app is part of the [Arduino Cloud platform](https://cloud.arduino.cc/home/). If you are new to it you can learn all about it on this [Getting Started tutorial](/arduino-cloud/getting-started/getting-started-web-editor).

The Arduino sketch is the unit that can include everything you need to bring an idea to life. With the **Share feature** of the Web Editor you can simply give someone access to your sketches just by sending them a URL, or by embedding the sketch into a webpage or in a Project Hub tutorial.
The Arduino sketch is the unit that can include everything you need to bring an idea to life. With the **Share feature** of the Cloud Editor you can simply give someone access to your sketches just by sending them a URL, or by embedding the sketch into a webpage or in a Project Hub tutorial.

When someone [shares a sketch with you](https://create.arduino.cc/editor/Arduino_Genuino/a5cf7fad-0802-49b6-81ce-2a5bf41bed5d/preview), you’ll have access both to the code, the layout for the electronics, and the full tutorial (when available). This will allow you to have all the necessary information to build on top of the original project, making it your own. Keep on reading and discover how to do it!

## How to Share Your Sketch

* If you don’t have one yet, create your brand new Arduino account [here](https://id.arduino.cc/auth/signup).

* Log in on Arduino the Web Editor [here](https://create.arduino.cc/editor/).
* Log in to Arduino Cloud Editor [here](https://create.arduino.cc/editor/).

* Once you are successfully logged in the Web Editor, hit the ‘New Sketch’ button and code on
* Once you are successfully logged in the Cloud Editor, hit the ‘New Sketch’ button and code on

* When done with writing your sketch, click the **‘Share’** button on the toolbar in the editor area. Press **'Copy Link'** and you can now share your Arduino code with the rest of the world!

Expand All @@ -34,22 +34,22 @@ Embed your sketch and share it on Project Hub is super easy! Simply create a new

![sharing_sketches_img_3](assets/sharing_sketches_img_3.jpg)

Once you are done with the Story and the previous fields go to the Software tab. In the ‘Code’ section, click on **‘Link to the Arduino Web Editor’** or **‘Link Existing Repository’**.
Once you are done with the Story and the previous fields go to the Software tab. In the ‘Code’ section, click on **‘Link to the Arduino Cloud Editor’** or **‘Link Existing Repository’**.

![sharing_sketches_img_4](assets/sharing_sketches_img_4.jpg)
![sharing_sketches_img_5](assets/sharing_sketches_img_5.jpg)

Give your sketch a title, add some comments and finally copy here the sketch public URL you got previously on the Web Editor. That’s it! Your sketch is now available here and it will always be up-to-date with your latest edits. It will look like this on your tutorial page:
Give your sketch a title, add some comments and finally copy here the sketch public URL you got previously on the Cloud Editor. That’s it! Your sketch is now available here and it will always be up-to-date with your latest edits. It will look like this on your tutorial page:

![sharing_sketches_img_6](assets/sharing_sketches_img_6.jpg)

### 2. Share Your Sketch via a Public URL

![sharing_sketches_img_7](assets/sharing_sketches_img_7.jpg)

In the [Arduino Web Editor](https://create.arduino.cc/editor) hit the **‘Share’** button, a popup window will be displayed. Click **‘Copy link’** to copy your sketch’s public URL on your clipboard. When you paste this URL in a new tab of your browser you will see a preview of your sketch. You won't even need to be logged in with an Arduino account, so anybody can access it.
In the [Arduino Cloud Editor](https://create.arduino.cc/editor) hit the **‘Share’** button, a popup window will be displayed. Click **‘Copy link’** to copy your sketch’s public URL on your clipboard. When you paste this URL in a new tab of your browser you will see a preview of your sketch. You won't even need to be logged in with an Arduino account, so anybody can access it.

The people you shared you sketch with can now download it or add it to their sketchbook (after having signed up to the Arduino Web Editor of course). If you have embedded [your sketch](https://create.arduino.cc/editor/Arduino_Genuino/a5cf7fad-0802-49b6-81ce-2a5bf41bed5d/preview) in a Project Hub tutorial you will see the ‘Open Tutorial’ button displayed to this page as well.
The people you shared you sketch with can now download it or add it to their sketchbook (after having signed up to the Arduino Cloud Editor of course). If you have embedded [your sketch](https://create.arduino.cc/editor/Arduino_Genuino/a5cf7fad-0802-49b6-81ce-2a5bf41bed5d/preview) in a Project Hub tutorial you will see the ‘Open Tutorial’ button displayed to this page as well.

When you share a sketch with all these supporting contents (layout, schematics, tutorial...) with a friend, a colleague or in your classroom, they will have everything needed to build up from your idea and make it their own!

Expand All @@ -63,7 +63,7 @@ In the same Share popup window you can also copy your project’s related iFrame

## Always Up-To-Date!

Now your code is ready to be shared across a variety of platforms! Do you know what’s cool about this feature? Now that your sketch is on the Cloud (literally!) once edited on the Web Editor, it will be also updated across all the places where you have embedded it!
Now your code is ready to be shared across a variety of platforms! Do you know what’s cool about this feature? Now that your sketch is on the Cloud (literally!) once edited on the Cloud Editor, it will be also updated across all the places where you have embedded it!

### More tutorials

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ In order to configure the feature, we will need to create a project in the Ardui

![Navigating to the Cloud.](assets/iot_cloud_grid.png)

> **Note:** You will need to have an Arduino account to be able to use both the Web editor and Arduino Cloud features.
> **Note:** You will need to have an Arduino account to be able to use both the Cloud editor and Arduino Cloud features.


**2.** Once you are logged in the Arduino Cloud, you need to create a new thing and name it something, for this example let's call it “smart_led”.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -123,12 +123,12 @@ PII data will only be stored as long as Arduino legitimately needs it and in acc

## Arduino Cloud Applications and Tools

### Arduino Web Editor
### Arduino Cloud Editor

The Arduino Web Editor allows customers to create sketches they can subsequently deploy on boards. Each customer has a separate area where their sketches are stored so that no other customer has access to them. Sketches can be made publicly available to everyone, in which case access is granted by whomever possesses the link to access them.
The Arduino Cloud Editor allows customers to create sketches they can subsequently deploy on boards. Each customer has a separate area where their sketches are stored so that no other customer has access to them. Sketches can be made publicly available to everyone, in which case access is granted by whomever possesses the link to access them.

The Arduino Web Editor also provides a secret tab that can be used to securely store sensitive information needed by the device (e.g. Wi-Fi® credentials, API credentials). Secrets in this tab are encrypted with the AES-256 algorithm to safely store them in the Cloud.
In order to communicate with the Arduino Web Editor, web browsers should be able to communicate over the internet to port 80, 443 and 8080 towards Arduino’s subdomains \*.arduino.cc.
The Arduino Cloud Editor also provides a secret tab that can be used to securely store sensitive information needed by the device (e.g. Wi-Fi® credentials, API credentials). Secrets in this tab are encrypted with the AES-256 algorithm to safely store them in the Cloud.
In order to communicate with the Arduino Cloud Editor, web browsers should be able to communicate over the internet to port 80, 443 and 8080 towards Arduino’s subdomains \*.arduino.cc.

### Arduino Cloud

Expand All @@ -140,7 +140,7 @@ The Arduino Cloud CLI provides a way for interacting with the Arduino Cloud via

### Arduino Create Agent

The Arduino Create Agent fills the gap between your browser and your boards and allows users to deploy their sketches on their board using the Arduino Web Editor. The Arduino Create Agent runs a web server bound to localhost that receives requests from the Arduino Web Editor to operate on the boards. The security of such communication is ensured by cryptographic signature of the commands that are sent to the Arduino Create Agent. Whenever the Arduino Web Editor wants to send a command to the Arduino Create Agent, it cryptographically signs the command and appends the signature to the request sent to the agent. The agent verifies the signature and, if it is correct, accepts and executes the command.
The Arduino Create Agent fills the gap between your browser and your boards and allows users to deploy their sketches on their board using the Arduino Cloud Editor. The Arduino Create Agent runs a web server bound to localhost that receives requests from the Arduino Cloud Editor to operate on the boards. The security of such communication is ensured by cryptographic signature of the commands that are sent to the Arduino Create Agent. Whenever the Arduino Cloud Editor wants to send a command to the Arduino Create Agent, it cryptographically signs the command and appends the signature to the request sent to the agent. The agent verifies the signature and, if it is correct, accepts and executes the command.

For usage with certain browsers, specifically with Safari on macOS, the Arduino Create Agent needs to run the web server using a TLS connection. A local Certificate Authority (CA) is generated and used to sign a certificate for the localhost domain. The private key of the CA is erased once the certificate for localhost is signed, while the public certificate of the CA is installed in the local system. The web server of the Arduino Create Agent will then run with a TLS connection. This is done to obey the mixed content specification implemented in Safari which is enforced also for resources loaded from localhost.

Expand Down
Loading
Loading