Merge pull request #410 from arduino/main

update

Author: BenjaminDannegard

content/arduino-cloud/01.getting-started/01.iot-cloud-getting-started/iot-cloud-getting-started.md

@@ -57,13 +57,12 @@ The following boards connect to the Arduino IoT Cloud via Wi-Fi.
 - [MKR WiFi 1010](https://store.arduino.cc/arduino-mkr-wifi-1010)
 - [Nano RP2040 Connect](https://store.arduino.cc/nano-rp2040-connect)
 - [Nano 33 IoT](https://store.arduino.cc/arduino-nano-33-iot)
+- [GIGA R1 WiFi](https://store.arduino.cc/products/giga-r1-wifi)
 - [Portenta H7](https://store.arduino.cc/portenta-h7)
 - [Portenta H7 Lite Connected](https://store.arduino.cc/products/portenta-h7-lite-connected)
 - [Portenta Machine Control](https://store.arduino.cc/products/arduino-portenta-machine-control)
 - [Nicla Vision](https://store.arduino.cc/products/nicla-vision)
-- [Opta](https://docs.arduino.cc/hardware/opta).\* 
-
-\* The Opta is scheduled to be released soon, along with documentation how to use it. Read more at the [Opta communications page](https://store.arduino.cc/pages/opta).
+- [Opta](https://docs.arduino.cc/hardware/opta).
 
 Connection via Wi-Fi is an easy alternative, and your credentials can safely be entered during the configuration of a project. This type of connection is most suitable for low-range projects, where you connect your board to the cloud via your home/work/school router.
 
@@ -103,9 +102,7 @@ The Arduino IoT Cloud supports a wide range of third party boards based on the E
 
 The Arduino IoT Cloud supports connection via Ethernet on a number of devices. The options to connect via Ethernet are the following:
 - Connect with the [Portenta H7](https://store.arduino.cc/products/portenta-h7) in combination with an Ethernet compatible carrier/shield (see below).
-- Connect with the [Opta](https://docs.arduino.cc/hardware/opta).\* 
-
-\* The Opta is scheduled to be released soon, along with documentation how to use it. Read more at the [Opta communications page](https://store.arduino.cc/pages/opta).
+- Connect with the [Opta](https://docs.arduino.cc/hardware/opta).
 
 To connect with the **Portenta H7** board, you will need one of the following shields/carriers:
 - [Portenta Vision Shield Ethernet](https://store.arduino.cc/products/arduino-portenta-vision-shield-ethernet)
@@ -147,7 +144,7 @@ The journey always begin by creating a new **Thing**. In the Thing overview, we
 
 ### 4. Configuring a Device
 
-Devices can easily be added and linked to a Thing. The Arduino IoT Cloud requires your computer to have the [Arduino Agent installed](https://create.arduino.cc/getting-started/plugin/welcome). The configuration process is quick and easy, and can be done by clicking on the **“Select device”** button in the Thing overview. Here, we can choose from any board that has been configured, or select the **“Configure new device”** option.
+Devices can easily be added and linked to a Thing. The Arduino IoT Cloud requires your computer to have the [Arduino Create Agent installed](https://create.arduino.cc/getting-started/plugin/welcome). The configuration process is quick and easy, and can be done by clicking on the **“Select device”** button in the Thing overview. Here, we can choose from any board that has been configured, or select the **“Configure new device”** option.
 
 ![Configuring a device.](assets/gs-device-attach.png)
 

content/arduino-cloud/01.getting-started/02.technical-reference/iot-cloud-tech-ref.md

@@ -25,6 +25,7 @@ The following boards connect to the Arduino IoT Cloud via Wi-Fi.
 - [MKR WiFi 1010](https://store.arduino.cc/arduino-mkr-wifi-1010)
 - [Nano RP2040 Connect](https://store.arduino.cc/nano-rp2040-connect)
 - [Nano 33 IoT](https://store.arduino.cc/arduino-nano-33-iot)
+- [GIGA R1 WiFi](https://store.arduino.cc/products/giga-r1-wifi)
 - [Portenta H7](https://store.arduino.cc/portenta-h7)
 - [Portenta H7 Lite Connected](https://store.arduino.cc/products/portenta-h7-lite-connected)
 - [Nicla Vision](https://store.arduino.cc/products/nicla-vision)

content/arduino-cloud/01.getting-started/04.api-overview/api-overview.md

@@ -2,51 +2,62 @@
 title: Arduino IoT Cloud APIs
 description: Arduino IoT Cloud has two different set of APIs. Read below to learn more
 author: Karl Söderby, Fabrizio Mirabito
-tags: [IoT Cloud, API, JavaScript]
+tags: [IoT Cloud, Device API, Application API, JavaScript]
 ---
+
 The [Arduino IoT Cloud](https://create.arduino.cc/iot/) has different sets of APIs that provide different functionalities. This article serves as an introduction to how to work and what you can achieve with them.
 
-## Configuration API
-### What you can achieve
-The main goal of Configuration API is to allow you to create and manage IoT resources like dashboards, devices, things, and variables, along with the retrieval and handling of historical data coming from your IoT Devices. The core of those APIs is organized around  [REST](http://en.wikipedia.org/wiki/Representational_State_Transfer). Our API has predictable resource-oriented URLs, accepts  [form-encoded](https://en.wikipedia.org/wiki/POST_(HTTP)#Use_for_submitting_web_forms)  request bodies, returns  [JSON-encoded](http://www.json.org/) responses, and uses standard HTTP response codes, authentication, and verbs. You can use those APIs, both directly calling our HTTP endpoints or using our clients that wrap those calls into easy-to-use abstractions like objects and functions. We have Applications API clients available in `javascript`, `golang`, and `python`.
+## Application API
+
+The main goal of the Application API is to allow you to create and manage IoT resources like dashboards, devices, things, and variables, along with the retrieval and handling of historical data coming from your IoT Devices. 
 
-To use the Configuration API, you need to create an **API Key** in the [API Keys](https://cloud.arduino.cc/home/api-keys) section.
+The core of those APIs is organized around  [REST](http://en.wikipedia.org/wiki/Representational_State_Transfer). Our API has predictable resource-oriented URLs, accepts  [form-encoded](https://en.wikipedia.org/wiki/POST_(HTTP)#Use_for_submitting_web_forms)  request bodies, returns  [JSON-encoded](http://www.json.org/) responses, and uses standard HTTP response codes, authentication, and verbs. 
 
-**Examples**
+You can use those APIs, both directly calling our HTTP endpoints or using our clients that wrap those calls into easy-to-use abstractions like objects and functions. We have Applications API clients available in `javascript`, `golang`, and `python`. To use the Application API, you need to create an **API Key** in the [API Keys](https://cloud.arduino.cc/home/api-keys) section.
 
+With this API, you can:
 - Build an automated script to create your things, in bulk
 - Duplicate the configuration of things, dashboards, devices
 - Create your own personal web application to manage your resources
 - Build a script that reads your variables' data and provides custom analytics 
 
-You can find the full list of available resources and actions in the [Arduino IoT Cloud Configuration API Technical Reference](https://www.arduino.cc/reference/en/iot/api/).
+### Resources
+
+You can find the full list of available resources and actions in the [Arduino IoT Cloud Application API Technical Reference](https://www.arduino.cc/reference/en/iot/api/).
+
+***For learning how to successfully authenticate and interface with this API, visit the [Arduino Cloud REST API & SDK](https://docs.arduino.cc/arduino-cloud/getting-started/arduino-iot-api) article. Examples using JavaScript, Python and Golang are available here.***
 
-## Data API
-Data API allows sending and receiving any kind of data (sensors' values, commands for actuators, configuration changes...) from and to IoT Devices and the Cloud. Under the hood, they
+## Device API
+
+The **Device API** allows sending and receiving any kind of data (sensors' values, commands for actuators, configuration changes...) from and to IoT Devices and the Cloud. Under the hood, they:
 
 - take care of the data exchange with our MQTT broker
 - handle best in class authentication & security 
 - manage compression, data format, and transport protocols
 
-### What you can achieve
+With this API, you can:
 - Send sensors' values to the cloud
 - Send and receive input and commands from and to dashboards
 - Listen for variables' values changes and act upon them
 
-Inside this set of API, we have:
+As a wrapper for the Device API, we have the following libraries:
 
 - An official Arduino IoT Cloud Library for your Arduino sketches: `ArduinoIoTCloud.h` 
 - An NPM Javascript package: `arduino-iot-js`  
 
-**Arduino IoT Cloud Sketch library**
-As described above, is the Arduino library that allows your Arduino devices to connect and exchange data with the IoT Cloud. If you edit your sketch directly inside IoT Cloud or Cloud Editor, you don't need to install it: it comes out of the box.
+### Arduino IoT Cloud Sketch library
+
+The Arduino (C++) library allows your Arduino devices to connect and exchange data with the IoT Cloud. If you use the Arduino Cloud online environment, you do not need to install this library.
+
+This library is also available in the library manager for [Arduino IDE](https://www.arduino.cc/en/software). With a paid subscription, you can push/pull changes to your online sketches in the offline editor.
 
 You can find more details at:
 
 - The [official repository](https://github.com/arduino-libraries/ArduinoIoTCloud)
 - The [cheat sheet](https://docs.arduino.cc/arduino-cloud/getting-started/technical-reference)
 
-**Arduino IoT JS**
+### Arduino IoT JS
+
 The `arduino-iot-js` NPM module is designed for communicating with the Arduino IoT Cloud broker using the MQTT over Websocket protocol. It is primarily used to send and receive variable values.
 
 Example:

content/arduino-cloud/01.getting-started/06.cloud-variables/cloud-variables.md

@@ -182,6 +182,19 @@ You can use them just like a normal variable of the wrapped type, since they sup
 
 The following variable types hold multiple values internally and are used to represent more complex data. In order to access such values, methods are provided.
 
+#### CloudSchedule
+
+`CloudSchedule` is used to check for an active state or to retrieve the timestamp.
+
+| Description            | Type   | Read value              |
+| ---------------------- | ------ | ----------------------- |
+| Check for active state | `bool` | `x.isActive()`          |
+| From (start date)      | `int`  | `x.getCloudValue().frm` |
+| To (end date)\*        | `int`  | `x.getCloudValue().to`  |
+| Length of Timestamp    | `int`  | `x.getCloudValue().len` |
+
+\*If no end date is selected, value is defaulted to `0`.
+
 #### DimmedLight
 
 Declared as `CloudDimmedLight x;`
@@ -195,24 +208,26 @@ Declared as `CloudDimmedLight x;`
 
 Declared as `CloudColoredLight x;`
 
-| Property   | Type            | Read value          | Set value           |
-| ---------- | --------------- | ------------------- | ------------------- |
-| Switch     | `bool`          | `x.getSwitch()`     | `x.setSwitch()`     |
-| Hue        | `float` (0-360) | `x.getHue()`        | `x.setHue()`        |
-| Saturation | `float` (0-100) | `x.getSaturation()` | `x.setSaturation()` |
-| Brightness | `float` (0-100) | `x.getBrightness()` | `x.setBrightness()` |
+| Property   | Type              | Read value          | Set value           |
+| ---------- | ----------------- | ------------------- | ------------------- |
+| Switch     | `bool`            | `x.getSwitch()`     | `x.setSwitch()`     |
+| Hue        | `float` (0-360)   | `x.getHue()`        | `x.setHue()`        |
+| Saturation | `float` (0-100)   | `x.getSaturation()` | `x.setSaturation()` |
+| Brightness | `float` (0-100)   | `x.getBrightness()` | `x.setBrightness()` |
+| Color      | `uint8_t` (0-255) | `x.getRGB(r,g,b)`   | `x.setRGB(r,g,b)`   |
 
 #### CloudColor
 
 Declared as `CloudColor x;`.
 
 To read the Color values, we can use the following method `Color colorValues = x.getValue();`. This will assign the hue, saturation, and brightness values to the `colorValues` variable.
 
-| Property   | Type    | Read value        | Set value                              |
-| ---------- | ------- | ----------------- | -------------------------------------- |
-| Hue        | `float` | `colorValues.hue` | `x = Color(hue,saturation,brightness)` |
-| Saturation | `float` | `colorValues.sat` | `x = Color(hue,saturation,brightness)` |
-| Brightness | `float` | `colorValues.bri` | `x = Color(hue,saturation,brightness)` |
+| Property   | Type              | Read value        | Set value                              |
+| ---------- | ----------------- | ----------------- | -------------------------------------- |
+| Hue        | `float` (0-360)   | `colorValues.hue` | `x = Color(hue,saturation,brightness)` |
+| Saturation | `float` (0-100)   | `colorValues.sat` | `x = Color(hue,saturation,brightness)` |
+| Brightness | `float` (0-100)   | `colorValues.bri` | `x = Color(hue,saturation,brightness)` |
+| Color      | `uint8_t` (0-255) | `x.getRGB(r,g,b)` | `x.set(r,g,b)`                         |
 
 To set the color, we can assign the CloudColor variable directly to float variables `x = {hue,saturation,brightness}`, or using the method ` x = Color(hue,saturation,brightness)`.
 

content/arduino-cloud/01.getting-started/06.dashboard-widgets/assets/widget-advanced-chart-2.png

@@ -318,9 +318,49 @@ The chart widget is great for data analytics. It is used to track real time data
 An example of how it is used in a sketch:
 
 ```arduino
-locationChart = analogRead(A0);
+variable = analogRead(A0);
 ```
 
+### Advanced Chart
+
+![Advanced Chart Widget](assets/widget-advanced-chart.gif)
+
+The advanced chart widget allows you to track up to **5 variables simultaneously**. This widget also includes an additional configuration interface that appears while editing the widget.
+
+![Widget Configuration](assets/widget-advanced-chart-2.png)
+
+An example of how it is used in code:
+
+```arduino
+variable_1 = analogRead(A1)
+variable_2 = analogRead(A2)
+variable_3 = analogRead(A3)
+variable_4 = analogRead(A4)
+variable_5 = analogRead(A5)
+```
+
+***Check out the [Advanced Chart](/arduino-cloud/features/advanced-chart) guide for more information.***
+
+### Scheduler
+
+![Scheduler Widget](assets/widget-scheduler.png)
+
+The Scheduler Widget allows you to schedule a job in the future. With this widget, you can schedule:
+- A job to activate at a specific hour, minute and second. 
+- A job to execute only on specific days.
+- A job that should last for X amount of seconds, minutes or hours.
+
+In a sketch, use the `x.isActive()` boolean to check whether a state is active. 
+
+Example:
+
+```arduino
+if(scheduleVariable.isActive){}
+```
+
+
+***Check out the [Scheduler](/arduino-cloud/features/cloud-scheduler) guide for more information.***
+
 ### Sticky Note
 
 ![Sticky Note](assets/widget-sticky-note.png)
@@ -329,3 +369,38 @@ The sticky note widget can be used to write important notes or to categorize you
 
 The sticky note can **not** be linked with a variable, and is designed to keep notes only while using a dashboard. It does support the use of markdown, so that you can create titles, links, code blocks etc.
 
+### Value Selector
+
+![Value Selector](assets/widget-value-picker.png)
+
+The value selector widget can be used to switch between predetermined values through available buttons. Supported variable types are `int` and `String`. 
+
+Example:
+
+```arduino
+if(valueSelector == 0){
+  //if value matches, execute code
+}
+
+if(valueSelector == "string"){
+  //if string matches, execute code
+}
+```
+
+### Value Dropdown
+
+![Value Dropdown](assets/widget-dropdown.png)
+
+The value dropdown widget works similarly to **value selector**, and is be used to switch between predetermined values through a dropdown menu. Supported variable types are `int` and `String`. 
+
+Example:
+
+```arduino
+if(valueDropDown == 0){
+  //if value matches, execute code
+}
+
+if(valueDropDown == "string"){
+  //if string matches, execute code
+}
+```

content/arduino-cloud/01.getting-started/06.dashboard-widgets/assets/widget-advanced-chart.gif

@@ -410,7 +410,7 @@ arduino-cloud-cli ota mass-upload --fqbn <deviceFQBN> --device-tags <key0>=<valu
 When uploading a sketch using OTA, you will need to compile the binary file (`.bin`) first. This is **not** a feature in the `arduino-cloud-cli`, so you will need to use the following options:
 
 - [Arduino CLI](https://arduino.github.io/arduino-cli/)
-- [Arduino IDE 1.8.x or 2.0](https://www.arduino.cc/en/software) 
+- [Arduino IDE](https://www.arduino.cc/en/software) 
 
 #### Compile with Arduino CLI