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
 

content/hardware/01.mkr/01.boards/mkr-wan-1310/tutorials/mkr-wan-library-examples/mkr-wan-library-examples.md

@@ -6,6 +6,7 @@ draft: true
 core: arduino:samd
 forumCategorySlug: '/hardware/mkr-boards/mkrwifi1010/147'
 certifications: [FCC,UKCA, IC, REACH, RED, RoHS, WEEE]
+productCode: '025'
 ---
 
 <SubTitle>The easiest entry point to basic IoT and pico-network application design.</SubTitle>

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

@@ -4,6 +4,7 @@ url_shop: https://store.arduino.cc/arduino-mkr-zero-i2s-bus-sd-for-sound-music-d
 url_guide: /software/ide-v1/installing-samd21-core
 core: arduino:samd
 forumCategorySlug: '/hardware/mkr-boards/mkrzero/140'
+productCode: '016'
 ---
 
 The Arduino MKR Zero is a development board for music makers! With an SD card holder and dedicated SPI interfaces (SPI1), you are able to play music files without extra hardware.

content/hardware/01.mkr/01.boards/mkr-zero/product.md

@@ -1,7 +1,7 @@
 ---
 title: MKR Connector Carrier
 url_shop: https://store.arduino.cc/arduino-mkr-connector-carrier
-url_guide: https://www.arduino.cc/en/Guide/MKRConnectorCarrier
+url_guide: /tutorials/mkr-connector-carrier/connector-basics
 ---
 
 The MKR Connector Carrier is a really useful extension for MKR family boards. It features 14 grove compatible connectors, which allows you to choose between hundreds of different sensors and actuators for your project.     

content/hardware/01.mkr/03.carriers/mkr-connector-carrier/product.md

@@ -4,6 +4,7 @@ url_shop: https://store.arduino.cc/arduino-due
 url_guide: /software/ide-v1/installing-sam-core
 core: arduino:sam
 forumCategorySlug: '/hardware/arduino-due/64'
+productCode: '009'
 ---
 
 The Arduino Due is the first Arduino board based on a 32-bit ARM core microcontroller. With 54 digital input/output pins, 12 analog inputs, 2 DAC and 2 CAN it is the perfect board for powerful larger scale Arduino projects.

content/hardware/02.hero/boards/due/product.md

@@ -3,6 +3,7 @@ title: Leonardo
 url_shop: https://store.arduino.cc/arduino-leonardo-with-headers
 url_guide: https://www.arduino.cc/en/Guide/ArduinoLeonardoMicro
 core: arduino:avr
+productCode: '008'
 ---
 
 The Leonardo differs from all preceding boards in that the ATmega32u4 has built-in USB communication, eliminating the need for a secondary processor. This allows the Leonardo to appear to a connected computer as a mouse and keyboard, in addition to a virtual (CDC) serial / COM port.

content/hardware/02.hero/boards/leonardo/product.md

@@ -3,6 +3,7 @@ title: Mega 2560 Rev3
 url_shop: https://store.arduino.cc/arduino-mega-2560-rev3
 url_guide: https://www.arduino.cc/en/Guide/ArduinoMega2560
 core: arduino:avr
+productCode: '002'
 ---
 
 The 8-bit board with 54 digital pins, 16 analog inputs, and 4 serial ports.

content/hardware/02.hero/boards/mega-2560/product.md

@@ -3,6 +3,7 @@ title: Micro
 url_shop: https://store.arduino.cc/arduino-micro
 url_guide: https://www.arduino.cc/en/Guide/ArduinoLeonardoMicro
 core: arduino:avr
+productCode: '006'
 ---
 
-The Micro runs on an ATmega32u4 processor with native USB communication. Configure via software whether the board is recognised as a standard Arduino, a mouse or keyboard. 
+The Micro runs on an ATmega32u4 processor with native USB communication. Configure via software whether the board is recognised as a standard Arduino, a mouse or keyboard.

content/hardware/02.hero/boards/micro/product.md

@@ -3,6 +3,7 @@ title: UNO Mini Limited Edition
 url_shop: https://store.arduino.cc/products/uno-mini-le
 url_guide: /tutorials/uno-mini/uno-mini-guide
 core: arduino:avr
+productCode: '117'
 ---
 
 The Arduino UNO Mini Limited Edition (LE) is a unique black & gold board, that pays tribute to everyones favorite maker board: [the Arduino UNO](https://store-usa.arduino.cc/products/arduino-uno-rev3). It is only 25% of the area size of the original UNO, comes with a USB-C connector and is delivered in a special case.

content/hardware/02.hero/boards/uno-mini-le/product.md

@@ -4,6 +4,7 @@ url_shop: https://store.arduino.cc/arduino-uno-rev3
 url_guide: https://www.arduino.cc/en/Guide/ArduinoUno
 core: arduino:avr
 certifications: [CE, FCC, GB4943, IC, RCM, REACH, RoHS, UKCA, WEEE]
+productCode: '001'
 ---
 
 The Arduino UNO is the best board to get started with electronics and coding. If this is your first experience tinkering with the platform, the UNO is the most robust board you can start playing with. The UNO is the most used and documented board of the whole Arduino family.

content/hardware/02.hero/boards/uno-rev3/product.md

@@ -3,6 +3,7 @@ title: UNO WiFi Rev2
 url_shop: https://store.arduino.cc/arduino-uno-wifi-rev2
 url_guide: /software/ide-v1/installing-megaavr-core
 core: arduino:megaavr
+productCode: '023'
 ---
 
 The Arduino UNO WiFi Rev 2 is the easiest point of entry to basic IoT with the standard form factor of the UNO family. Whether you are looking at building a sensor network connected to your office or home router, or if you want to create a Bluetooth® Low Energy device sending data to a cellphone, the Arduino UNO WiFi Rev 2 is your one-stop-solution for many of the basic IoT application scenarios.

content/hardware/02.hero/boards/uno-wifi-rev2/product.md

@@ -1,7 +1,7 @@
 ---
 title: Yún Rev2
-url_shop: https://store.arduino.cc/arduino-yun-rev-2
 core: arduino:avr
+status: end-of-life
 ---
 
-The Yún Rev2, Linux powered board with the Arduino simplicity, is the perfect board for your IoT projects!
+The Yún Rev2, Linux powered board with the Arduino simplicity, is the perfect board for your IoT projects!