[PXCT-101][PC-1676] Update Portenta X8 User Manual

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

@@ -16,7 +16,7 @@ The container infrastructure provided by Arduino contains a pre-built Python® i
 
 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.
 
-You will be guided on how to achieve this setup. It is recommendable to familiarize yourself with the foundational elements of the Portenta X8 and its infrastructure by reading the [user manual](https://docs.arduino.cc/tutorials/portenta-x8/user-manual) if you have not already done so.
+You will be guided on how to achieve this setup. It is recommendable to familiarize yourself with the foundational elements of the Portenta X8 and its infrastructure by reading [fundamentals of the Portenta X8](https://docs.arduino.cc/tutorials/portenta-x8/x8-fundamentals) if you have not already done so.
 
 ## Goals
 
@@ -32,6 +32,39 @@ You will be guided on how to achieve this setup. It is recommendable to familiar
 - Any sensor (in this example, we will use an [BME680](https://www.bosch-sensortec.com/products/environmental-sensors/gas-sensors/bme680/) I<sup>2</sup>C module)
 - [Arduino IDE 1.8.10+](https://www.arduino.cc/en/software), [Arduino IDE 2](https://www.arduino.cc/en/software), or [Arduino Cloud Editor](https://create.arduino.cc/editor)
 
+## Remote Procedure Call - RPC
+
+The two processors within the Portenta X8 require a communication mechanism to exchange data, known as an **RPC (Remote Procedure Call)**.
+
+**RPC** allows a program to trigger a **`procedure`** or **`function`** on another computer over a network rather than locally. It lets a program execute procedures **remotely**, with the details of network communication hidden to maintain transparency, making the remote call appear similar to a local one.
+
+It is particularly useful for distributed computing in a client-server model. The **`procedure call`** behaves as a **`request`** from the client, and the **`return value`** serves as the server's **`response`**. This model uses multiple computers connected over a network (often the Internet) to solve large computational tasks.
+
+While RPC aims to closely replicate local procedure calls, complete equivalence is not possible due to network communication challenges, which can introduce communication failures. To manage these issues, different RPC mechanisms adopt distinct semantics:
+
+- **`At most once` semantics** ensures that a remote call may fail but will not be run multiple times.
+- **`At least once` semantics** guarantees that the call is made at least once, even if it results in multiple activations.
+
+The Portenta X8 uses **MessagePack-RPC** for its communication (see the [library repository](https://github.com/msgpack-rpc/msgpack-rpc) for details). *MessagePack-RPC* relies on *MessagePack* as the serialization protocol, encoding data in *MsgPack* format, and is supported over:
+
+- OpenAMP via Shared Memory
+- SPI
+- Linux Char Device
+- TCP/IP
+
+![Linux Arduino RPC](assets/linux_arduino_RPC.png "Linux Arduino RPC")
+
+In the image above, the **M7 core** of the **STM32H7** manages communication between the Linux and Arduino environments. If an Arduino sketch runs on the **M4 core**, the **M7 core** acts as an intermediary, handling data requests between the M4 core and the Linux environment. Due to this setup, traditional dual-core processing is not supported on the Portenta X8.
+
+On the Linux side, a service called `m4-proxy` handles data transfer between Linux and Arduino.
+
+The communication process works as follows:
+
+- A program registers as the RPC server on port X, listing the procedures available for the M4 to call.
+- `m4-proxy` then forwards the calls from the M4 to the appropriate program/port.
+
+![RPC M4 proxy](assets/m4-proxy.png "RPC M4 proxy")
+
 ## Python® on the X8
 
 Python® is a modern and powerful scripting language used for a wide range of applications. In this tutorial, we only read sensor data from an Arduino sketch, but you could extend the example and process the data further.
@@ -204,7 +237,7 @@ Alternatively, you could modify the files directly on the X8 using an editor suc
 If you wonder how to specify the Python® script that is executed when running a container, have a look at the `Dockerfile` file. There you will find the `ENTRYPOINT` command that takes multiple arguments. In our example:
 
 ```python
-ENTRYPOINT [ "python3", "m4_to_python.py"]`
+ENTRYPOINT ["python3", "m4_to_python.py"]
 ```
 
 ## Conclusion

content/hardware/04.pro/boards/portenta-x8/tutorials/08.image-building/assets/portenta-x8_build.sh

@@ -23,7 +23,7 @@ repo init -u https://github.com/arduino/lmp-manifest.git -m arduino.xml -b relea
 echo Pulling git-repo files
 repo sync
 
-# Build 'lmp-partner-arduino-image' image
+# Build 'lmp-factory-image' image. lmp-partner-arduino-image is now known as lmp-factory-image
 echo Building Portenta-X8 image
 DISTRO=lmp-xwayland MACHINE=portenta-x8 . setup-environment
 echo "ACCEPT_FSL_EULA = \"1\"" >> conf/local.conf
@@ -36,7 +36,7 @@ cd ..
 echo Building tools
 DISTRO=lmp-mfgtool MACHINE=portenta-x8 . setup-environment
 echo "ACCEPT_FSL_EULA = \"1\"" >> conf/local.conf
-echo "MFGTOOL_FLASH_IMAGE = \"lmp-partner-arduino-image\"" >> conf/local.conf
+echo "MFGTOOL_FLASH_IMAGE = \"lmp-factory-image\"" >> conf/local.conf
 bitbake mfgtool-files
 
 echo Exit tools folder
@@ -52,7 +52,7 @@ cp -L build-lmp-mfgtool/deploy/images/portenta-x8/mfgtool-files-portenta-x8.tar.
 cp -L build-lmp-xwayland/deploy/images/portenta-x8/imx-boot-portenta-x8 $DEPLOY_FOLDER
 cp -L build-lmp-xwayland/deploy/images/portenta-x8/u-boot-portenta-x8.itb $DEPLOY_FOLDER
 cp -L build-lmp-xwayland/deploy/images/portenta-x8/sit-portenta-x8.bin $DEPLOY_FOLDER
-cp -L build-lmp-xwayland/deploy/images/portenta-x8/lmp-partner-arduino-image-portenta-x8.wic $DEPLOY_FOLDER
+cp -L build-lmp-xwayland/deploy/images/portenta-x8/lmp-factory-image-portenta-x8.wic $DEPLOY_FOLDER
 
 cd $DEPLOY_FOLDER
 tar xvf mfgtool-files-portenta-x8.tar.gz

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

@@ -59,11 +59,19 @@ cd lmp-manifest
 Build the Docker image with the following command:
 
 ```bash
-docker build -t yocto-build ./lmp-manifest
+docker build -t yocto-build .
 ```
 
+***If you encounter issues running Docker commands, you may need to install the necessary Docker components. You can install the Docker CLI by running: __`winget install --id=Docker.DockerCLI -e`__ or install [__Docker Desktop__](https://docs.docker.com/desktop/install/windows-install/), which includes all needed components.***
+
 ![Building a Docker Image](assets/docker_build.png)
 
+If you are building the Docker image one directory up, please use the following command:
+
+```bash
+docker build -t yocto-build ./lmp-manifest
+```
+
 You will see a confirmation message indicating the image's readiness if the build completes successfully.
 
 #### Run The Docker Image (Builder)
@@ -78,6 +86,12 @@ To run the *`yocto-build`* image and begin an interactive session, use the follo
 docker run -v <source>:/dockerVolume -it yocto-build bash
 ```
 
+If it encounters errors that may relate to entrypoint, you can use the following command instead of the previous command:
+
+```bash
+docker run --entrypoint /bin/bash -v <source>:/dockerVolume -it yocto-build
+```
+
 Once inside the container, switch to the *`builder`* user to proceed with the build process. The password for the builder user is **builder**:
 
 ```bash
@@ -152,7 +166,7 @@ Choose the appropriate distribution with the command below:
 DISTRO=lmp-xwayland MACHINE=portenta-x8 . setup-environment
 ```
 
-***Support for `lmp-partner-arduino-image` is anticipated to improve continuously.***
+***Support for `lmp-factory-image` is anticipated to improve continuously. Starting from image __version 888__, _`lmp-partner-arduino-image`_ is now known as __`lmp-factory-image`__.***
 
 Following the environment setup, the process will navigate to a new directory. Here, accept the EULA with:
 
@@ -169,7 +183,7 @@ The setup completion should resemble the output shown here:
 Start the image build with Bitbake using:
 
 ```bash
-bitbake lmp-partner-arduino-image
+bitbake lmp-factory-image
 ```
 
 ***This process may take ~7 hours depending on the build host***
@@ -193,7 +207,7 @@ To flash your board, you will need to compile **lmp-mfgtool distro** to get addi
 cd ..
 DISTRO=lmp-mfgtool MACHINE=portenta-x8 . setup-environment
 echo "ACCEPT_FSL_EULA = \"1\"" >> conf/local.conf
-echo "MFGTOOL_FLASH_IMAGE = \"lmp-partner-arduino-image\"" >> conf/local.conf
+echo "MFGTOOL_FLASH_IMAGE = \"lmp-factory-image\"" >> conf/local.conf
 ```
 
 You should be able to see similar results as the following image when successful:
@@ -229,7 +243,7 @@ cp -L build-lmp-mfgtool/deploy/images/portenta-x8/mfgtool-files-portenta-x8.tar.
 cp -L build-lmp-xwayland/deploy/images/portenta-x8/imx-boot-portenta-x8 $DEPLOY_FOLDER
 cp -L build-lmp-xwayland/deploy/images/portenta-x8/u-boot-portenta-x8.itb $DEPLOY_FOLDER
 cp -L build-lmp-xwayland/deploy/images/portenta-x8/sit-portenta-x8.bin $DEPLOY_FOLDER
-cp -L build-lmp-xwayland/deploy/images/portenta-x8/lmp-partner-arduino-image-portenta-x8.wic $DEPLOY_FOLDER
+cp -L build-lmp-xwayland/deploy/images/portenta-x8/lmp-factory-image-portenta-x8.wic $DEPLOY_FOLDER
 
 cd $DEPLOY_FOLDER
 tar xvf mfgtool-files-portenta-x8.tar.gz