From 5cb676faf8841d364f192f067e5d9516053ac8c9 Mon Sep 17 00:00:00 2001 From: alexandra <83598143+gorillagripcore@users.noreply.github.com> Date: Mon, 29 Jul 2024 14:57:01 +0200 Subject: [PATCH 1/6] Create FAQ-Arduino-Portenta-X8.md --- .../FAQ-Arduino-Portenta-X8.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 content/Hardware Support/Portenta Family/FAQ-Arduino-Portenta-X8.md diff --git a/content/Hardware Support/Portenta Family/FAQ-Arduino-Portenta-X8.md b/content/Hardware Support/Portenta Family/FAQ-Arduino-Portenta-X8.md new file mode 100644 index 00000000..c2cfee0d --- /dev/null +++ b/content/Hardware Support/Portenta Family/FAQ-Arduino-Portenta-X8.md @@ -0,0 +1,101 @@ +--- +title: "FAQ: Arduino Portenta X8" +id: 13870453088924 +--- + +The frequently asked questions covered in this article are focused on providing essential information about Arduino Portenta X8 and how to operate it with ease. + +--- + +- **What is the ARM SystemReady image version?** + + The [SystemReady certification certificate](https://armkeil.blob.core.windows.net/developer/Files/pdf/certificate-list/arm-systemready-ir-certification-details-arduino.pdf) lists the firmware as "version pre-merge v85 / U-Boot 2021.04+fio+g38c3083e39." + +- **Where is Yocto distribution Build documented?** + + Yocto distribution build is documented in the [Linux microPlatform Manifest](https://github.com/arduino/lmp-manifest) + +- **Where are Yocto distribution layers documented?** + + Yocto distribution layers and scripts are documented in the [Linux microPlatform Manifest](https://github.com/arduino/lmp-manifest) + +- **How can I access the bootloader console (U-Boot)?** + + To access the bootloader console, you need one of the following setups: + + - Portenta X8 with the Portenta Breakout Carrier, by connecting to UART2 + - Portenta X8 with the Portenta Max Carrier, by connecting to the micro-USB DBG USB0 + + Once connected, open the console and press any key to access the bootloader. + + For the U-Boot repository, visit: GitHub - arduino/u-boot-imx. + +- **Can both Linux and Arduino environments perform I/O operations?** + + Yes, The STM32H7 will expose all the peripherals that can be accessed by both the M4 core and the Linux environment. + +- **Does the M4 support networking?** + + Yes it does. All networking, including WiFi, BLE, and other connectivity types, is managed by the Linux side and made available to the M4 through RPC calls. + +- **Is there an easy way to communicate between the MCU and MPU environments?** + + The RPC available on the M7 is designed for this task. + +- **Will the IDE eventually support the Linux environment, perhaps for app development?** + + No, the IDE is intended to be used with the Arduino side only. + +- **What can developers do with the Arduino version of Foundries.io?** + + Customers can install, create, and deploy custom and standard containers. Custom containers will be available on the Arduino/Foundries.io environment, while standard containers can be downloaded from Docker Hub. + + To ensure security and consistency of the operating system over time, it is strongly discouraged to modify the Linux platform and drivers with an Arduino Cloud Pro subscription. If customers wish to make such modifications, they should purchase a complete factory from Foundries.io. + +- **Should I use `apt-get` to install new software on the base image?** + + No, `apt` is not available in the base image. Instead, you should use a Docker container where you can install the software you need. + +- **Can I register the Portenta X8 with other cloud providers like Google or AWS?** + + Yes, the board can be registered with any cloud provider. While Arduino doesn’t offer official support for these integrations, Linux clients will generally work out of the box. + +- **Are HDMI touch screens supported? If so, can I use two on one Portenta X8?** + + The Portenta X8 has a single video output, so only one display can be used at a time. Additionally, the Portenta X8 does not have native HDMI output, but you can use a USB-C dongle to convert the DisplayPort signal to HDMI. Since touch screens also require a USB connection, you will need a dongle that supports both HDMI and USB, which should work for connecting a touch screen. + + However, it is not possible to use two HDMI touch screens simultaneously on the Portenta X8. + +- **How does the Portenta X8 work with Arduino IoT Pro Cloud?** + + Arduino IoT Pro Cloud for the X8 includes a Foundries.io subscription to the Secure & Scalable IoT Software Platform. This subscription enables customers to create a derivative factory for securely managing the Linux distribution and containers on Portenta X8 fleets through OTA updates. The subscription fee is based on batches of 50 devices. For example, if you have 100 devices, the fee will be equivalent to 2 batches of 50 devices each. + +- **Where can I find the containers created by Arduino for the Portenta X8?** + + The containers can be found [here on GitHub](https://github.com/arduino/portenta-containers) + +- **What is the purpose of a new image in a Foundries factory?** + + Portenta X8 boards use a Linux distribution that includes all necessary firmware, applications, and configurations for operation, while excluding unnecessary software. A new image is created to update the system, firmware, and applications. When a new image becomes available, it can be flashed onto the target board to apply these updates. + +- **What is the difference between the web shell and ADB shell?** + + The web shell, included in the Out of the Box Experience (OOBE) interface, runs as a container on the X8 and provides web-based access to the device. + + The ADB shell, on the other hand, is a separate container and application used to access and control the X8 from a PC. + +- **When we pull a container to Docker (for example, Ubuntu), are they self-contained? After pulling a new container, how can we use it?** + + Yes, containers are self-contained in Docker. When you pull a container image, such as Ubuntu, it includes all the necessary files and dependencies required to run the containerized application. + + After pulling a new container, you can use it by starting it with Docker commands. Containers provide an isolated environment, ensuring consistency across development, testing, and production. This makes them more portable and quicker to use compared to traditional development pipelines that replicate testing environments. Additionally, you can deploy Linux-based processes, track them through your Factory page, and manage them efficiently. + +- **How does Docker actually work? Is it like an OS or just a program running on Linux that manages apps?** + + [Docker](https://www.docker.com/) is a platform for managing applications using containers. Containers are isolated environments that encapsulate everything needed to run an application, making them portable and consistent across development, testing, and production environments. + + Docker itself is not an operating system; rather, it runs as a program on a host operating system (such as Linux). It allows you to download, install, use, and share applications packaged as containers. You can find a wide range of container images on [hub.docker.com](https://hub.docker.com/). + +- **When we update a factory image, does it also update the containers, such as Python?** + + Yes, updating a factory image includes the latest applications, firmware, and configurations. This means that containers, including those for Python, will also be updated as part of the new image. From f369ba9e7dce02404fea7bcdfac1ba0f9ffe6ee8 Mon Sep 17 00:00:00 2001 From: alexandra <83598143+gorillagripcore@users.noreply.github.com> Date: Mon, 29 Jul 2024 14:59:41 +0200 Subject: [PATCH 2/6] linter --- .../Hardware Support/Portenta Family/FAQ-Arduino-Portenta-X8.md | 1 - 1 file changed, 1 deletion(-) diff --git a/content/Hardware Support/Portenta Family/FAQ-Arduino-Portenta-X8.md b/content/Hardware Support/Portenta Family/FAQ-Arduino-Portenta-X8.md index c2cfee0d..88d0d401 100644 --- a/content/Hardware Support/Portenta Family/FAQ-Arduino-Portenta-X8.md +++ b/content/Hardware Support/Portenta Family/FAQ-Arduino-Portenta-X8.md @@ -1,6 +1,5 @@ --- title: "FAQ: Arduino Portenta X8" -id: 13870453088924 --- The frequently asked questions covered in this article are focused on providing essential information about Arduino Portenta X8 and how to operate it with ease. From cd5de4a14e1c41e76acc9eda425aeb27a717f277 Mon Sep 17 00:00:00 2001 From: alexandra <83598143+gorillagripcore@users.noreply.github.com> Date: Mon, 29 Jul 2024 15:04:55 +0200 Subject: [PATCH 3/6] Grammar --- .../Portenta Family/FAQ-Arduino-Portenta-X8.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/content/Hardware Support/Portenta Family/FAQ-Arduino-Portenta-X8.md b/content/Hardware Support/Portenta Family/FAQ-Arduino-Portenta-X8.md index 88d0d401..c45e4703 100644 --- a/content/Hardware Support/Portenta Family/FAQ-Arduino-Portenta-X8.md +++ b/content/Hardware Support/Portenta Family/FAQ-Arduino-Portenta-X8.md @@ -10,7 +10,7 @@ The frequently asked questions covered in this article are focused on providing The [SystemReady certification certificate](https://armkeil.blob.core.windows.net/developer/Files/pdf/certificate-list/arm-systemready-ir-certification-details-arduino.pdf) lists the firmware as "version pre-merge v85 / U-Boot 2021.04+fio+g38c3083e39." -- **Where is Yocto distribution Build documented?** +- **Where is the Yocto distribution Build documented?** Yocto distribution build is documented in the [Linux microPlatform Manifest](https://github.com/arduino/lmp-manifest) @@ -35,7 +35,7 @@ The frequently asked questions covered in this article are focused on providing - **Does the M4 support networking?** - Yes it does. All networking, including WiFi, BLE, and other connectivity types, is managed by the Linux side and made available to the M4 through RPC calls. + Yes, it does. All networking, including WiFi, BLE, and other connectivity types, is managed by the Linux side and made available to the M4 through RPC calls. - **Is there an easy way to communicate between the MCU and MPU environments?** @@ -43,13 +43,13 @@ The frequently asked questions covered in this article are focused on providing - **Will the IDE eventually support the Linux environment, perhaps for app development?** - No, the IDE is intended to be used with the Arduino side only. + No, the IDE is intended to be used only on the Arduino side. - **What can developers do with the Arduino version of Foundries.io?** Customers can install, create, and deploy custom and standard containers. Custom containers will be available on the Arduino/Foundries.io environment, while standard containers can be downloaded from Docker Hub. - To ensure security and consistency of the operating system over time, it is strongly discouraged to modify the Linux platform and drivers with an Arduino Cloud Pro subscription. If customers wish to make such modifications, they should purchase a complete factory from Foundries.io. + To ensure the security and consistency of the operating system over time, it is strongly discouraged that the Linux platform and drivers be modified with an Arduino Cloud Pro subscription. If customers wish to make such modifications, they should purchase a complete factory from Foundries.io. - **Should I use `apt-get` to install new software on the base image?** @@ -75,7 +75,7 @@ The frequently asked questions covered in this article are focused on providing - **What is the purpose of a new image in a Foundries factory?** - Portenta X8 boards use a Linux distribution that includes all necessary firmware, applications, and configurations for operation, while excluding unnecessary software. A new image is created to update the system, firmware, and applications. When a new image becomes available, it can be flashed onto the target board to apply these updates. + Portenta X8 boards use a Linux distribution that includes all necessary firmware, applications, and configurations for operation while excluding unnecessary software. A new image is created to update the system, firmware, and applications. When a new image becomes available, it can be flashed onto the target board to apply these updates. - **What is the difference between the web shell and ADB shell?** @@ -89,7 +89,7 @@ The frequently asked questions covered in this article are focused on providing After pulling a new container, you can use it by starting it with Docker commands. Containers provide an isolated environment, ensuring consistency across development, testing, and production. This makes them more portable and quicker to use compared to traditional development pipelines that replicate testing environments. Additionally, you can deploy Linux-based processes, track them through your Factory page, and manage them efficiently. -- **How does Docker actually work? Is it like an OS or just a program running on Linux that manages apps?** +- **How does Docker work? Is it like an OS or just a program running on Linux that manages apps?** [Docker](https://www.docker.com/) is a platform for managing applications using containers. Containers are isolated environments that encapsulate everything needed to run an application, making them portable and consistent across development, testing, and production environments. From 23a9ff80ac69529944934269c0d8651000db587c Mon Sep 17 00:00:00 2001 From: alexandra <83598143+gorillagripcore@users.noreply.github.com> Date: Wed, 31 Jul 2024 08:22:39 +0200 Subject: [PATCH 4/6] grammar --- .../Portenta Family/FAQ-Arduino-Portenta-X8.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/content/Hardware Support/Portenta Family/FAQ-Arduino-Portenta-X8.md b/content/Hardware Support/Portenta Family/FAQ-Arduino-Portenta-X8.md index c45e4703..8c9f0be3 100644 --- a/content/Hardware Support/Portenta Family/FAQ-Arduino-Portenta-X8.md +++ b/content/Hardware Support/Portenta Family/FAQ-Arduino-Portenta-X8.md @@ -43,17 +43,17 @@ The frequently asked questions covered in this article are focused on providing - **Will the IDE eventually support the Linux environment, perhaps for app development?** - No, the IDE is intended to be used only on the Arduino side. + No, the IDE is only intended for the Arduino. - **What can developers do with the Arduino version of Foundries.io?** - Customers can install, create, and deploy custom and standard containers. Custom containers will be available on the Arduino/Foundries.io environment, while standard containers can be downloaded from Docker Hub. + You can install, create, and deploy custom and standard containers. Custom containers will be available on the Arduino/Foundries.io environment, while standard containers can be downloaded from Docker Hub. To ensure the security and consistency of the operating system over time, it is strongly discouraged that the Linux platform and drivers be modified with an Arduino Cloud Pro subscription. If customers wish to make such modifications, they should purchase a complete factory from Foundries.io. - **Should I use `apt-get` to install new software on the base image?** - No, `apt` is not available in the base image. Instead, you should use a Docker container where you can install the software you need. + No, `apt` is not available in the base image. Instead, you should use a Docker container to install the necessary software. - **Can I register the Portenta X8 with other cloud providers like Google or AWS?** @@ -67,7 +67,7 @@ The frequently asked questions covered in this article are focused on providing - **How does the Portenta X8 work with Arduino IoT Pro Cloud?** - Arduino IoT Pro Cloud for the X8 includes a Foundries.io subscription to the Secure & Scalable IoT Software Platform. This subscription enables customers to create a derivative factory for securely managing the Linux distribution and containers on Portenta X8 fleets through OTA updates. The subscription fee is based on batches of 50 devices. For example, if you have 100 devices, the fee will be equivalent to 2 batches of 50 devices each. + Arduino IoT Pro Cloud for the X8 includes a Foundries.io subscription to the Secure & Scalable IoT Software Platform. This subscription enables customers to create a derivative factory for securely managing the Linux distribution and containers on Portenta X8 fleets through OTA updates. The subscription fee is based on batches of 50 devices. For example, if you have 100 devices, the cost will be equivalent to 2 batches of 50 devices each. - **Where can I find the containers created by Arduino for the Portenta X8?** @@ -75,7 +75,7 @@ The frequently asked questions covered in this article are focused on providing - **What is the purpose of a new image in a Foundries factory?** - Portenta X8 boards use a Linux distribution that includes all necessary firmware, applications, and configurations for operation while excluding unnecessary software. A new image is created to update the system, firmware, and applications. When a new image becomes available, it can be flashed onto the target board to apply these updates. + Portenta X8 boards use a Linux distribution that includes all necessary firmware, applications, and operating configurations while excluding unnecessary software. A new image is created to update the system, firmware, and applications. When a new image becomes available, it can be flashed onto the target board to apply these updates. - **What is the difference between the web shell and ADB shell?** @@ -83,7 +83,7 @@ The frequently asked questions covered in this article are focused on providing The ADB shell, on the other hand, is a separate container and application used to access and control the X8 from a PC. -- **When we pull a container to Docker (for example, Ubuntu), are they self-contained? After pulling a new container, how can we use it?** +- **When we pull a container to Docker (for example, Ubuntu), are they self-contained? How can we use a new container after pulling a new one?** Yes, containers are self-contained in Docker. When you pull a container image, such as Ubuntu, it includes all the necessary files and dependencies required to run the containerized application. @@ -93,8 +93,8 @@ The frequently asked questions covered in this article are focused on providing [Docker](https://www.docker.com/) is a platform for managing applications using containers. Containers are isolated environments that encapsulate everything needed to run an application, making them portable and consistent across development, testing, and production environments. - Docker itself is not an operating system; rather, it runs as a program on a host operating system (such as Linux). It allows you to download, install, use, and share applications packaged as containers. You can find a wide range of container images on [hub.docker.com](https://hub.docker.com/). + Docker itself is not an operating system; rather, it runs as a program on a host operating system (such as Linux). It lets you download, install, use, and share applications packaged as containers. You can find a wide range of container images on [hub.docker.com](https://hub.docker.com/). - **When we update a factory image, does it also update the containers, such as Python?** - Yes, updating a factory image includes the latest applications, firmware, and configurations. This means that containers, including those for Python, will also be updated as part of the new image. + Yes, updating a factory image includes the latest applications, firmware, and configurations. This means containers, including those for Python, will be updated as part of the new image. From 61aa6bd19063cb8fbd575d500a5541c1153cf092 Mon Sep 17 00:00:00 2001 From: alexandra <83598143+gorillagripcore@users.noreply.github.com> Date: Fri, 16 Aug 2024 17:42:39 +0200 Subject: [PATCH 5/6] Updates after feedback --- .../Portenta Family/FAQ-Arduino-Portenta-X8.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/content/Hardware Support/Portenta Family/FAQ-Arduino-Portenta-X8.md b/content/Hardware Support/Portenta Family/FAQ-Arduino-Portenta-X8.md index 8c9f0be3..f30b4473 100644 --- a/content/Hardware Support/Portenta Family/FAQ-Arduino-Portenta-X8.md +++ b/content/Hardware Support/Portenta Family/FAQ-Arduino-Portenta-X8.md @@ -24,8 +24,10 @@ The frequently asked questions covered in this article are focused on providing - Portenta X8 with the Portenta Breakout Carrier, by connecting to UART2 - Portenta X8 with the Portenta Max Carrier, by connecting to the micro-USB DBG USB0 + - Portenta X8 with the Mid Carrier, by connecting to UART2 using an FTDI serial adapter + - Portenta X8 with the Hat Carrier, by connecting to UART2 using an FTDI serial adapter - Once connected, open the console and press any key to access the bootloader. + Once connected, open a terminal or serial console application on your computer. Then press any key in the console to interrupt the boot process and access the bootloader. For the U-Boot repository, visit: GitHub - arduino/u-boot-imx. From d3ebd872156b255be40ad24c094a4bedd25721b8 Mon Sep 17 00:00:00 2001 From: alexandra <83598143+gorillagripcore@users.noreply.github.com> Date: Thu, 22 Aug 2024 09:21:37 +0200 Subject: [PATCH 6/6] Remove question --- .../Portenta Family/FAQ-Arduino-Portenta-X8.md | 13 ------------- 1 file changed, 13 deletions(-) diff --git a/content/Hardware Support/Portenta Family/FAQ-Arduino-Portenta-X8.md b/content/Hardware Support/Portenta Family/FAQ-Arduino-Portenta-X8.md index f30b4473..bd73e590 100644 --- a/content/Hardware Support/Portenta Family/FAQ-Arduino-Portenta-X8.md +++ b/content/Hardware Support/Portenta Family/FAQ-Arduino-Portenta-X8.md @@ -18,19 +18,6 @@ The frequently asked questions covered in this article are focused on providing Yocto distribution layers and scripts are documented in the [Linux microPlatform Manifest](https://github.com/arduino/lmp-manifest) -- **How can I access the bootloader console (U-Boot)?** - - To access the bootloader console, you need one of the following setups: - - - Portenta X8 with the Portenta Breakout Carrier, by connecting to UART2 - - Portenta X8 with the Portenta Max Carrier, by connecting to the micro-USB DBG USB0 - - Portenta X8 with the Mid Carrier, by connecting to UART2 using an FTDI serial adapter - - Portenta X8 with the Hat Carrier, by connecting to UART2 using an FTDI serial adapter - - Once connected, open a terminal or serial console application on your computer. Then press any key in the console to interrupt the boot process and access the bootloader. - - For the U-Boot repository, visit: GitHub - arduino/u-boot-imx. - - **Can both Linux and Arduino environments perform I/O operations?** Yes, The STM32H7 will expose all the peripherals that can be accessed by both the M4 core and the Linux environment.