You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
description: 'This tutorial teaches you how to flash your Portenta X8 through USB'
4
+
description: 'This tutorial teaches you how to flash your Portenta X8 through USB.'
5
5
difficulty: intermediate
6
6
tags:
7
7
- Embedded Linux
@@ -13,39 +13,34 @@ hardware:
13
13
14
14
## Overview
15
15
16
-
In this tutorial you will see how to manually flash your Portenta X8 with the image that is provided by Arduino. You will flash your board through USB using the Terminal.
17
-
The instructions below are meant to be used with a Windows Operating System.
16
+
In this tutorial, you will learn how to manually flash your Portenta X8 with the image provided by Arduino. You will flash your board through USB using the Terminal. The instructions below are meant to be used with a **Windows Operating System**.
18
17
19
-
***Attention: We encourage you to check every now and then if the device image version is up-to-date in order to have the latest bootloader. Please check the release section of the [lmp-manifest repository](https://github.com/arduino/lmp-manifest/releases) and compare the target version number***
18
+
***We encourage you to check now and then if the device image version is up-to-date to have the latest bootloader. Please check the release section of the [lmp-manifest repository](https://github.com/arduino/lmp-manifest/releases) and compare the target version number***
20
19
21
20
## Goals
22
21
23
-
-Get the required files
24
-
-Set up the correct structure of the files
25
-
-Set up the board
26
-
-Flash the device
22
+
-Learn how to get the required files
23
+
-Learn how to set up the correct structure of the files
-[Portenta Breakout Board](https://store.arduino.cc/products/arduino-portenta-breakout) or [Arduino Portenta Max Carrier](https://store.arduino.cc/products/portenta-max-carrier)
31
+
-USB-C® cable (either USB-C® to USB-A or USB-C® to USB-C®)
33
32
34
33
## Instructions
35
34
36
-
### Get the Required Files
35
+
### Getting Latest Portenta X8 Image
37
36
38
-
#### Arduino's GitHub Repository
37
+
The `lmp-manifest`[GitHub repository](https://github.com/arduino/lmp-manifest) contains releases of the official Arduino Linux microPlatform Manifests. We will head to the [releases](https://github.com/arduino/lmp-manifest/releases) section to acquire the required files. The files are compressed in tarball format (`.tar.gz`).
39
38
40
-
Go to the `lmp-manifest`[GitHub repository](https://github.com/arduino/lmp-manifest) and open the [releases](https://github.com/arduino/lmp-manifest/releases) section, there you will find a compressed `.tar.gz` with all the required files.
41
-
42
-
While we were writing this tutorial the available version was `456`, but you will probably find a more recent version in the future.
43
-
44
-
Click on the file `456.tar.gz` (or newer) and download it to your computer.
39
+
At the time of this tutorial writing, the available version was `456`. If you encounter newer versions, please use the latest version to have the Portenta X8 up to date. We will proceed to download `456.tar.gz` which is the current latest version.
Then After downloading it, unzip it, you will get a structure like the following:
43
+
Please extract the files after you have downloaded the compressed file. The extracted contents have the following structure.
49
44
50
45
```
51
46
Unzipped folder
@@ -56,9 +51,8 @@ Unzipped folder
56
51
└── u-boot-portenta-x8.itb
57
52
```
58
53
59
-
Then unzip `mfgtool-files-portenta-x8.tar.gz` and `lmp-partner-arduino-image-portenta-x8.wic.gz`make sure the .wic is on the unzipped folder in the main directory.
54
+
After verifying these files are available, you will need to decompress `mfgtool-files-portenta-x8.tar.gz` and `lmp-partner-arduino-image-portenta-x8.wic.gz`. Please make sure the `.wic` is in the unzipped folder in the main directory. The folder structure should share a similar following layout.
60
55
61
-
It needs to be like:
62
56
```
63
57
Unzipped folder
64
58
├── mfgtool-files-portenta-x8/
@@ -70,43 +64,41 @@ Unzipped folder
70
64
└── u-boot-portenta-x8.itb
71
65
```
72
66
73
-
### Set the Portenta X8 to Flashing Mode
74
-
75
-
Plug your Portenta X8 into your carrier (e.g. Portenta Breakout carrier or Portenta Max Carrier).
67
+
### Setting the Portenta X8 to Flashing Mode
76
68
77
-
Place both DIP switches to the ON position.
69
+
Connect your Portenta X8 into your carrier of choice, either *Portenta Breakout* or *Portenta Max Carrier*, via High-Density connectors. After connecting the Portenta X8, you will need to set the `BOOT`DIP switches to the ON position. The `BOOT` switch configuration is important as it will put the board into Flashing mode.
78
70
79
-
On the Portenta Max Carrier the DIP switches are identified by a label `BOOT SEL` and `BOOT` as shown in figure.
71
+
On the Portenta Max Carrier, the DIP switches are identified by the label `BOOT SEL` and `BOOT` as shown in the figure:
Plug one USB-C® end into the Portenta X8 and the other end (USB-C® or USB-A) to your computer.
79
+
You will need to connect one USB-C® end to the Portenta X8 and the other end (USB-C® or USB-A) to your computer. If the connection is established correctly, you will be able to see a newly connected device called `SE Blank M845S`.
88
80
89
-
You will see a new connected device called `SE Blank M845S`.
81
+
### Flashing the Portenta X8
90
82
91
-
### Flash the Device
83
+
To flash the Portenta X8, you need to begin by opening a terminal. Within the terminal, you need to change the directory to where `mfgtool-files-portenta-x8` file is located using the `cd` command. Once it is inside the directory where the previous file is included, the following command is used:
92
84
93
-
Open a terminal and change the directory (`cd`) to the folder where `mfgtool-files-portenta-x8` file is located.
94
-
95
-
Use the `uuu full_image.uuu` command.
85
+
```
86
+
uuu full_image.uuu
87
+
```
96
88
97
-
Wait until it gets flashed.
89
+
When the flashing operation is finished, you should see a similar result as the following figure:
At this point, set back the DIP switches to OFF position.
93
+
Once you have verified it has successfully flashed the Portenta X8, the `BOOT`DIP switches that have been configured to the ON position, now need to be set to the OFF position. Otherwise, you will always have the Portenta X8 in Flashing mode whenever it is attached to a carrier. Recycle the power for Portenta X8 by reconnecting the board to your computer and start using with the latest updates.
102
94
103
-
Unplug and then plug-in again the Portenta X8 to your computer.
95
+
***After booting, you will need to wait 10 seconds until the Portenta X8 starts blinking Blue LED. The Blue LED indicates it was able to boot successfully.***
104
96
105
-
***After booting you will need to wait 10 secs until the Portenta X8 blue LED starts blinking. This means the boot was successful.***
97
+
## Conclusion
106
98
107
-
Now you can start using your Portenta X8 with the latest updates.
99
+
In this tutorial, you have learned to flash the Portenta X8 by getting the latest image, setting up the adequate file structure and the board, and finally flashing the board with these files.
108
100
109
101
## Troubleshooting
110
102
111
-
- If you get an error while it is flashing, make sure your USB is correctly plugged in. Re-plug your board and try to flash it again. You may need few trials before the flashing is successful.
112
-
- If you get an error related to permissions, try to launch the `uuu` command as Super User (`sudo`).
103
+
- If you get an error while it is flashing, make sure your USB is correctly plugged in. Reconnect your board and try to flash it again. You may need to go through a few trials before successful flashing.
104
+
- If you get an error related to permissions, try to launch the `uuu` command as Super User (`sudo`).
0 commit comments