diff --git a/content/arduino-cloud/03.cloud-interface/00.sketches/assets/sketch.png b/content/arduino-cloud/03.cloud-interface/00.sketches/assets/sketch.png index af1159c5de..10fe81461b 100644 Binary files a/content/arduino-cloud/03.cloud-interface/00.sketches/assets/sketch.png and b/content/arduino-cloud/03.cloud-interface/00.sketches/assets/sketch.png differ diff --git a/content/arduino-cloud/03.cloud-interface/00.sketches/sketches.md b/content/arduino-cloud/03.cloud-interface/00.sketches/sketches.md index aa766a51d4..cff835ad56 100644 --- a/content/arduino-cloud/03.cloud-interface/00.sketches/sketches.md +++ b/content/arduino-cloud/03.cloud-interface/00.sketches/sketches.md @@ -8,23 +8,35 @@ author: Karl Söderby A sketch is a file where we write programs to run on our Arduino boards. Sketches have a `.ino` extension, which supports the Arduino programming language (a variant of C++). The Arduino Cloud has two categories of sketches: -- **Regular sketch** - a single `.ino` file where you write a program. These sketches can be used for **any** Arduino board. -- **IoT Sketch** - a set of files that are automatically generated when creating a [Thing](/arduino-cloud/cloud-interface/things). This includes an `.ino` file and two header (`.h`) files that contain your Thing configuration + credentials. Only available for boards with IoT support. +- **Sketch** - a single `.ino` file where you write a program. These sketches can be used for **any** Arduino board. +- **Sketch with attached Thing** - a set of files that are automatically generated when creating a [Thing](/arduino-cloud/cloud-interface/things). This includes an `.ino` file and two header (`.h`) files that contain your Thing configuration + credentials. Only available for boards with Arduino Cloud support. -In this document we will take a look at how to use sketches in the Arduino Cloud environment. +In this document, we will take a look at how to use sketches in the Arduino Cloud environment. ***If you need help getting started with programming your Arduino in the online environment, check out the [Cloud Editor](/arduino-cloud/guides/cloud-editor) tutorial.*** ## Access Your Sketches -You can access all your sketches at [app.arduino.cc/sketches](https://app.arduino.cc/sketches), where you can easily select between your regular sketches and IoT sketches. +You can access all your sketches at [app.arduino.cc/sketches](https://app.arduino.cc/sketches). Here you can easily see if your sketch has a Thing connected to it by checking if it has a light blue text box next to it. -![Sketches in the Arduino Cloud.](assets/sketch.png) +![Sketches in the Arduino Cloud](./assets/sketch.png) Clicking on each sketch will direct you to the [Cloud Editor](https://create.arduino.cc/editor/), which is an online version of the Arduino IDE. Here you can write a program, compile it and upload it to your board. ***To get started with the Cloud Editor, check out the [Cloud Editor](/arduino-cloud/guides/cloud-editor) tutorial.*** +### How to Create and Organize Folders + +You can easily organize your sketches by creating folders. Here’s how you can do it: + +**Create a New Folder**: Click on **Create**, then select **New Folder**. + +**Move Sketches into a Folder**: + +- **Drag and Drop**: Simply drag the sketch you want to move and drop it into the desired folder. + +- **Right-Click and Move**: Alternatively, click the three dots on the right, choose the option "Move to folder", and then select the folder you want to move it to. + ## Regular Sketches A regular sketch in the Arduino Cloud is exactly like a sketch used in the [Arduino IDE](/software/ide-v2), with no difference whatsoever. You can take a sketch from the online IDE and compile it in the offline IDE. @@ -45,11 +57,11 @@ If you are new to the Arduino environment, you can check out the [Language Refer For specific features of a board, make sure to check out the [hardware documentation](/). -## IoT Sketches +## Sketches with an attached Thing -IoT sketches are more complex and are generated automatically when you create a Thing and variables. +Sketches with an attached Thing are more complex and are generated automatically when you create a Thing and variables. -***Read more about this in the [Automatic Sketch Generation](/arduino-cloud/cloud-interface/sketches) documentation.*** +***Read more about [Things](/arduino-cloud/cloud-interface/things/).*** ### Sketch File @@ -122,7 +134,7 @@ The Remote Sketchbook feature is great as you can push/pull your sketches from t ***A very important note on Remote Sketchbook: when you push/pull a sketch, you will overwrite the existing sketch, similarly to how GitHub works, but without the option of retrieving your previous sketch.*** -## Recommended Code Practices (IoT Sketches) +## Recommended Code Practices (Sketches with an attached Thing) This section highlights some important aspects of writing code with regard to the implementations in the [ArduinoIoTCloud](https://github.com/arduino-libraries/ArduinoIoTCloud).