Merge branch 'main' into Rework-Nano-RP2040-Connect-not-being-detected-on-USB-port-

Author: gorillagripcore

.lycheeignore

@@ -41,7 +41,9 @@ https://www.ups.com/it/en/support/contact-us.page
 https://www.dhl.com/us-en/home/customer-service.html
 https://www.dhl.com/us-en/home/ecommerce/shipping-services/international-shipping-services.html
 https://www.tindie.com/products/ataradov/cmsis-dap-compliant-swd-debugger/
+https://www.arduino.cc/reference/en/libraries/arduino_bmi270_bmm150/
 
 # Too many redirects
 
 https://shopify.com/43847352471/account/orders
+https://www.nongnu.org/avr-libc/user-manual/FAQ.html#faq_cplusplus

content/Arduino Cloud/Arduino IoT Cloud/Add-and-connect-a-device-to-Arduino-Cloud.md

@@ -11,7 +11,7 @@ Connecting a new device to Arduino Cloud consists of three steps:
 2. [Configure the device as a Thing](#create-thing). This will generate a sketch that can be uploaded to the device, allowing it to connect to Arduino Cloud.
 3. [Upload the sketch to the device](#upload-sketch). Upload the Thing sketch to the device.
 
-You'll need an Arduino account and the [Arduino Create Agent](https://support.arduino.cc/hc/en-us/articles/360014869820) installed and running on your computer.
+You'll need an Arduino account and the [Arduino Cloud Agent](https://support.arduino.cc/hc/en-us/articles/360014869820) installed and running on your computer.
 
 ---
 

content/Arduino Cloud/Arduino IoT Cloud/If-your-device-cant-be-added-to-Arduino-Cloud.md

@@ -29,10 +29,10 @@ Secret keys cannot be recovered if lost. Make sure to save any Device ID and Sec
 
 1. Make sure you're using a [compatible device](https://support.arduino.cc/hc/en-us/articles/360016077320-What-devices-can-be-used-with-Arduino-IoT-Cloud-).
 
-2. [Check if the Arduino Create Agent is installed and running](https://support.arduino.cc/hc/en-us/articles/4980687506844-Check-if-the-Arduino-Create-Agent-is-installed-and-running), then click **Try again**.
+2. [Check if the Arduino Cloud Agent is installed and running](https://support.arduino.cc/hc/en-us/articles/4980687506844), then click **Try again**.
 
    > [!NOTE]
-   > If you're using a **Chromebook** and [Arduino Cloud for Chromebook](https://support.arduino.cc/hc/en-us/articles/360016495639-Use-Arduino-with-Chromebook), there's no need to install the Arduino Create Agent.
+   > If you're using a **Chromebook** and [Arduino Cloud for Chromebook](https://support.arduino.cc/hc/en-us/articles/360016495639-Use-Arduino-with-Chromebook), there's no need to install the Arduino Cloud Agent.
 
 3. Double-press the reset button on the board to put the board in [bootloader mode](https://support.arduino.cc/hc/en-us/articles/5779192727068-Reset-your-board#bootloader-mode), then click **Try Again**.
 
@@ -46,7 +46,7 @@ Secret keys cannot be recovered if lost. Make sure to save any Device ID and Sec
 
 1. Close any instances of Arduino IDE and other applications that may be using the port.
 
-2. [Check if the Arduino Create Agent is installed and running](https://support.arduino.cc/hc/en-us/articles/4980687506844-Check-if-the-Arduino-Create-Agent-is-installed-and-running). If you're using [Arduino Cloud for Chromebook](https://support.arduino.cc/hc/en-us/articles/360016495639-Use-Arduino-with-Chromebook), you can skip this step.
+2. [Check if the Arduino Cloud Agent is installed and running](https://support.arduino.cc/hc/en-us/articles/4980687506844). If you're using [Arduino Cloud for Chromebook](https://support.arduino.cc/hc/en-us/articles/360016495639-Use-Arduino-with-Chromebook), you can skip this step.
 
 3. Reconnect the device to the computer and make sure the power LED lights up.
 
@@ -66,13 +66,13 @@ Solve the issue by updating to the latest firmware version using the **Firmware
 
 <a class="link-chevron-right" href="https://support.arduino.cc/hc/en-us/articles/360013896579-Use-the-Firmware-Updater-in-Arduino-IDE">Update the firmware in Arduino IDE</a>
 
-### "Arduino Create Agent not found"
+### "Arduino Cloud Agent not found"
 
 > [!NOTE]
 > If you're using a **Chromebook** and [Arduino Cloud for Chromebook](https://support.arduino.cc/hc/en-us/articles/360016495639-Use-Arduino-with-Chromebook), you can skip this step.
 
 1. If you haven't done so already, [install the agent](https://create.arduino.cc/getting-started/plugin/welcome).
-2. If you have installed the agent but still encounter this warning, see [If Arduino Create Agent isn't detected](https://support.arduino.cc/hc/en-us/articles/360016466600-Warning-To-upload-a-sketch-via-USB-port-make-sure-the-Agent-is-installed-and-running-on-this-computer).
+2. If you have installed the agent but still encounter this warning, see [If Arduino Cloud Agent isn't detected](https://support.arduino.cc/hc/en-us/articles/360016466600-Warning-To-upload-a-sketch-via-USB-port-make-sure-the-Agent-is-installed-and-running-on-this-computer).
 
 ---
 

content/Arduino Cloud/Cloud Editor/Boards-compatible-with-the-Cloud-Editor.md

@@ -35,7 +35,7 @@ These boards are supported:
 
 ## Cloud Editor on Windows, macOS, and Linux
 
-To use the Cloud Editor on Windows, macOS, and Linux, you need to install the <a class="link-up-right" href="https://create.arduino.cc/getting-started/plugin/welcome">Arduino Create Agent</a>.
+To use the Cloud Editor on Windows, macOS, and Linux, you need to install the <a class="link-up-right" href="https://create.arduino.cc/getting-started/plugin/welcome">Arduino Cloud Agent</a>.
 
 These boards are supported:
 

content/Arduino Cloud/Cloud Editor/If-the-Arduino-Cloud-Agent-isnt-detected.md

@@ -0,0 +1,32 @@
+---
+title: "If the Arduino Cloud Agent isn't detected"
+id: 360016466600
+---
+
+Learn what to do if the Arduino Cloud Agent isn't detected by the [Arduino Cloud](https://cloud.arduino.cc/).
+
+If you haven't done so, [install the Arduino Cloud Agent](https://create.arduino.cc/getting-started/plugin/welcome). If you still encounter one of the warnings bellow, follow the [troubleshooting steps](#troubleshooting).
+
+* `Arduino Cloud Agent not found`
+* `To upload a sketch via USB port, make sure the Agent is installed and running on this computer`
+
+---
+
+<a id="troubleshooting"></a>
+
+## Troubleshooting
+
+1. Check if the [Arduino Cloud Agent is running](https://support.arduino.cc/hc/en-us/articles/4980687506844), since sometimes it may be **off** or **paused**.
+
+2. If you are using [Brave Browser](https://brave.com/), see [Use Arduino Cloud with Brave Browser](https://support.arduino.cc/hc/en-us/articles/10482021304988-Use-Arduino-Cloud-with-Brave-Browser).
+
+3. **If you're using Safari on macOS:** Check if the HTTPS certificate for Safari has been installed:
+    1. Open the Arduino Cloud Agent menu (Look for the ![Arduino Cloud Agent icon](img/cloud-agent-logo-mac.png) icon in the top-right of the menu bar of macOS).
+    2. Click on the **Manage HTTPS certificate** menu and make sure that the certificate is installed and trusted.  
+       If it’s not, you can click on the button "Install the certificate for Safari".
+    3. Enter the administrative credentials, if prompted.
+    4. Refresh the Safari browser window.
+
+4. If you're using the [Cloud Agent on a Mac computer with an Apple Silicon processor](https://github.com/arduino/arduino-create-agent#apple-m1-support) (e.g. Apple M1 chip), make sure to [install Rosetta 2](https://support.apple.com/en-us/HT211861).
+
+If you are still having issues, [uninstall the Arduino Cloud Agent](https://support.arduino.cc/hc/en-us/articles/360014869840) and [reinstall it](https://create.arduino.cc/getting-started/plugin/welcome).

content/Arduino Cloud/Cloud Editor/If-the-Arduino-Create-Agent-isnt-detected.md

@@ -0,0 +1,126 @@
+---
+title: "If you see an error when performing an Over-the-Air (OTA) upload"
+id: 15122161765916
+---
+
+Learn how to resolve errors when uploading Over-the-Air (OTA) in the Cloud Editor.
+
+Before you proceed, rule out other types of errors:
+
+* If the message on the console panel bar says **"Error Verifying \<Sketch name\>"**, it means that the sketch could not be successfully compiled. See [If your sketch doesn't compile](https://support.arduino.cc/hc/en-us/articles/4402764401554-If-your-sketch-doesn-t-compile) instead.
+* An Over-the-Air upload will only be attempted if the ![OTA symbol](img/symbol_ota.png) OTA icon is visible to the right of the Upload button. If USB upload is also available, make sure that the OTA option is selected.
+
+In this article:
+
+* [Identifying the OTA error message](#identify-error)
+* [Error reference for OTA uploads](#errors)
+
+---
+
+## Identifying the OTA error message {#identify-error}
+
+When an Over-the-Air upload fails, you can find the error in the console output.
+
+Follow these steps:
+
+1. Find the console panel. If it is hidden, show it by clicking the button in the bottom-right corner.
+2. Find the line that starts with "SHA256" or "Board error".
+3. Find the instructions for that error in the [error reference](#errors).
+
+<img src="img/ota-error-sha.png" width=800px/>
+
+---
+
+## Error reference for OTA uploads {#errors}
+
+In this section:
+
+* [Board error - errorwriteupdatefilefail](#errorwriteupdatefilefail)
+* [Board error - httpresponsefail](#httpresponsefail)
+* [Board error - otadownloadfail](#otadownloadfail)
+* [Board error - otaheadercrcfail](#otaheadercrcfail)
+* [Board error - otastorageinitfail](#otastorageinitfail)
+* [Board error - serverconnecterrorfail](#serverconnecterrorfail)
+* [SHA256 mismatch - Unable to apply the new firmware. Previous firmware detected after restart](#sha256mismatch)
+* [SHA256 Unknown - Unknown Firmware detected after restart.](#sha256unknown)
+
+### Board error - errorwriteupdatefilefail {#errorwriteupdatefilefail}
+
+This error indicates that the device's memory partition table is improperly formatted.
+
+* If you're using **Arduino GIGA R1 WiFi** or **Portenta H7**:
+  1. Reinitialize the storage with this Sketch: [QSPIFormat.ino](https://github.com/arduino/ArduinoCore-mbed/blob/main/libraries/STM32H747_System/examples/QSPIFormat/QSPIFormat.ino)
+  1. Reinstall the SSL certificates with this Sketch: [WiFiFirmwareUpdater](https://github.com/arduino/ArduinoCore-mbed/tree/main/libraries/STM32H747_System/examples/WiFiFirmwareUpdater)
+
+* If you're using **Arduino Opta**: Follow [these instructions](https://docs.arduino.cc/tutorials/opta/memory-partitioning/#partitioning-the-memory-of-an-opta).
+* If you're using  **Portenta Machine Control**: Follow these [instructions](https://docs.arduino.cc/tutorials/opta/memory-partitioning/#partitioning-the-memory-of-a-portenta-machine-control).
+
+> [!TIP]
+> If you're using GIGA R1 WiFi, see [Configure GIGA R1 WiFi for Over-The-Air (OTA) uploads](https://support.arduino.cc/hc/en-us/articles/12370721200540-Configure-GIGA-R1-WiFi-for-Over-The-Air-OTA-uploads).
+
+### Board error - httpresponsefail {#httpresponsefail}
+
+This error can occur if the OTA update fails during the firmware download.
+
+Follow these steps:
+
+1. Ensure that the board has a stable connection to Arduino Cloud.
+1. Avoid extensive calls to the `delay()` function or other blocking code inside the `loop()` function of your sketch.
+
+### Board error - otadownloadfail {#otadownloadfail}
+
+This error can occur if the OTA update fails during the firmware download.
+
+Follow these steps:
+
+1. Ensure that the board has a stable connection to Arduino Cloud.
+1. Avoid extensive calls to the `delay()` function or other blocking code inside the `loop()` function of your sketch.
+
+### Board error - otaheadercrcfail {#otaheadercrcfail}
+
+The header of the downloaded file does not match the expected one, likely indicating that the file was corrupted during the download.
+
+Follow these steps:
+
+1. Try to upload the sketch again.
+
+### Board error - otastorageinitfail {#otastorageinitfail}
+
+This error indicates that the device's memory partition table is improperly formatted.
+
+* If you're using **Arduino GIGA R1 WiFi** or **Portenta H7**:
+  1. Reinitialize the storage with this Sketch: [QSPIFormat.ino](https://github.com/arduino/ArduinoCore-mbed/blob/main/libraries/STM32H747_System/examples/QSPIFormat/QSPIFormat.ino)
+  1. Reinstall the SSL certificates with this Sketch: [WiFiFirmwareUpdater](https://github.com/arduino/ArduinoCore-mbed/tree/main/libraries/STM32H747_System/examples/WiFiFirmwareUpdater)
+
+* If you're using **Arduino Opta**: Follow [these instructions](https://docs.arduino.cc/tutorials/opta/memory-partitioning/#partitioning-the-memory-of-an-opta).
+* If you're using  **Portenta Machine Control**: Follow these [instructions](https://docs.arduino.cc/tutorials/opta/memory-partitioning/#partitioning-the-memory-of-a-portenta-machine-control).
+
+> [!TIP]
+> If you're using GIGA R1 WiFi, see [Configure GIGA R1 WiFi for Over-The-Air (OTA) uploads](https://support.arduino.cc/hc/en-us/articles/12370721200540-Configure-GIGA-R1-WiFi-for-Over-The-Air-OTA-uploads).
+
+### Board error - serverconnecterrorfail {#serverconnecterrorfail}
+
+This error occurs when the device fails to connect to the firmware download endpoint.
+
+Follow these steps:
+
+1. Ensure that the board has a stable connection to Arduino Cloud.
+
+### SHA256 mismatch - Unable to apply the new firmware. Previous firmware detected after restart {#sha256mismatch}
+
+This error means that the device restarted with a SHA (fw identifier) that is different from the target one and the SHA is equal to the one installed when the OTA process is started. This usually happens when the device restarts during the OTA process.
+
+Follow these steps:
+
+1. Check if the sketch running on the device is unstable and causes frequent restarts.
+
+### SHA256 Unknown - Unknown Firmware detected after restart. {#sha256unknown}
+
+This error indicates that the device restarted with a new SHA (firmware identifier), which differs from both the target firmware and the original firmware. This suggests that another firmware was flashed on the device via a different method, such as USB, during the OTA update process.
+
+Follow these steps:
+
+1. Ensure there is no external device that is programming the board.
+1. Repeat the upload process.
+
+<!-- markdownlint-disable-file HC001 -->

content/Arduino Cloud/Cloud Editor/If-you-see-an-error-when-performing-an-Over-the-Air-OTA-upload.md

@@ -22,10 +22,10 @@ Learn how to troubleshoot possible issues when connecting a board to the Cloud E
 
 2. Check that your device is powered. One or more more LEDs should be lit.
 3. Ensure you've connected your board with a working data USB cable.
-4. If you haven't done so already, [install Arduino Create Agent](https://create.arduino.cc/getting-started/plugin/welcome).
-5. [Check if the Arduino Create Agent is installed and running](https://support.arduino.cc/hc/en-us/articles/4980687506844-Check-if-the-Arduino-Create-Agent-is-installed-and-running).
+4. If you haven't done so already, [install Arduino Cloud Agent](https://create.arduino.cc/getting-started/plugin/welcome).
+5. [Check if the Arduino Cloud Agent is installed and running](https://support.arduino.cc/hc/en-us/articles/4980687506844).
 6. **If you're using Safari on macOS:** Check if the HTTPS certificate for Safari has been installed:
-    1. Open the Arduino Create Agent menu (Look for the ![Arduino Create Agent icon](img/create-agent-logo-mac.png) icon in the top-right of the menu bar of macOS).
+    1. Open the Arduino Cloud Agent menu (Look for the ![Arduino Cloud Agent icon](img/cloud-agent-logo-mac.png) icon in the top-right of the menu bar of macOS).
     2. Click on the **Manage HTTPS certificate** menu and make sure that the certificate is installed and trusted.  
        If it’s not, you can click on the button "Install the certificate for Safari".
     3. Enter the administrative credentials, if prompted.

content/Arduino Cloud/Cloud Editor/If-your-board-is-not-detected-by-Arduino-Cloud-Editor.md

@@ -16,5 +16,5 @@ Your sketch will automatically open in a new tab.
 
 To upload sketches to connected Arduino boards, please install the following software:
 
-- **For Windows, macOS, or Linux:** [Install the Arduino Create Agent](https://support.arduino.cc/hc/en-us/articles/360014869820-Install-the-Arduino-Create-Agent).
+- **For Windows, macOS, or Linux:** [Install the Arduino Cloud Agent](https://support.arduino.cc/hc/en-us/articles/360014869820).
 - **For Chromebook:** [Install Arduino Cloud for Chromebook](https://support.arduino.cc/hc/en-us/articles/360016495639-Use-Arduino-with-Chromebook#install-arduino-cloud-for-chromebook).

content/Arduino Cloud/Cloud Editor/Open-the-Cloud-Editor.md

@@ -3,7 +3,7 @@ title: Use Arduino Cloud with Brave Browser
 id: 10482021304988
 ---
 
-To use [Brave Browser](https://brave.com/) with Arduino Cloud it is necessary to create a custom filter that allows communication between Brave Browser and the [Arduino Create Agent](https://create.arduino.cc/getting-started/plugin/welcome).
+To use [Brave Browser](https://brave.com/) with Arduino Cloud it is necessary to create a custom filter that allows communication between Brave Browser and the [Arduino Cloud Agent](https://create.arduino.cc/getting-started/plugin/welcome).
 
 ---
 
@@ -20,4 +20,4 @@ To use [Brave Browser](https://brave.com/) with Arduino Cloud it is necessary to
 
 1. Click _Save changes_.
 
-The Arduino Create Agent will then be able to detect your board, and Arduino Cloud should work as expected.
+The Arduino Cloud Agent will then be able to detect your board, and Arduino Cloud should work as expected.