Merge branch 'main' into patch-1

Author: jhansson-ard

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/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
+}
+```