Skip to content

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

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Nov 11, 2022
Merged

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

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
c471bba
Minor updates to table formatting and article links
seaxwi Nov 10, 2022
11c5922
override flex
seaxwi Nov 10, 2022
fd6cf9d
Updated with Max Carrier and DIP switches
seaxwi Nov 10, 2022
1192513
"Portenta Breakout or Portenta Max Carrier" → "carrier"
seaxwi Nov 11, 2022
590bb9a
Update content/Software Support/Upload/Errors-when-uploading-a-sketch.md
seaxwi Nov 11, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions ...ent/Hardware Support/Portenta Family/DIP-switches-on-Portenta-Breakout-board.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand Down
34 changes: 19 additions & 15 deletions ...ortenta Family/How-to-flash-Portenta-H7-bootloader-via-JTAG-with-Arduino-IDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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)
16 changes: 10 additions & 6 deletions content/Software Support/Upload/Errors-when-uploading-a-sketch.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand Down