Merge branch 'pre-launch/nano-matter' into taddy/nano-matter-product-page

Author: jcarolinares

content/arduino-cloud/02.hardware/00.cloud-agent/assets/board-connected.png

@@ -0,0 +1,33 @@
+---
+title: Cloud Agent
+description: The Cloud Agent allows Arduino boards to interface with the Arduino Cloud.
+tags: [Arduino Cloud, Cloud Agent, Cloud Editor]
+author: Karl Söderby
+---
+
+The [Arduino Cloud Agent](https://create.arduino.cc/getting-started/plugin/welcome) is a plugin that you install on your computer, that enables serial communication between your board and the Arduino Cloud. This allows you to upload sketches, and read/write serial data to/from your board, via your web browser.
+
+The Cloud Agent is a requirement to program your devices in the Arduino Cloud, and takes only a minute to install.
+
+## Installation
+
+When you configure a device or use the Cloud Editor, you will automatically receive a prompt to install the Cloud Agent. 
+
+You can also access the download page through [this link](https://create.arduino.cc/getting-started/plugin/welcome). It should look like this:
+
+![Download Cloud Agent.](assets/install-agent.png)
+
+Follow the installation guide in the page, where you will download an installation file. To install it, run the file and follow the instructions for your operating system.
+
+Once installed, you can navigate back to the Cloud Editor, and you should be able to recognize the board connected to your computer.
+
+![Board connected to computer.](assets/board-connected.png)
+
+## Source Code
+
+The source code for the Cloud Agent lives [in this GitHub repository](https://github.com/arduino/arduino-create-agent). To report issues or improvements, please do so inside in this repository.
+
+## Troubleshooting
+
+If you are having issues with the Cloud Agent, you can visit the link below:
+- [Arduino Help Center - Create Agent](https://support.arduino.cc/hc/en-us/articles/360014869820-Install-the-Arduino-Create-Agent)

content/arduino-cloud/02.hardware/00.cloud-agent/assets/install-agent.png

@@ -78,6 +78,8 @@ Templates can be imported easily by clicking on the import button from the templ
 
 Below the `Import Button`, you can find information on how many [Things](https://docs.arduino.cc/arduino-cloud/cloud-interface/things), [Variables](https://docs.arduino.cc/arduino-cloud/cloud-interface/variables) and [Dashboards](https://docs.arduino.cc/arduino-cloud/cloud-interface/dashboard-widgets) are associated with this template. The Arduino Cloud platform will handle the creation of these IoT components along with setting up the device and network for the selected template. 
 
+***Note: with a Free Plan a user can only have two Things at same time. When you already have two Things, you won't be able to click on IMPORT TEMPLATE. To avoid this you could choose to upgrade your Cloud plan or manually delete an existing Thing.***
+
 ![Template creation](assets/template-creation.png)
 
 This process involves creating the necessary components and uploading the sketch (program) to your device:

content/arduino-cloud/02.hardware/00.cloud-agent/cloud-agent.md

@@ -56,12 +56,12 @@ where Vin is 5V, R2 is 10k ohm and R1 is the photoresistor value that ranges fro
 
 Potentiometer
 
-![](assets/circuit-pot.png)
+![](assets/schematic-pot.png)
 
 
 Photoresistor
 
-![](assets/schematic-pot.png)
+![](assets/schematic.png)
 
 ### Code
 

content/arduino-cloud/09.business/09.arduino-cloud-for-business/content.md

@@ -115,6 +115,8 @@ Let's start by opening the Arduino IDE 2 and connecting our MKR WiFi 1010 board
 
 ![The board and port recognized by the Arduino IDE 2.](assets/ide_v2_t1_img05.png)
 
+Select **Tools > Programmer > Atmel-ICE** from the Arduino IDE menus.
+
 ### 2. Creating the Test Code
 
 Let's try the example code show below, it is a simple program that blinks the onboard LED of our board and changes the value of variables `x` and `y` while running. Open a new sketch, copy and paste the code show below:

content/arduino-cloud/10.education/02.templates/content.md

@@ -9,7 +9,7 @@ description: This tutorial teaches you how to set up a MKR board with the Segger
 This tutorial will show you how to debug an Arduino sketch using an Arduino MKR board and the Segger J-Link probe. It will go through how to connect these and use the Arduino IDE 2 to then debug a sketch.
 
 ### Required Hardware and Software
--   [Arduino IDE 2](https://www.arduino.cc/en/software)
+-   [Arduino IDE](https://www.arduino.cc/en/software) version 2.3.0 or higher
 -   Segger J-link device ([EDU](https://store.arduino.cc/products/j-link-edu) or [BASE](https://store.arduino.cc/products/j-link-base-compact))
 -   [Arduino MKR WiFi 1010](https://store.arduino.cc/mkr-wifi-1010) (other boards from the MKR family works as well).
 -   Soldering equipment
@@ -67,17 +67,26 @@ Now we are ready to start debugging our sketch. Connect the power to the MKR boa
 
 Then create or open the sketch that you want to debug. If you don't already have a sketch in mind, feel free to use the example sketch found at the end of this tutorial.
 
+Select **Tools > Programmer > Segger J-Link** from the Arduino IDE menus.
+
 Now go to the folder where the sketch is located. Add a `.json` file in the same folder as your sketch and name it `debug_custom.json`. The easiest way would be to create a text file and rename it `debug_custom.json`. In the `.json` file, add the following lines:
 
 ```arduino
-{
-  "servertype": "jlink",
-  "device": "ATSAMD21G18",
-  "interface": "SWD",
-  "serverpath": "C:/Program Files/SEGGER/JLink/JLinkGDBServerCL"
-}
+[
+  {
+    "configId": "arduino:samd:mkrwifi1010:programmer=jlink",
+    "server": "jlink",
+    "servertype": "jlink",
+    "device": "ATSAMD21G18",
+    "interface": "SWD",
+    "serverPath": "C:/Program Files/SEGGER/JLink/JLinkGDBServerCL",
+    "serverpath": "C:/Program Files/SEGGER/JLink/JLinkGDBServerCL"
+  }
+]
 ```
 
+If you are using a board other than the **MKR WiFi 1010**, you will need to adjust the `arduino:samd:mkrwifi1010` part of the `configId` field. Hover the mouse pointer over the board selection in the Arduino IDE toolbar in order to learn the correct identifier for the board you are using.
+
 The `"serverpath"` field needs to be set to the path of the "J-Link GDB Server CL" tool executable file that is located under the folder of the J-Link package you installed in the previous step. The file is named:
 
 - **If you are using Windows:** `JLinkGDBServerCL.exe`

content/built-in-examples/03.analog/AnalogInput/AnalogInput.md

@@ -22,7 +22,9 @@ For this this tutorial we will be using the Arduino Zero's built-in debugger int
 
 ***Important: You should connect the Arduino Zero through its programming USB port.***
 
-**2.** Select the board from the board/port list. When we select the Arduino Zero, the debugger icon close to the upload button will also become more visible.
+**2.** Select the board from the board/port list.
+
+**3.** Select **Tools > Programmer > Atmel EDBG**. The debugger icon close to the upload button will now become more visible.
 
 ![Debugger icon available if board is supported.](assets/icon-available.png)
 

content/hardware/01.mkr/01.boards/mkr-wifi-1010/tutorials/atmel-ice/using-an-atmel-ice-with-the-ide-v2.md

@@ -68,7 +68,7 @@ The Arduino Nano 33 BLE Sense Rev2 is a great choice for any beginner, maker or
   The HS3003 capacitive digital sensor measures relative humidity and temperature. It has a temperature accuracy of ± 0.2 °C and is thereby perfectly suited to detect ambient temperature.
 <FeatureWrapper>
   <FeatureLink variant="primary" title="Documentation" url="/tutorials/nano-33-ble-sense-rev2/humidity-and-temperature-sensor"/>
-  <FeatureLink variant="secondary" title="Library" url="https://github.com/arduino-libraries/Arduino_HS300x"/>
+  <FeatureLink variant="secondary" title="Library" url="https://reference.arduino.cc/reference/en/libraries/arduino_hs300x/"/>
 </FeatureWrapper>
 </Feature>
 

content/hardware/01.mkr/01.boards/mkr-wifi-1010/tutorials/mkr-jlink-setup/mkr-jlink.md

@@ -1,6 +1,6 @@
 Board:
   Name: Arduino® Portenta Breakout
-  SKU: AKX00031
+  SKU: ASX00031
 USB port: USBA
 Ethernet: RJ45 GBit
 Memory slot: Micro SD card
@@ -10,4 +10,4 @@ RTC power battery: CR2032
 Dimensions:
   Weight: 69 g
   Width: 72 mm
-  Length: 164 mm
+  Length: 164 mm

content/hardware/02.hero/boards/zero/tutorials/debugging-with-zero/debugging-with-zero.md

@@ -43,9 +43,9 @@ The system will send the temperature values from the Portenta Machine Control to
 ### Hardware Requirements
 
 - [Portenta Machine Control](https://store.arduino.cc/products/arduino-portenta-machine-control) (x1)
-- [Opta™ with RS-485](https://store.arduino.cc/collections/home-industrial-automation) (x1)
-- Micro-USB cable (x1)
-- USB-C® cable (x1)
+Opta™ PLC with RS-485 support: [Opta™ RS485](https://store.arduino.cc/products/opta-rs485), or [Opta™ WiFi](https://store.arduino.cc/products/opta-wifi) (x1)
+- [Micro-USB cable](https://store.arduino.cc/products/usb-cable-type-a-male-to-micro-type-b-male) (x1)
+- [USB-C® cable](https://store.arduino.cc/products/usb-cable2in1-type-c) (x1)
 - PT100 RTD (x1)
 
 ### Software Requirements

content/hardware/03.nano/boards/nano-33-ble-sense-rev2/features.md

@@ -1325,122 +1325,130 @@ Serial1.println("Hello world!");
 
 ### Bluetooth® Low Energy
 
-To enable Bluetooth® Low Energy communication on the Nicla Voice, you can use the [ArduinoBLE library](https://www.arduino.cc/reference/en/libraries/arduinoble/). The library works with the Nicla Voice with some minor modifications. 
-
-To get started with the ArduinoBLE library and the Nicla Voice, follow these steps:
-
-Include the `Nicla System` header:
-
-```arduino
-#include "Nicla_System.h" 
-```
-
-In the `setup()` function, call `nicla::begin()` to initialize the Nicla Voice board:
-
-```arduino
-void setup() {
-  nicla::begin();
-}
-```
+To enable Bluetooth® Low Energy communication on the Nicla Voice, you can use the [ArduinoBLE library](https://www.arduino.cc/reference/en/libraries/arduinoble/).
 
 Here is an example of how to use the ArduinoBLE library to create a voltage level monitor application:
 
 ```arduino
 #include "Nicla_System.h"
 #include <ArduinoBLE.h>
 
+
 // Define the voltage service and its characteristic
 BLEService voltageService("1101");
 BLEUnsignedCharCharacteristic voltageLevelChar("2101", BLERead | BLENotify);
 
+
 const int analogPin = A0;
 
+
 /**
-  Read voltage level from an analog input of the Nicla Voice,
-  then maps the voltage reading to a percentage value ranging from 0 to 100.
+ Read voltage level from an analog input of the Nicla Voice,
+ then maps the voltage reading to a percentage value ranging from 0 to 100.
+
 
-  @param none
-  @return the voltage level percentage (int).
+ @param none
+ @return the voltage level percentage (int).
 */
 int readVoltageLevel() {
-  int voltage = analogRead(analogPin);
-  int voltageLevel = map(voltage, 0, 1023, 0, 100);
-  return voltageLevel;
+ int voltage = analogRead(analogPin);
+ int voltageLevel = map(voltage, 0, 1023, 0, 100);
+ return voltageLevel;
 }
 
+
 void setup() {
-  // Initialize the Nicla system and the built-in RGB LED
-  nicla::begin();
-  nicla::leds.begin();
+ // Initialize the Nicla system and the built-in RGB LED
+ nicla::begin();
+ nicla::leds.begin();
 
-  Serial.begin(9600);
-  // Wait for the serial connection to be established
-  while (!Serial)
-    ;
 
-  // Initialize the BLE module
-  if (!BLE.begin()) {
-    Serial.println("starting BLE failed!");
-    while (1)
-      ;
-  }
+ Serial.begin(9600);
+ // Wait for the serial connection to be established
+ while (!Serial)
+   ;
 
-  // Set the local name and advertised service for the BLE module
-  BLE.setLocalName("VoltageMonitor");
-  BLE.setAdvertisedService(voltageService);
-  voltageService.addCharacteristic(voltageLevelChar);
-  BLE.addService(voltageService);
 
-  // Start advertising the BLE service
-  BLE.advertise();
-  Serial.println("- Bluetooth device active, waiting for connections...");
+ // Initialize the BLE module
+ if (!BLE.begin()) {
+   Serial.println("starting BLE failed!");
+   while (1)
+     ;
+ }
+
+
+ // Set the local name and advertised service for the BLE module
+ BLE.setLocalName("VoltageMonitor");
+ BLE.setAdvertisedService(voltageService);
+ voltageService.addCharacteristic(voltageLevelChar);
+ BLE.addService(voltageService);
+
+
+ // Start advertising the BLE service
+ BLE.advertise();
+ Serial.println("- Bluetooth device active, waiting for connections...");
 }
 
+
 void loop() {
-  // Check for incoming BLE connections
-  BLEDevice central = BLE.central();
+ // Check for incoming BLE connections
+ BLEDevice central = BLE.central();
 
-  // If a central device is connected
-  if (central) {
-    Serial.print("- Connected to central: ");
-    Serial.println(central.address());
 
-    // Set the LED color to red when connected
-    nicla::leds.setColor(red);
+ // If a central device is connected
+ if (central) {
+   Serial.print("- Connected to central: ");
+   Serial.println(central.address());
 
-    // While the central device is connected
-    while (central.connected()) {
-      // Read the voltage level and update the BLE characteristic with the level value
-      int voltageLevel = readVoltageLevel();
 
-      Serial.print("- Voltage level is: ");
-      Serial.println(voltageLevel);
-      voltageLevelChar.writeValue(voltageLevel);
+   // Turn off the LED when disconnected
+   nicla::leds.setColor(blue);
 
-      delay(200);
-    }
-  }
 
-  // Turn off the LED when disconnected
-  nicla::leds.setColor(off);
+   // While the central device is connected
+   while (central.connected()) {
+     // Read the voltage level and update the BLE characteristic with the level value
+     int voltageLevel = readVoltageLevel();
+
+
+     Serial.print("- Voltage level is: ");
+     Serial.println(voltageLevel);
+     voltageLevelChar.writeValue(voltageLevel);
 
-  Serial.print("- Disconnected from central: ");
-  Serial.println(central.address());
+
+     delay(200);
+   }
+ }
+
+
+ // Turn off the LED when disconnected
+ nicla::leds.setColor(red);
+
+
+ Serial.print("- Disconnected from central: ");
+ Serial.println(central.address());
 }
 ```
 
-The example code shown above creates a Bluetooth® Low Energy service and characteristic for transmitting a voltage value read by one of the analog pins of the Nicla Voice to a central device. 
+The example code shown above creates a Bluetooth® Low Energy service and characteristic for transmitting a voltage value read by the analog pin A0 of the Nicla Voice to a central device Bluetooth® device like a smartphone or another microcontroller.
 
-- The code begins by importing all the necessary libraries and defining the Bluetooth® Low Energy service and characteristic.
+- The code begins by importing all the necessary libraries and defining the Bluetooth® Low Energy service and characteristics.
 - In the `setup()` function, the code initializes the Nicla Voice board and sets up the Bluetooth® Low Energy service and characteristic; then, it begins advertising the defined Bluetooth® Low Energy service.
-- A Bluetooth® Low Energy connection is constantly verified in the `loop()` function; when a central device connects to the Nicla Voice, its built-in LED is turned on (red). The code then enters into a loop that constantly reads the voltage level from an analog input and maps it to a percentage value between 0 and 100. The voltage level is printed to the Serial Monitor and transmitted to the central device over the defined Bluetooth® Low Energy characteristic.
+- A Bluetooth® Low Energy connection is constantly verified in the `loop()` function, being the built-in LED in red while looking for a connection. When a central device connects to the Nicla Voice, its built-in LED will change its color to blue. The code then enters into a loop that constantly reads the voltage level from an analog input and maps it to a percentage value between 0 and 100. The voltage level is printed to the Serial Monitor and transmitted to the central device over the defined Bluetooth® Low Energy characteristic.
+
+You can use the [nRF Connect for Mobile](https://www.nordicsemi.com/Products/Development-tools/nrf-connect-for-mobile) app from Nordic Semiconductor to test the functionality of the example code shown below. nRF Connect is a powerful tool that allows you to scan and explore Bluetooth® Low Energy devices and communicate with them.
+
+
+![Bluetooth® Low Energy service and characteristic information from a Nicla Voice device](assets/user-manual-bt.png)
+
 
 ### ESLOV Connector 
 
 The Nicla Voice board features an onboard ESLOV connector meant as an **extension** of the I2C communication bus. This connector simplifies connecting various sensors, actuators, and other modules to the Nicla Voice without soldering or wiring.
 
 ![Nicla Voice built-in ESLOV connector](assets/user-manual-8.png)
 
+
  The ESLOV connector is a small 5-pin connector with a 1.00 mm pitch; the mechanical details of the connector can be found in the connector's datasheet.
 
 The pin layout of the ESLOV connector is the following:
@@ -1473,4 +1481,4 @@ Join our community forum to connect with other Nicla Voice users, share your exp
 
 Please get in touch with our support team if you need personalized assistance or have questions not covered by the help and support resources described before. We're happy to help you with any issues or inquiries about the Nicla Voice.
 
-- [Contact us page](https://www.arduino.cc/en/contact-us/) 
+- [Contact us page](https://www.arduino.cc/en/contact-us/) 

content/hardware/04.pro/carriers/portenta-breakout/tech-specs.yml

@@ -4,7 +4,7 @@ url_shop: https://store.arduino.cc/collections/pro-family
 url_guide: /tutorials/opta/user-manual
 primary_button_url: /tutorials/opta/user-manual
 primary_button_title:  User Manual
-secondary_button_url: /software/plc-ide/tutorials/plc-ide-setup-license
+secondary_button_url: /software/plc-ide/
 secondary_button_title: PLC IDE Guide
 core: arduino:mbed_opta
 certifications: [CE, UL, FCC, UKCA]

content/hardware/05.pro-solutions/solutions-and-kits/portenta-machine-control/tutorials/pmc-opta-temp-ctrl/content.md

@@ -21,12 +21,14 @@ software:
 
 This user manual will provide a comprehensive overview of Opta™, covering its major hardware and software elements. With this user manual, you will learn how to set up, configure, and use all the main features of an Opta™ device. 
 
+![ ](hero-banner.png)
+
 ## Hardware and Software Requirements
 
 ### Hardware Requirements
 
 - [Opta™ Lite](https://store.arduino.cc/products/opta-lite), [Opta™ RS485](https://store.arduino.cc/products/opta-rs485), or [Opta™ WiFi](https://store.arduino.cc/products/opta-wifi) (x1)
-- USB-C® cable (x1)
+- [USB-C® cable](https://store.arduino.cc/products/usb-cable2in1-type-c) (x1)
 - +12-24 VDC/0.5 A power supply (x1)
 
 ### Software Requirements