Portenta X8 related fixes

Author: mcmchris

content/hardware/04.pro/boards/portenta-x8/essentials.md

@@ -26,7 +26,7 @@
         Download the latest firmware for Portenta X8 (Recommended).
     </EssentialElement>
 
-<EssentialElement title="Firmware Release Notes" type="article" link="/tutorials/portenta-x8/x8-firmware-release-notes">
+<EssentialElement link="/tutorials/portenta-x8/x8-firmware-release-notes" title="Firmware Release Notes" type="library">
         All available Portenta X8 firmware release notes.
     </EssentialElement>
 

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

@@ -1,6 +1,7 @@
 ---
 title: '04. Data Exchange Between Python® on Linux & Arduino Sketch'
 description: 'This tutorial will show you how to run a Python® application that exchanges data with an Arduino Sketch.'
+difficulty: intermediate
 tags: 
   - RPC
   - Python®
@@ -112,7 +113,7 @@ python-sensor-rpc_1  | Altitude:  311.0769348144531
 
 Whenever you change anything in the Python® script on your computer, you will have to sync it back to the X8 and re-build the container. Following command sequence will help you to do this process:
 
-```
+```bash
 # On your computer
 adb push python-sensor-rpc /home/fio
 

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

@@ -232,7 +232,7 @@ In this tutorial, you have learned how to build a "builder" Docker image, get it
 
 ## Next Steps
 
-Please follow the [Flashing tutorial](image-flashing) to flash your device with your custom image. You can use the files provided from this build to flash the Portenta X8 following the tutorial's steps.
+Please follow the [Flashing tutorial](https://docs.arduino.cc/tutorials/portenta-x8/image-flashing/) to flash your device with your custom image. You can use the files provided from this build to flash the Portenta X8 following the tutorial's steps.
 
 ## Troubleshooting
 

content/hardware/04.pro/boards/portenta-x8/tutorials/12.multi-protocol-gateway/content.md

@@ -1,6 +1,7 @@
 ---
 title: '12. Multi-Protocol Gateway With Portenta X8 & Max Carrier'
 description: 'This tutorial shows how to setup a multi-protocol gateway environment on Portenta X8 using Max Carrier'
+difficulty: intermediate
 tags:
   - Containers
   - Docker
@@ -111,15 +112,15 @@ Before you begin diving deep into creating a Multi-protocol gateway, and having
 
 The `m4-proxy` is a service that manages data exchange between these layers. You can use the following command in the terminal to observe if the service is running correctly.
 
-```
+```bash
 sudo journalctl -fu m4-proxy
 ```
 
 Now you will implement RPC (Remote Procedure Call) to establish communication between the Arduino and Linux layers, which is a communication mechanism developed to exchange data between these two layers.
 
 **You will not be able to check messages via `Serial.println()` statements** to check if the Arduino sketch is running in the desired manner. You will have to use instead **`py-serialrpc`**, which is a service that will assist you in listening to those messages, and printing them on a console on the Linux layer. To have the service active, please download [this compressed file](assets/py-serialrpc.zip) to build and run the container on the Linux side of Portenta X8. Please execute the following commands to have the service running.
 
-```
+```bash
 // Copy the decompressed files in ../adb/32.0.0 
 adb push py-serialrpc /home/fio
 adb shell
@@ -134,15 +135,15 @@ cd /home/fio/py-serialrpc
 
 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
 ```
 
 ***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)***
 
 If you have not configured internal Wi-Fi® connectivity within the system, please use the following command line:
 
-```
+```bash
 nmcli device wifi connect "SSID" password "PASSWORD"
 ```
 
@@ -495,22 +496,22 @@ It is now time to make the multi-protocol gateway run and for this, you will nee
 
 You will need to have the files ready in a folder inside the `adb` directory within Arduino root.
 
-```
+```bash
 C:\Users\#USERNAME#\AppData\Local\Arduino15\packages\arduino\tools\adb\32.0.0
 ```
 
 Having the files ready in that directory, you can use the following commands to push the files to the `fio` directory inside the Portenta X8. The second command will let you navigate inside the Portenta X8.
 
-```
+```bash
 adb push multi-protocol-gateway /home/fio
 adb shell
 ```
 
 You will now build the container using the following commands. The following command will tag the container with `Multi_Protocol_Gateway_X8` as its name.
 
-```
+```bash
 cd ../home/fio/Multi_Protocol_Gateway_X8
-#Multi_Protocol_Gateway_X8 sudo docker build . -t multi_gateway
+Multi_Protocol_Gateway_X8 sudo docker build . -t multi_gateway
 ```
 
 You will be able to see the following results when the image is built successfully.
@@ -521,19 +522,19 @@ You will be able to see the following results when the image is built successful
 
 After a successful container build, you will run the image. To do that, you can use the following command. This command will immediately give an output in your terminal, telling you how the Python® script is running. If you wish to have it running in the background, please add the `-d` flag at the end of the command.
 
-```
-#Multi_Protocol_Gateway_X8 sudo docker-compose up
+```bash
+Multi_Protocol_Gateway_X8 sudo docker-compose up
 ```
 
 Finally, you will have the multi-protocol gateway running, which uses Wi-Fi® and LoRa® connectivity. Also, RPC for exchanging data between its layers. However, there are cases where you would wish to make changes by adding more functionalities, such as including Cat. M1 or NB-IoT to expand its communication spectrum. For this, you will need to stop the image. To stop the image from running, you can use the following command.
 
-```
-#Multi_Protocol_Gateway_X8 sudo docker-compose down
+```bash
+Multi_Protocol_Gateway_X8 sudo docker-compose down
 ```
 
 Getting to know the status of the image is also crucial as it is the indicator of the state of operation. The following command brings up **active** containers and shows the status if the container restarted or stopped due to certain reasons. The second command lists built images and it will show you the components that go with the main image that you're building.
 
-```
+```bash
 docker ps -a
 docker images
 ```