Skip to content

Commit 538526c

Browse files
committed
Documentation content descriptive openining graphics update
1 parent 25c9965 commit 538526c

File tree

9 files changed

+21
-11
lines changed

9 files changed

+21
-11
lines changed
1.81 MB
Loading

content/hardware/04.pro/boards/portenta-x8/tutorials/02.x8-fundamentals/portenta-x8-fundamentals.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,11 @@ software:
1313

1414
## Overview
1515

16-
The **Portenta X8** is one of the most advanced boards available from Arduino, introducing new concepts not typically found in other Arduino boards. In this article, we will cover the foundations of the Portenta X8, helping you understand how it works and how you can leverage its advanced features. You will learn about FoundriesFactory® and how containers on the Portenta X8 work.
16+
The **Portenta X8** is one of the most advanced boards available from Arduino, introducing new concepts not typically found in other Arduino boards.
17+
18+
![Portenta X8 Fundamentals](assets/x8-fundamentals-c.png)
19+
20+
In this article, we will cover the foundations of the Portenta X8, helping you understand how it works and how you can leverage its advanced features. You will learn about FoundriesFactory® and how containers on the Portenta X8 work.
1721

1822
## Goals
1923

852 KB
Loading

content/hardware/04.pro/boards/portenta-x8/tutorials/04.python-arduino-data-exchange/content.md

Lines changed: 12 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,8 @@ hardware:
1212

1313
## Overview
1414

15+
![Portenta X8 RPC](assets/x8-rpc-c.gif)
16+
1517
The container infrastructure provided by Arduino contains a pre-built Python® image that you can use to run Python® applications on the Portenta X8. In this tutorial, we are going to build a container based on a provided one.
1618

1719
While all the peripherals are accessible from the iMX8 processor running the Linux environment, it can be useful to let the onboard microcontroller take care of certain peripheral handling and exchange only the required data between the microcontroller and the Python® application.
@@ -135,33 +137,33 @@ adb push <local directory path>/py-serialrpc /home/fio
135137
Log into the X8 shell with `adb shell` and navigate into the `serialrpc` folder. Build the container using
136138

137139
```bash
138-
sudo docker build . -t py-serialrpc`
140+
docker build . -t py-serialrpc
139141
```
140142

141143
The `-t` flag assigns a tag to the container. Then run the container by executing `cd..` and then:
142144

143145
```bash
144-
sudo docker compose up -d
146+
docker compose up -d
145147
```
146148

147149
The `-d` flag detaches the container so it runs in the background. Note that this will run the docker compose app and have the container built persistently across reboots by registering it as a systemd service.
148150

149151
To stop the container, run:
150152

151153
```bash
152-
sudo docker compose stop
154+
docker compose stop
153155
```
154156

155157
Check if the container is running by executing:
156158

157159
```bash
158-
sudo docker ps
160+
docker ps
159161
```
160162

161163
You can then access the log of its service at any time by using following command from the **same directory**:
162164

163165
```bash
164-
sudo docker compose logs -f --tail 20
166+
docker compose logs -f --tail 20
165167
```
166168

167169
If you do not wish to run the container in the background, skip the `-d` flag, you will get the console output directly in the executing shell. Once the container is running, you will see the messages being sent from the M4.
@@ -187,13 +189,13 @@ adb push <local directory path>/python-sensor-rpc /home/fio
187189
Log into the X8 via `adb shell`. Then navigate into the `python-sensor-rpc` folder and execute:
188190

189191
```bash
190-
sudo docker build . -t python-sensor-rpc
192+
docker build . -t python-sensor-rpc
191193
```
192194

193195
When it has finished, you can run the container with:
194196

195197
```bash
196-
sudo docker compose up
198+
docker compose up
197199
```
198200

199201
After a few seconds, you should see the output from the Python application featuring the sensor readings on the M4 that exchanges through the RPC mechanism. The output should look similar to the following:
@@ -219,17 +221,17 @@ adb push python-sensor-rpc /home/fio
219221

220222
```bash
221223
# On the Portenta X8
222-
sudo docker compose down
224+
docker compose down
223225
```
224226

225227
```bash
226228
# On the Portenta X8
227-
sudo docker build . -t python-sensor-rpc
229+
docker build . -t python-sensor-rpc
228230
```
229231

230232
```bash
231233
# On the Portenta X8
232-
sudo docker compose up
234+
docker compose up
233235
```
234236

235237
Alternatively, you could modify the files directly on the X8 using an editor such as **VIM**, so you do not need to upload the files every time. Rebuilding the container will be necessary in any case though.
4.54 MB
Loading
321 KB
Loading

content/hardware/04.pro/boards/portenta-x8/tutorials/08.image-building/content.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,8 @@ hardware:
1414

1515
## Overview
1616

17+
![Portenta X8 Custom Image Build](assets/x8-image-build-c.gif)
18+
1719
In this tutorial, you will learn how to build an image for the Portenta X8 with the source code provided at our [GitHub repository for lmp-manifest](https://github.com/arduino/lmp-manifest/). It is an ideal approach for debugging system elements like the bootloader or kernel support by building images locally.
1820

1921
***Images built locally cannot register with FoundriesFactory and will not be OTA compatible, but this is a good alternative for those who do not have a FoundriesFactory subscription.***
357 KB
Loading

content/hardware/04.pro/boards/portenta-x8/tutorials/09.image-flashing/content.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,8 @@ hardware:
1313

1414
## Overview
1515

16+
![Portenta X8 OS Image Update](assets/x8-os-image-update.gif)
17+
1618
In this tutorial, you will learn the different methods to update your Portenta X8 with the image provided by Arduino. By the end, you will be able to update your Portenta X8 to the latest version, ensuring optimal performance and security.
1719

1820
## Goals

0 commit comments

Comments
 (0)