Merge pull request #139 from arduino/Update-link-table

Portenta H7 bootloader via JTAG, DIP switches, Upload error table updates

Author: seaxwi

content/Hardware Support/Portenta Family/DIP-switches-on-Portenta-Breakout-board.md

@@ -9,21 +9,21 @@ The Arduino Portenta Breakout board makes all high-density connectors individual
 
 <table>
 <tbody>
-  <tr>
+  <tr style="display: table-row;">
     <td rowspan="2"><b>BOOT_SEL</b></td>
     <td>ON</td>
     <td>Keeps the Portenta in Boot mode</td>
   </tr>
-  <tr>
+  <tr style="display: table-row;">
     <td>OFF</td>
     <td>Operation mode (default)</td>
   </tr>
-  <tr>
+  <tr style="display: table-row;">
     <td rowspan="2"><b>BOOT</b></td>
     <td>ON</td>
     <td>Enables the embedded bootloader. Firmware can be uploaded via the USB port on the breakout board (DFU). USB-A to USB-A (non-crossover) cable required. The Portenta H7 has to be powered through the USB-C connector or VIN.</td>
   </tr>
-  <tr>
+  <tr style="display: table-row;">
     <td>OFF</td>
     <td>Normal boot (default)</td>
   </tr>

content/Hardware Support/Portenta Family/How-to-flash-Portenta-H7-bootloader-via-JTAG-with-Arduino-IDE.md

@@ -10,33 +10,37 @@ The bootloader is a small program that runs when you turn the Arduino on or pres
 ## What you'll need
 
 * Portenta H7
-* [Portenta Breakout](https://store.arduino.cc/products/arduino-portenta-breakout)
+* A compatible carrier:
+  * [Portenta Breakout](https://store.arduino.cc/products/arduino-portenta-breakout)
+  * [Portenta Max Carrier](https://store.arduino.cc/products/portenta-max-carrier)
 * [STLINK programmer for STM32](https://www.st.com/en/development-tools/stlink-v3set.html)
-* JTAG connector (STLINK programmer to Portenta Breakout board)
+* JTAG connector cable (STLINK programmer to the carrier)
 * [Arduino IDE](https://www.arduino.cc/en/software)
 
-## Step-by-step Instructions
+## Step-by-step instructions
 
-1. Attach Portenta H7 to the Portenta Breakout.
+01. Find the [DIP switches](https://support.arduino.cc/hc/en-us/articles/4402095376402-DIP-switches-on-Portenta-Breakout-board) on the carrier and set both **BOOT_SEL** and **BOOT** to **ON**.
 
-2. Connect Portenta H7 to your PC with a USB-C cable.
+02. Attach Portenta H7 to the carrier.
 
-3. Connect the STLINK programmer to the PC with a USB cable.
+03. Connect Portenta H7 to your PC with a USB-C cable.
 
-4. Connect the JTAG cable from the STLINK programmer to the JTAG on the Breakout.
+04. Connect the STLINK programmer to the PC with a USB cable.
 
-5. Open Arduino IDE.
+05. Connect the JTAG cable from the STLINK programmer to the JTAG on the carrier.
 
-6. In the top menu bar, open _Tools > Board_ and select _Arduino Mbed OS Portenta Boards > Portenta H7 (M7 Core)_.
+06. Open Arduino IDE.
 
-7. Select the programmer in _Tools > Programmer_.
+07. In the top menu bar, open _Tools > Board_ and select _Arduino Mbed OS Portenta Boards > Portenta H7 (M7 Core)_.
 
-   ![Programmer selection](img/bootloader_IDE.png)
+08. Select the programmer in _Tools > Programmer_.
 
-8. Select _Tools > Burn Bootloader_ to burn the bootloader.
+    ![Programmer selection](img/bootloader_IDE.png)
 
-   ![Burn Bootloader](img/bootloader_IDE_2.png)
+09. Select _Tools > Burn Bootloader_ to burn the bootloader.
 
-9. Wait for the process to complete.
+    ![Burn Bootloader](img/bootloader_IDE_2.png)
 
-   ![Done burning bootloader](img/bootloader_IDE_3.png)
+10. Wait for the process to complete.
+
+    ![Done burning bootloader](img/bootloader_IDE_3.png)

content/Software Support/Upload/Errors-when-uploading-a-sketch.md

@@ -19,28 +19,32 @@ These checks will resolve the most common errors:
 
 If you still get an error, you'll find instructions for specific error messages below.
 
+---
+
 <a id="errors"></a>
 
-## Errors
+## List of errors
 
 > **Note:** _Exit status 1_ only indicates that the process has failed. Look for preceding lines in the error output for more specific information.
 
 <table>
 <tr>
 <td style="vertical-align: top;">
-<h3>Common</h3>
+<h3>Upload</h3>
 <ul>
-<li><a href="https://support.arduino.cc/hc/en-us/articles/360016955139-Error-exit-status-1">Error: exit status 1</a></li>
-<li><a href="https://support.arduino.cc/hc/en-us/articles/360020843439-Error-2-UNKNOWN-no-FQBN-provided">Error: 2 UNKNOWN: no FQBN provided</a></li>
-<li><a href="#no-device-found-on-port">No device found on &lt;port&gt;<br>Upload error: Failed uploading: uploading error: exit status 1</a></li>
+<li><a href="https://support.arduino.cc/hc/en-us/articles/360020831120-Failed-uploading-no-upload-port-provided">Failed uploading: no upload port provided</a></li>
+<li><a href="https://support.arduino.cc/hc/en-us/articles/6554944868252-Failed-uploading-uploading-error-exit-status-1">Failed uploading: uploading error: exit status 1</a></li>
+<li><a href="#no-device-found-on-port">No device found on &lt;port&gt;</a></li>
 <li><a href="#no-board-on-selected-port">Couldn't find a Board on the selected port</a></li>
 <li><a href="#no-dfu-capable-USB-device-available">dfu-util: No DFU capable USB device available</a></li>
 <li><a href="#SerialPortException-port-busy">jssc.SerialPortException: Port name - &lt;port&gt;;<br>Method name - openPort(); Exception type - Port busy.</a></li>
 </ul>
 <h3>Compilation error</h3>
 <ul>
+<li><a href="https://support.arduino.cc/hc/en-us/articles/6554914611228-Compilation-error-exit-status-1">Compilation error: exit status 1</a></li>
 <li><a href="https://support.arduino.cc/hc/en-us/articles/4412950941074-Compilation-error-Missing-FQBN-Fully-Qualified-Board-Name-">Compilation error: Missing FQBN (Fully Qualified Board Name)</a></li>
-<li><a href="https://support.arduino.cc/hc/en-us/articles/360020846379-Compilation-error-Error-2-UNKNOWN-platform-not-installed">Compilation error: Error: 2 UNKNOWN: platform not installed</a></li>
+<li><a href="https://support.arduino.cc/hc/en-us/articles/360020846379-Compilation-error-Error-2-UNKNOWN-platform-not-installed">Compilation error: Platform not found: platform not installed</a></li>
+
 </ul>
 <h3>Other</h3>
 <ul>