Merge branch 'main' into canchebagur/max-carrier-lora

Author: sebromero

content/built-in-examples/09.usb/KeyboardAndMouseControl/KeyboardAndMouseControl.md

@@ -12,7 +12,7 @@ tags:
 
 This example illustrates the use of the Mouse and Keyboard libraries together. Five momentary switches act as directional buttons for your cursor. When a button is pressed, the cursor on your screen will move, and a keypress, corresponding to the letter associated with the direction, will be sent to the computer. Once you have the Leonardo, Micro or Due programmed and wired up, open up your favorite text editor to see the results.
 
-**NB:  When you use the Mouse and Keyboard library functions, the Arduino takes over your computer's cursor! To insure you don't lose control of your computer while running a sketch with this function, make sure to set up a controller before you call Mouse.move().**
+**NB:  When you use the Mouse and Keyboard library functions, the Arduino takes over your computer's cursor! To ensure you don't lose control of your computer while running a sketch with this function, make sure to set up a controller before you call Mouse.move().**
 
 ### Hardware Required
 
@@ -57,4 +57,4 @@ You can find more basic tutorials in the [built-in examples](/built-in-examples)
 
 You can also explore the [language reference](https://www.arduino.cc/reference/en/), a detailed collection of the Arduino programming language.
 
-*Last revision 2015/07/29 by SM*
+*Last revision 2015/07/29 by SM*

content/built-in-examples/09.usb/KeyboardAndMouseControl/assets/schematic.png

@@ -7,12 +7,12 @@ software:
   - iot-cloud
 ---
 
-It is now possible to schedule jobs with the [Arduino IoT Cloud](https://create.arduino.cc/iot/), using the new `CloudSchedule` variable type. You can pick a start & end date for when the variable should be triggered, and for how long it should be active. This is done through the IoT Cloud dashboards.
+It is now possible to schedule jobs with the [Arduino IoT Cloud](https://create.arduino.cc/iot/), using the new `CloudSchedule` variable type. You can pick a start & end date for when the variable should be triggered, and for how long it should be active. This variable can be controlled in real time using a graphical widget that you can place on an IoT Cloud dashboard.
 
 We can for example have:
 
-- One trigger scheduled to go off every minute, and last for 10 seconds
-- One trigger scheduled to go off every hour, and last for 10 minutes.
+- One trigger scheduled to run every minute for 10 seconds
+- One trigger scheduled to run every hour for 10 minutes
 
 ## Goals
 
@@ -21,48 +21,18 @@ The goals of this project are:
 - Learn how the `CloudSchedule` variable works.
 - Learn how to access local time in your sketch.
 
-## Hardware & Software Needed
-
-For this tutorial, you will need a cloud compatible board. You can see the full list below:
-
-- [MKR 1000 WiFi](https://store.arduino.cc/arduino-mkr1000-wifi)
-- [MKR WiFi 1010](https://store.arduino.cc/arduino-mkr-wifi-1010)
-- [MKR GSM 1400](https://store.arduino.cc/arduino-mkr-gsm-1400)\*
-- [MKR NB 1500](https://store.arduino.cc/arduino-mkr-nb-1500-1413)\*
-- [Nano RP2040 Connect](https://store.arduino.cc/nano-rp2040-connect)
-- [Nano 33 IoT](https://store.arduino.cc/arduino-nano-33-iot)
-- [Portenta H7](https://store.arduino.cc/portenta-h7)
-
-***The MKR GSM 1400 & MKR NB 1500 requires a SIM card with a data plan to work. You can read more about it in [this page](https://store.arduino.cc/digital/sim).***
+Make sure you have a [cloud-compatible board](/cloud/iot-cloud/tutorials/technical-reference#compatible-hardware).
 
 ## How Does it Work?
 
-The working principle of the scheduler is pretty straight forward. The `CloudSchedule` variable can be configured to go off at a specific time, with a specific duration. In the code, you do not need to worry about any timers, as this is done in the Arduino IoT Cloud. The "jobs" are created in the dashboard, through a widget associated to the variable.
+A variable of `CloudSchedule` type can be configured to trigger at a specific time, with a specific duration. In the code, you do not need to worry about the logic for this. The configuration of the variable is done in the dashboard, through a widget associated to the variable.
 
-For example, we can set `schedule_variable` to be:
+For example, we can set such variable to be:
 - ON for 10 seconds, every minute.
 - ON for 8 hours, every day. 
 - ON for a week, and then finish.
 
-![Example of how a scheduler works.](assets/cloud-scheduler-img-01.png)
-
-## API
-
-The two **variables types** introduced in this tutorial are `CloudTime` and `CloudSchedule`. These are used to retrieve local time and to schedule a job respectively.
-
-The `CloudSchedule` variable is of a **complex type**. It has a **internal boolean state**, which can be checked through the `isActive()` function (returns `true` or `false`).
-
-```arduino
-if(schedule_variable.isActive()) {
-  //do something
-}
-```
-
-The `CloudTime` variable is an unsigned integer which is used to store current time. We can use the `getLocalTime()` function to retrieve local time.
-
-```arduino
-time_variable = ArduinoCloud.getLocalTime();
-```
+![Example of a schedule configured to run for 10 seconds every minute.](assets/cloud-scheduler-img-01.png)
 
 ## Application Examples
 
@@ -75,15 +45,12 @@ There are countless examples where schedulers can be used, but predominantly it
 To test out functionality of your scheduler job, we can turn on an LED while the job is active. 
 
 ```arduino
-// whenever the job is "active", turn on the LED
-if(schedule_variable.isActive()){
-digitalWrite(LED, HIGH);
-}
-
-
-// whenever the job is "not active", turn off the LED
-else{
-digitalWrite(LED, LOW);  
+if (schedule_variable.isActive()) {
+   // whenever the job is "active", turn on the LED
+   digitalWrite(LED, HIGH);
+} else {
+   // whenever the job is "not active", turn off the LED
+   digitalWrite(LED, LOW);  
 }
 ```
 
@@ -96,23 +63,22 @@ You can set up **multiple scheduler variables.** This way, you can have a differ
 - Change a string.
 
 ```arduino
-//scheduler 1 (write a high state to a pin)
-if(schedule_variable_1.isActive()){
-digitalWrite(3, HIGH);
-}
-else{
-digitalWrite(3, HIGH);
+// scheduler 1 (write a high state to a pin)
+if (schedule_variable_1.isActive()) {
+   digitalWrite(3, HIGH);
+} else {
+   digitalWrite(3, LOW);
 }
 
-//scheduler 2 (read a sensor)
-if(schedule_variable_2.isActive()){
-sensor_variable = analogRead(A1);
+// scheduler 2 (read a sensor)
+if(schedule_variable_2.isActive()) {
+   sensor_variable = analogRead(A1);
 }
 
-//scheduler 3 (change a string)
-if(schedule_variable_3.isActive()){
-string_variable = "";
-string_variable = "Update something here!";
+// scheduler 3 (change a string)
+if (schedule_variable_3.isActive()) {
+   string_variable = "";
+   string_variable = "Update something here!";
 }
 ```
 
@@ -122,14 +88,12 @@ string_variable = "Update something here!";
 Turning on and off light sources can be a great power saver for the office, home or vacation home. This can be achieved with a few lines of code and a [relay shield](https://store.arduino.cc/products/arduino-mkr-relay-proto-shield).
 
 ```arduino
-//can be configured to be ON between 8am - 5pm 
-if(schedule_variable.isActive()){
-digitalWrite(relay, HIGH);
-}
-
-//can be set to OFF between 5pm - 8am the next morning
-else{
-digitalWrite(relay, LOW);  
+if (schedule_variable.isActive()) {
+   // can be configured to be ON between 8am - 5pm 
+   digitalWrite(relay, HIGH);
+} else {
+   //can be set to OFF between 5pm - 8am the next morning
+   digitalWrite(relay, LOW);  
 }
 ```
 
@@ -140,25 +104,21 @@ digitalWrite(relay, LOW);
 For a "smart watering" setup, if you connect a pump through a relay, you can schedule a job to be on for a period of time (pumping water) and then turn off. This could for example occur for a few seconds every day to keep your plants alive.
 
 ```arduino
-//configure to be "on" for 10 seconds every day
-if(schedule_variable.isActive()){
-digitalWrite(pump, HIGH);
-}
-
-else{
-digitalWrite(pump, LOW);
+// configure to be "on" for 10 seconds every day
+if (schedule_variable.isActive()) {
+   digitalWrite(pump, HIGH);
+} else {
+   digitalWrite(pump, LOW);
 }
 ```
 
 Or, if you use a driver, such as **L298N**, you can control the pump through:
 
 ```arduino
-if(schedule_variable.isActive()){
-analogWrite(pump, 127); //range between 0-255
-}
-
-else{
-analogWrite(pump, 0);
+if (schedule_variable.isActive()) {
+   analogWrite(pump, 127); // range between 0-255
+} else {
+   analogWrite(pump, 0);
 }
 ```
 
@@ -171,6 +131,24 @@ In this section you will find a step by step tutorial that will guide you to cre
 - Create a basic sketch & upload it to the board.
 - Create a dashboard.
 
+### API
+
+The two **variables types** introduced in this tutorial are `CloudTime` and `CloudSchedule`. These are used to retrieve local time and to schedule a job respectively.
+
+The `CloudSchedule` variable is of a **complex type**. It has a **internal boolean state**, which can be checked through the `isActive()` function (returns `true` or `false`).
+
+```arduino
+if(schedule_variable.isActive()) {
+  //do something
+}
+```
+
+The `CloudTime` variable is an unsigned integer which is used to store current time. We can use the `getLocalTime()` function to retrieve local time.
+
+```arduino
+time_variable = ArduinoCloud.getLocalTime();
+```
+
 ### Create a Thing
 
 ***If you are new to the Arduino IoT Cloud, you can either visit the [Getting Started with Arduino IoT Cloud](https://docs.arduino.cc/cloud/iot-cloud/tutorials/iot-cloud-getting-started) guide, or any of the tutorials in the [Arduino IoT Cloud documentation](https://docs.arduino.cc/cloud/iot-cloud). There you will find detailed step by step guides.***

content/cloud/iot-cloud/tutorials/03.cloud-scheduler/cloud-scheduler.md

@@ -4,6 +4,8 @@ url_shop: https://store.arduino.cc/arduino-mkr1000-wifi
 url_guide: /software/ide-v1/installing-samd21-core
 core: arduino:samd
 forumCategorySlug: '/hardware/mkr-boards/mkr1000/137'
+status: end-of-life
+productCode: '017'
 ---
 
 The Arduino MKR 1000 WiFi is the easiest point of entry to basic IoT and pico-network application design. Whether you are looking at setting up a sensor network for your office or building a smart home, the MKR 1000 WiFi will make that journey easy.

content/hardware/01.mkr/01.boards/mkr-1000-wifi/product.md

@@ -3,6 +3,7 @@ title: MKR FOX 1200
 url_guide: /software/ide-v1/installing-samd21-core
 core: arduino:samd
 forumCategorySlug: '/mkr-boards/mkrfox1200/142'
+status: end-of-life
 ---
 
 The MKR FOX 1200 is your entry point to start working with the European Sigfox networks. The board can easily be added to the Sigfox infrastructure. It also features very low power consumption, and is designed to run on batteries for a longer period of time.

content/hardware/01.mkr/01.boards/mkr-fox-1200/product.md

@@ -3,6 +3,8 @@ title: MKR GSM 1400
 url_guide: /software/ide-v1/installing-samd21-core
 core: arduino:samd
 forumCategorySlug: '/hardware/mkr-boards/mkrgsm1400/146'
+status: end-of-life
+productCode: '021'
 ---
 
 The Arduino MKR GSM 1400 is a great starting point for building IoT projects connected to GSM / 3G network. Whether you are looking at building a sensor network for agricultural projects, or for urban data collection, the MKR GSM 1400 is your go-to board for IoT projects when Wi-Fi is not available.

content/hardware/01.mkr/01.boards/mkr-gsm-1400/product.md

@@ -5,6 +5,7 @@ url_guide: /software/ide-v1/installing-samd21-core
 core: arduino:samd
 forumCategorySlug: '/hardware/mkr-boards/mkrnb1500/156'
 certifications: [RCM]
+productCode: '022'
 ---
 
 The Arduino MKR NB 1500 adds Narrowband communication to your projects. It can communicate over NB-IoT and LTE-M networks, and is excellent to use for low-power projects in remote areas. The MKR NB 1500 is also compatible with the Arduino IoT Cloud, making it easy to access wherever you are in the world.

content/hardware/01.mkr/01.boards/mkr-nb-1500/product.md

@@ -4,6 +4,7 @@ url_shop: https://store.arduino.cc/arduino-mkr-vidor-4000
 url_guide: /software/ide-v1/installing-samd21-core
 core: arduino:samd
 forumCategorySlug: '/hardware/mkr-boards/mkrvidor4000/150'
+productCode: '024'
 ---
 
 The Arduino MKR VIDOR 4000 is without a doubt the most advanced and featured-packed board in the MKR family, and the only one with a FPGA chip on board. With a camera & HDMI connector, a Wi-Fi / Bluetooth® module and up to 25 configurable pins, the sky is really the limit with this board.

content/hardware/01.mkr/01.boards/mkr-vidor-4000/product.md

@@ -5,6 +5,7 @@ url_guide: /software/ide-v1/installing-samd21-core
 core: arduino:samd
 forumCategorySlug: '/hardware/mkr-boards/mkrwan1310/161'
 certifications: [FCC, REACH, CE, RoHS, IC, UKCA, WEEE, GB4943]
+productCode: '030'
 ---
 
 The Arduino MKR WAN 1310 provides a practical and cost effective solution to add LoRa® connectivity to projects requiring low power. This open source board can connect to the Arduino IoT Cloud, your own LoRa® network using the Arduino LoRa® PRO Gateway, existing LoRaWAN® infrastructure like The Things Network, or even other boards using the direct connectivity mode.

content/hardware/01.mkr/01.boards/mkr-wan-1310/product.md

@@ -5,7 +5,7 @@ tags: [LoRa, WAN]
 author: Arduino
 ---
 
-These examples will show you how to set up your board to use the LoRa network and how to send and receive data from the LoRa network.
+These examples will show you how to set up your board to use the LoRa® network and how to send and receive data from the LoRa® network.
 
 ## Hardware Required