diff --git a/content/hardware/04.pro/boards/portenta-x8/essentials.md b/content/hardware/04.pro/boards/portenta-x8/essentials.md index 022940bf76..979560cbe2 100644 --- a/content/hardware/04.pro/boards/portenta-x8/essentials.md +++ b/content/hardware/04.pro/boards/portenta-x8/essentials.md @@ -11,9 +11,15 @@ - + + Some containers examples for Portenta X8, these containers are accessible through your Foundries.io factory. + + + This repository contains Yocto recipes for building a Linux image for the Arduino Portenta X8. + + diff --git a/content/hardware/04.pro/boards/portenta-x8/tutorials/04.python-arduino-data-exchange/assets/py-serialrpc.zip b/content/hardware/04.pro/boards/portenta-x8/tutorials/04.python-arduino-data-exchange/assets/py-serialrpc.zip index 11eb4550c1..b79e56f25f 100644 Binary files a/content/hardware/04.pro/boards/portenta-x8/tutorials/04.python-arduino-data-exchange/assets/py-serialrpc.zip and b/content/hardware/04.pro/boards/portenta-x8/tutorials/04.python-arduino-data-exchange/assets/py-serialrpc.zip differ diff --git a/content/hardware/04.pro/boards/portenta-x8/tutorials/04.python-arduino-data-exchange/assets/python-sensor-rpc.zip b/content/hardware/04.pro/boards/portenta-x8/tutorials/04.python-arduino-data-exchange/assets/python-sensor-rpc.zip index d5133663d7..45f3aa0061 100644 Binary files a/content/hardware/04.pro/boards/portenta-x8/tutorials/04.python-arduino-data-exchange/assets/python-sensor-rpc.zip and b/content/hardware/04.pro/boards/portenta-x8/tutorials/04.python-arduino-data-exchange/assets/python-sensor-rpc.zip differ diff --git a/content/hardware/04.pro/boards/portenta-x8/tutorials/06.waves-fleet-managment/content.md b/content/hardware/04.pro/boards/portenta-x8/tutorials/06.waves-fleet-managment/content.md index adf4fe68d1..33edc7439e 100644 --- a/content/hardware/04.pro/boards/portenta-x8/tutorials/06.waves-fleet-managment/content.md +++ b/content/hardware/04.pro/boards/portenta-x8/tutorials/06.waves-fleet-managment/content.md @@ -47,15 +47,17 @@ For security purposes, we recommend that you rotate your FoundriesFactory keys. First, we will rotate the root keys. These are the most important keys, as they are used to create new target keys. Rotate them with the command: ```bash -fioctl keys rotate-root --initial /absolute/path/to/root.keys.tgz +fioctl keys tuf rotate-offline-keys -r root -k /absolute/path/to/root.keys.tgz ``` Now we can rotate the target-only keys with following command: ```bash -fioctl keys rotate-targets /absolute/path/to/root.keys.tgz +fioctl keys tuf rotate-offline-keys -r targets -k /absolute/path/to/root.keys.tgz ``` +***The above commands have been updated from the older __fioctl keys rotate-root__ and __fioctl keys rotate-targets__ commands to reflect the latest security practices recommended by [Foundries.io](https://docs.foundries.io/latest/reference-manual/security/offline-keys.html).*** + And finally, for security reasons, we separating the target keys from the root using the following command: ```bash diff --git a/content/hardware/04.pro/boards/portenta-x8/tutorials/08.image-building/content.md b/content/hardware/04.pro/boards/portenta-x8/tutorials/08.image-building/content.md index 00a32bc6b5..73c20642b9 100644 --- a/content/hardware/04.pro/boards/portenta-x8/tutorials/08.image-building/content.md +++ b/content/hardware/04.pro/boards/portenta-x8/tutorials/08.image-building/content.md @@ -14,7 +14,7 @@ hardware: ## Overview -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. +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. ***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.*** @@ -40,9 +40,9 @@ This tutorial targets customers that are not FoundriesFactory subscribers, but s #### Build the Docker Image -You will start by creating a Docker image with the necessary dependencies to build your device image. This involves cloning the [lmp-manifest repository](https://github.com/arduino/lmp-manifest) from Arduino's GitHub. Follow these steps: +You will start by creating a Docker image with the necessary dependencies to build your device image. This involves cloning the [lmp-manifest repository](https://github.com/arduino/lmp-manifest/) from Arduino's GitHub. Follow these steps: -Clone the [lmp-manifest repository](https://github.com/arduino/lmp-manifest) using the command below: +Clone the [lmp-manifest repository](https://github.com/arduino/lmp-manifest/) using the command below: ```bash git clone https://github.com/arduino/lmp-manifest.git @@ -111,9 +111,17 @@ cd /dockerVolume ``` ```bash -repo init -u https://github.com/arduino/lmp-manifest.git -m arduino.xml -b release +repo init -u https://github.com/arduino/lmp-manifest.git -m arduino.xml -b main ``` +If no specific branch is mentioned, the command could default to: + +```bash +repo init -u https://github.com/arduino/lmp-manifest.git -m arduino.xml +``` + +This would implicitly use the default branch, which is typically the *main* in repositories these days. + ![Git-repo initialization](assets/repo_init.png) Proceed to download the necessary files by synchronizing the repositories: diff --git a/content/hardware/04.pro/boards/portenta-x8/tutorials/12.multi-protocol-gateway/content.md b/content/hardware/04.pro/boards/portenta-x8/tutorials/12.multi-protocol-gateway/content.md index 0d152e7067..1456bb1877 100644 --- a/content/hardware/04.pro/boards/portenta-x8/tutorials/12.multi-protocol-gateway/content.md +++ b/content/hardware/04.pro/boards/portenta-x8/tutorials/12.multi-protocol-gateway/content.md @@ -130,13 +130,13 @@ sudo su - // Head to directory and mount the container cd /home/fio/py-serialrpc #py-serialrpc sudo docker build . -t py-serialrpc -#py-serialrpc sudo docker-compose up -d +#py-serialrpc sudo docker compose up -d ``` To access the logs of `py-serialrpc` service, while maintaining the same directory, execute the following command. ```bash -sudo docker-compose logs -f --tail 20 +sudo docker compose logs -f --tail 20 ``` ***For more details about how data exchange between Arduino and Linux layer works and to understand how to debug, please read [Data Exchange Between Python® on Linux and an Arduino Sketch](https://docs.arduino.cc/tutorials/portenta-x8/python-arduino-data-exchange)*** diff --git a/content/hardware/04.pro/boards/portenta-x8/tutorials/13.wordpress-webserver/content.md b/content/hardware/04.pro/boards/portenta-x8/tutorials/13.wordpress-webserver/content.md index bd775bb44e..f8251256ad 100644 --- a/content/hardware/04.pro/boards/portenta-x8/tutorials/13.wordpress-webserver/content.md +++ b/content/hardware/04.pro/boards/portenta-x8/tutorials/13.wordpress-webserver/content.md @@ -134,7 +134,7 @@ The `-d` flag runs the containers in the background; omitting it will tie the co The installation of the **WordPress** and **MariaDB** containers will begin and may take some time. To monitor the installation process, use: ```bash -docker-compose logs -f +docker compose logs -f ``` Upon completion, your WordPress site will be accessible from the Portenta X8.