Merge branch 'main' into benjamindannegard/portenta-h7-bootloader-update

Author: BenjaminDannegard

content/hacking/01.software/Bootloader/Bootloader.md

@@ -26,7 +26,6 @@ Windows XP may be polling your parallel port and disrupting the bootloader burni
 [HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\Parport\Parameters]
 "DisableWarmPoll"=dword:00000001
 ```
-See this [forum thread](http://www.arduino.cc/cgi-bin/yabb2/YaBB.pl?num=1142106610) for details.
 
 ## Versions of the Bootloader
 There are different versions of the bootloader - both in order to work on different hardware and because it has changed over time.

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

@@ -1,6 +1,5 @@
 ---
 title: MKR FOX 1200
-url_shop: https://store.arduino.cc/arduino-mkr-fox-1200
 url_guide: /software/ide-v1/installing-samd21-core
 core: arduino:samd
 forumCategorySlug: '/mkr-boards/mkrfox1200/142'

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

@@ -1,6 +1,5 @@
 ---
 title: MKR GSM 1400
-url_shop: https://store.arduino.cc/arduino-mkr-gsm-1400
 url_guide: /software/ide-v1/installing-samd21-core
 core: arduino:samd
 forumCategorySlug: '/hardware/mkr-boards/mkrgsm1400/146'

content/hardware/02.hero/boards/uno-wifi-rev2/tutorials/uno-wifi-rev-2/uno-wifi-r2-chromebook-installation/uno-wifi-r2-chromebook-installation.md

@@ -50,7 +50,7 @@ Connect your UNO WiFi Rev2 board to your computer and follow the instructions fo
 
 ### Mac
 
-**1.** Download the [AVRDUDE tool for Mac (.zip file)](http://downloads.arduino.cc/tools/avrdude-6.3.0-arduino17-x86_64-apple-darwin12.tar.bz2) and unzip it to your Desktop folder. 
+**1.** Download the [AVRDUDE tool for Mac (.zip file)](https://downloads.arduino.cc/tools/avrdude-6.3.0-arduino17-x86_64-apple-darwin12.tar.bz2) and unzip it to your Desktop folder. 
 
 **2.** Open a terminal, and run the following command:
 
@@ -60,7 +60,7 @@ Connect your UNO WiFi Rev2 board to your computer and follow the instructions fo
 
 ### Windows
 
-**1.** Download the [AVRDUDE tool for Windows (.zip file)](http://downloads.arduino.cc/tools/avrdude-6.3.0-arduino17-i686-w64-mingw32.zip) and unzip it to your Desktop folder. 
+**1.** Download the [AVRDUDE tool for Windows (.zip file)](https://downloads.arduino.cc/tools/avrdude-6.3.0-arduino17-i686-w64-mingw32.zip) and unzip it to your Desktop folder. 
 
 **2.** Open a command prompt (CMD), and run the following command:
 
@@ -70,7 +70,7 @@ Connect your UNO WiFi Rev2 board to your computer and follow the instructions fo
 
 ### Linux
 
-**1.** Download the [AVRDUDE tool for Linux (.zip file)](http://downloads.arduino.cc/tools/avrdude-6.3.0-arduino17-x86_64-pc-linux-gnu.tar.bz2) and unzip it to your Desktop folder. 
+**1.** Download the [AVRDUDE tool for Linux (.zip file)](https://downloads.arduino.cc/tools/avrdude-6.3.0-arduino17-x86_64-pc-linux-gnu.tar.bz2) and unzip it to your Desktop folder. 
 
 **2.** Open a terminal, navigate to your root directory.
 

content/hardware/03.nano/boards/nano-rp2040-connect/downloads/ABX00053-full-pinout.pdf

@@ -54,9 +54,9 @@ Laboratory equipment, Computer vision
       </tr>
       <tr>
          <td style="text-align: center;">Connectivity</td>
-         <td style="text-align: center;">Ethernet PHY / Wi-Fi / Bluetooth® Low Energy</td>
+         <td style="text-align: center;">Ethernet PHY / Wi-Fi® / Bluetooth® Low Energy (BLE 5 via Cordio stack, BLE 4.2 via Arduino Stack)</td>
          <td style="text-align: center;">Ethernet FHY</td>
-         <td style="text-align: center;">Ethernet PHY / Wi-Fi / Bluetooth® Low Energy</td>
+         <td style="text-align: center;">Ethernet PHY / Wi-Fi® / Bluetooth® Low Energy (BLE 5 via Cordio stack, BLE 4.2 via Arduino Stack)</td>
       </tr>
       <tr>
          <td style="text-align: center;">Memory</td>
@@ -133,10 +133,6 @@ Laboratory equipment, Computer vision
          <td>Voltage scaling in Run and Stop mode 6 configurable ranges</td>
          <td></td>
       </tr>
-      <tr>
-         <td>2.95μA in Standby mode Backup SRAM OFF, RTC/LSE/ON</td>
-         <td></td>
-      </tr>
       <tr>
          <td>4 DMA controllers to unload the CPU</td>
          <td></td>

content/hardware/03.nano/boards/nano-rp2040-connect/interactive/ABX00053-pinout.png

@@ -66,12 +66,7 @@ This step is the same for both the classic IDE and the Pro IDE. Open the board m
 
 ![Also in the Pro IDE, a search for "portenta" reveals the core that needs to be installed to support Portenta H7.](assets/por_ard_gs_bm_core_pro_ide.png)
 
-### 3. Verify the USB Connection (Windows Only)
-In this step you will check if Windows is able to detect the Portenta H7. To do so open the Windows Device manager and if everything is set up correctly you will be able to see your device listed under USB devices. Otherwise, try unplugging it and plugging it back in.
-
-![If the Portenta H7 is detected correctly, it will be listed in the device manager under USB devices.](assets/por_ard_gs_usb_driver_win.png)
-
-### 4. Uploading the Classic Blink Sketch
+### 3. Uploading the Classic Blink Sketch
 Let's program the Portenta with the classic blink example to check if the connection to the board works. There are two ways to do that:
 
 -   In the classic Arduino IDE open the blink example by clicking the menu entry File->Examples->01.Basics->Blink. You need to swap LOW and HIGH pin values as the built-in LED on Portenta is turned on by pulling it LOW.
@@ -101,7 +96,7 @@ For Portenta H7  LED_BUILTIN  represents the built-in RGB LED on the board in gr
 
 **Note:** The individual colours of the built-in RGB LED can be accessed and controlled separately. In the tutorial "Dual Core Processing"  you will learn how to control the LED to light it in different colors
 
-### 5. Upload the Blink Sketch 
+### 4. Upload the Blink Sketch 
 Now it's time to upload the sketch and see if the LED will start to blink. Make sure you select Arduino Portenta H7 (M7 core) as the board and the port to which the Portenta H7 is connected. If the Portenta H7 doesn't show up in the list of ports, go back to step 5 and make sure that the drivers are installed correctly. Once selected click Upload. Once uploaded the built-in LED should start blinking with an interval of 1 second.
 
 **Note:** The Portenta H7 has an M7 and an M4 processor which run separate cores. That's why you need to select the one to which you want to upload your sketch to (check out the tutorial "Dual Core Processing" to learn more about Portenta's processors).

content/hardware/04.pro/boards/portenta-h7/datasheets/datasheet.md

@@ -59,7 +59,7 @@ There are two alternative ways to detect the board serial number:
 
 ![Portenta's serial number can be displayed in the Arduino IDE using the "Get Board Info" command](assets/por_ard_trace32_board_info.png)
 
-***If you only see a 16 character (64-bit) long serial number, then you need to update your Arduino IDE and the "Arduino mbed-enabled Boards" core from the boards manager in the IDE. Details of how to do this can be found on the Arduino website. Also, make sure your Portenta H7 has the [latest bootloader](https://www.arduino.cc/pro/tutorials/portenta-h7/por-ard-bl) installed.***
+***If you only see a 16 character (64-bit) long serial number, then you need to update your Arduino IDE and the "Arduino mbed-enabled Boards" core from the boards manager in the IDE. Details of how to do this can be found on the Arduino website. Also, make sure your Portenta H7 has the [latest bootloader](https://www.arduino.cc/pro/tutorials/portenta-h7/updating-the-bootloader) installed.***
 
 - Use the TRACE32 debugger. Check section "3. Start the TRACE32 Debugger" on how to start it. Click the menu item "Board S/N and License State". Your board's serial number will be printed in the AREA window and a dialog LICENSE.state will be opened.
 
@@ -191,7 +191,7 @@ Lauterbach also provides hardware-based debug & trace tools. To learn more about
 
 - Update Arduino IDE to the latest version available
 - Update **Arduino mbed-enabled Boards** core from Arduino IDE menu: **Tools > Board > Boards Manager**
-- Update the Portenta's bootloader using the instructions found [here](https://www.arduino.cc/pro/tutorials/portenta-h7/por-ard-bl).
+- Update the Portenta's bootloader using the instructions found [here](https://www.arduino.cc/pro/tutorials/portenta-h7/updating-the-bootloader).
 
 ### Error Message in AREA View: 'No More Arguments Expected' 
 

content/hardware/04.pro/boards/portenta-h7/tutorials/por-ard-gs/assets/por_ard_gs_usb_driver_win.png

@@ -50,7 +50,7 @@ Open the [OpenMV download](https://openmv.io/pages/download) page in your browse
 
 Connect the Portenta to your computer via the USB-C cable if you haven't done so yet. Make sure you first update the bootloader to the latest version using the **PortentaH7_updateBootloader** sketch in the examples menu in the Arduino IDE.
 
-Instructions on how to update the bootloader can be found in the ["Updating the Portenta Bootloader" tutorial](https://www.arduino.cc/pro/tutorials/portenta-h7/por-ard-bl).
+Instructions on how to update the bootloader can be found in the ["Updating the Portenta Bootloader" tutorial](https://www.arduino.cc/pro/tutorials/portenta-h7/updating-the-bootloader).
 
 After updating the bootloader put the Portenta in bootloader mode by double-pressing the reset button on the board. The built-in green LED will start fading in and out. Now open the OpenMV IDE.
 

content/hardware/04.pro/boards/portenta-h7/tutorials/por-ard-gs/content.md

@@ -7,4 +7,7 @@ software:
 hardware:
   boards:
     - portenta-h7
+    - portenta-h7-lite
+    - portenta-h7-lite-connected
+    - portenta-x8
 

content/hardware/04.pro/boards/portenta-h7/tutorials/por-ard-trace32/content.md

@@ -54,7 +54,7 @@ Follow the instructions of the installer.
 ### 2. Flashing the OpenMV Firmware
 
 Connect the Portenta to your computer via the USB-C cable if you haven't done so yet. Make sure you first update the bootloader to the latest version using the **PortentaH7_updateBootloader** sketch in the examples menu in the Arduino IDE. 
-Instructions on how to update the bootloader can be found in the ["Updating the Portenta Bootloader" tutorial](https://www.arduino.cc/pro/tutorials/portenta-h7/por-ard-bl).
+Instructions on how to update the bootloader can be found in the ["Updating the Portenta Bootloader" tutorial](https://www.arduino.cc/pro/tutorials/portenta-h7/updating-the-bootloader).
 
 ***In bootloader versions 17 and older there was a bug that could put the Portenta in a boot loop when the transmission aborted while flashing a large firmware file. This was fixed in the bootloader version 18. We strongly advise to update the bootloader before you proceed with the next step of this tutorial!***
 

content/hardware/04.pro/boards/portenta-h7/tutorials/por-openmv-gs/content.md

@@ -38,7 +38,7 @@ The built-in Haar Cascade model for faces was trained with hundreds of images co
 
 ### Creating the Face Detection Script
 
-For this tutorial you will be using the OpenMV IDE along with the OpenMV firmware on your Portenta H7 to build the face detection script. If this is your first time using the Vision Carrier and OpenMV we recommend you to take a look at the "Configuring the Development Environment" section inside the [Blob Detection tutorial](https://www.arduino.cc/pro/tutorials/portenta-h7/por-openmv-bt) to configure the development environment. 
+For this tutorial you will be using the OpenMV IDE along with the OpenMV firmware on your Portenta H7 to build the face detection script. If this is your first time using the Vision Carrier and OpenMV we recommend you to take a look at the "Configuring the Development Environment" section inside the [Blob Detection tutorial](https://docs.arduino.cc/tutorials/portenta-vision-shield/vs-openmv-bt) to configure the development environment. 
 
 ### 1. The Basic Setup
 

content/hardware/04.pro/boards/portenta-h7/tutorials/por-ard-bl/assets/por_ard_bl_boards_manager.png renamed to content/hardware/04.pro/boards/portenta-h7/tutorials/updating-the-bootloader/assets/por_ard_bl_boards_manager.png

@@ -122,8 +122,9 @@ The **Arduino_BHY2** library contains these sensors:
 ```arduino
   #include "Arduino_BHY2.h"
 
-  SensorOrientation orientation(SENSOR_ID_DEVICE_ORI);
-
+  Sensor device_orientation(SENSOR_ID_DEVICE_ORI);
+  SensorOrientation orientation(SENSOR_ID_ORI);  
+  
   void setup(){
     Serial.begin(115200);
     BHY2.begin();

content/hardware/04.pro/boards/portenta-h7/tutorials/por-ard-bl/assets/por_ard_bl_booting_process.svg renamed to content/hardware/04.pro/boards/portenta-h7/tutorials/updating-the-bootloader/assets/por_ard_bl_booting_process.svg

@@ -33,6 +33,8 @@ The OpenMV IDE is meant to provide an Arduino like experience for simple machine
 
 Using the OpenMV IDE you can run [MicroPython](http://docs.MicroPython.org/en/latest/) scripts on the Nicla Vision board. MicroPython provides a lot of classes and modules that make it easy to quickly explore the features of the Nicla Vision. In this tutorial you will first download the OpenMV IDE and set up the development environment. [Here](https://openmv.io/) you can read more about the OpenMV IDE. OpenMV comes with its own firmware that is built on MicroPython. You will then learn to write a simple script that will blink the on-board RGB LED using some basic MicroPython commands.
 
+***Before proceeding with the tutorial please update the board's bootloader. You can do this by first downloading the latest version of the "Mbed OS Nicla core" in the Arduino IDE. Then go to "File > Examples > STM32H747_System > STM32H747_updateBootloader" and upload this sketch to your board. After the sketch is uploaded follow the instructions in the serial monitor.***
+
 ### 1. Downloading the OpenMV IDE
 
 Before you can start programming OpenMV scripts for the Nicla Vision you need to download and install the OpenMV IDE.

content/hardware/04.pro/boards/portenta-h7/tutorials/por-ard-bl/assets/por_ard_bl_cover.svg renamed to content/hardware/04.pro/boards/portenta-h7/tutorials/updating-the-bootloader/assets/por_ard_bl_cover.svg

@@ -97,7 +97,7 @@ Rather then requiring a physical press of the reset button before an upload, the
 
 This setup has other implications. When the Duemilanove is connected to either a computer running Mac OS X or Linux, it resets each time a connection is made to it from software (via USB). For the following half-second or so, the bootloader is running on the Duemilanove. While it is programmed to ignore malformed data (i.e. anything besides an upload of new code), it will intercept the first few bytes of data sent to the board after a connection is opened. If a sketch running on the board receives one-time configuration or other data when it first starts, make sure that the software with which it communicates waits a second after opening the connection and before sending this data.
 
-The Duemilanove contains a trace that can be cut to disable the auto-reset. The pads on either side of the trace can be soldered together to re-enable it. It's labeled "RESET-EN". You may also be able to disable the auto-reset by connecting a 110 ohm resistor from 5V to the reset line; see [this forum thread](http://www.arduino.cc/cgi-bin/yabb2/YaBB.pl?num=1213719666/all) for details.
+The Duemilanove contains a trace that can be cut to disable the auto-reset. The pads on either side of the trace can be soldered together to re-enable it. It's labeled "RESET-EN". You may also be able to disable the auto-reset by connecting a 110 ohm resistor from 5V to the reset line.
 
 ### USB Overcurrent Protection
 

content/hardware/04.pro/boards/portenta-h7/tutorials/por-ard-bl/assets/por_ard_bl_find_sketch_file.png renamed to content/hardware/04.pro/boards/portenta-h7/tutorials/updating-the-bootloader/assets/por_ard_bl_find_sketch_file.png

@@ -115,15 +115,15 @@ You can also bypass the bootloader and program the microcontroller through the I
 The ATmega8U2 firmware source code is available [in the Arduino repository](http://github.com/arduino/Arduino/tree/master/hardware/arduino/firmwares/). The ATmega8U2 is loaded with a DFU bootloader, which can be activated by:
 
 * On Rev1 boards: connecting the solder jumper on the back of the board (near the map of Italy) and then resetting the 8U2.
-* On Rev2 or later boards: there is a resistor that pulling the 8U2/16U2 HWB line to ground, making it easier to put into DFU mode. You can then use [Atmel's FLIP software](http://www.atmel.com/dyn/products/tools_card.asp?tool_id=3886) (Windows) or the [DFU programmer](http://dfu-programmer.sourceforge.net/) (Mac OS X and Linux) to load a new firmware. Or you can use the ISP header with an external programmer (overwriting the DFU bootloader). See [this user-contributed tutorial](http://www.arduino.cc/cgi-bin/yabb2/YaBB.pl?num=1285962838) for more information.
+* On Rev2 or later boards: there is a resistor that pulling the 8U2/16U2 HWB line to ground, making it easier to put into DFU mode. You can then use [Atmel's FLIP software](http://www.atmel.com/dyn/products/tools_card.asp?tool_id=3886) (Windows) or the [DFU programmer](http://dfu-programmer.sourceforge.net/) (Mac OS X and Linux) to load a new firmware. Or you can use the ISP header with an external programmer (overwriting the DFU bootloader). 
 
 ### Automatic (Software) Reset
 
 Rather then requiring a physical press of the reset button before an upload, the Arduino MEGA ADK is designed in a way that allows it to be reset by software running on a connected computer. One of the hardware flow control lines (DTR) of the ATmega8U2 is connected to the reset line of the ATmega2560 via a 100 nanofarad capacitor. When this line is asserted (taken low), the reset line drops long enough to reset the chip. The Arduino software uses this capability to allow you to upload code by simply pressing the upload button in the Arduino environment. This means that the bootloader can have a shorter timeout, as the lowering of DTR can be well-coordinated with the start of the upload.
 
 This setup has other implications. When the MEGA ADK is connected to either a computer running Mac OS X or Linux, it resets each time a connection is made to it from software (via USB). For the following half-second or so, the bootloader is running on the MEGA ADK. While it is programmed to ignore malformed data (i.e. anything besides an upload of new code), it will intercept the first few bytes of data sent to the board after a connection is opened. If a sketch running on the board receives one-time configuration or other data when it first starts, make sure that the software with which it communicates waits a second after opening the connection and before sending this data.
 
-The MEGA ADK contains a trace that can be cut to disable the auto-reset. The pads on either side of the trace can be soldered together to re-enable it. It's labeled "RESET-EN". You may also be able to disable the auto-reset by connecting a 110 ohm resistor from 5V to the reset line; see [this forum thread](http://www.arduino.cc/cgi-bin/yabb2/YaBB.pl?num=1213719666/all) for details.
+The MEGA ADK contains a trace that can be cut to disable the auto-reset. The pads on either side of the trace can be soldered together to re-enable it. It's labeled "RESET-EN". You may also be able to disable the auto-reset by connecting a 110 ohm resistor from 5V to the reset line.
 
 ### USB Overcurrent Protection
 

content/hardware/04.pro/boards/portenta-h7/tutorials/por-ard-bl/assets/por_ard_bl_firmware.svg renamed to content/hardware/04.pro/boards/portenta-h7/tutorials/updating-the-bootloader/assets/por_ard_bl_firmware.svg

@@ -18,7 +18,7 @@ The adapter can easily connect to the Arduino Ethernet, Mini, Mini Pro, LilyPad,
 
 An onboard polyfuse limits the current to 500mA and protects the host computer from short circuits.
 
-The ATmega16U2 firmware source code is available . The ATmega16U2 is loaded with a DFU bootloader, which can be activated by connecting the solder jumper on the back of the board and then resetting the 16U2\. You can then use [Atmel's FLIP software](http://www.atmel.com/dyn/products/tools_card.asp?tool_id=3886) (Windows) or the [DFU programmer](http://dfu-programmer.sourceforge.net/) (Mac OS X and Linux) to load a new firmware. Or you can use the ISP header with an external programmer (overwriting the DFU bootloader). See [this user-contributed tutorial](http://www.arduino.cc/cgi-bin/yabb2/YaBB.pl?num=1285962838) for more information.
+The ATmega16U2 firmware source code is available . The ATmega16U2 is loaded with a DFU bootloader, which can be activated by connecting the solder jumper on the back of the board and then resetting the 16U2\. You can then use [Atmel's FLIP software](http://www.atmel.com/dyn/products/tools_card.asp?tool_id=3886) (Windows) or the [DFU programmer](http://dfu-programmer.sourceforge.net/) (Mac OS X and Linux) to load a new firmware. Or you can use the ISP header with an external programmer (overwriting the DFU bootloader).
 
 You can find [here](https://www.arduino.cc/en/Main/warranty) your board warranty information.
 

content/hardware/04.pro/boards/portenta-h7/tutorials/por-ard-bl/assets/por_ard_bl_flash_memory.svg renamed to content/hardware/04.pro/boards/portenta-h7/tutorials/updating-the-bootloader/assets/por_ard_bl_flash_memory.svg

@@ -35,7 +35,7 @@ Once that's in place, you'll need to attach the protective cover for the botom b
 
 ### Content on the SD card
 
-The SD card is used to store information for the robot to read. It comes preloaded with images and sound files used in the _Explore_ examples. Once comfortable with the robot's functionality, you should be able to add your own files. If you ever accidentally remove files used by the explore sketches, you can copy them over from the SDcontent directory found in the robot library. Alternatively you can [download the files here](/en/uploads/Guide/sdContent.zip).
+The SD card is used to store information for the robot to read. It comes preloaded with images and sound files used in the _Explore_ examples. Once comfortable with the robot's functionality, you should be able to add your own files. If you ever accidentally remove files used by the explore sketches, you can copy them over from the SDcontent directory found in the robot library. Alternatively you can [download the files here](https://www.arduino.cc/en/uploads/Guide/sdContent.zip).
 
 ### Connecting the robot to your computer