Arduino Portenta X8¶

Note

The instructions in this section also applies to those boards with secure boot enabled. There are references on how to perform common instructions along with the flow.

The Security Reference Manual details the required background for secure boot.

Preparation¶

Ensure you replace the <factory> placeholder below with the name of your Factory.

Download necessary files from https://app.foundries.io/factories/<factory>/targets
1. Click the latest Target with the platform-devel Trigger.
2. Expand the run in the Runs section which corresponds with the name of the board and download the Factory image for that machine.
  
  E.g:
  
  lmp-partner-arduino-image-<machine-name>.wic.gz
  
  u-boot-<machine-name>.itb
  
  sit-<machine-name>.bin
  
  imx-boot-<machine-name>
Extract the file lmp-partner-arduino-image-<machine-name>.wic.gz:
```
gunzip lmp-partner-arduino-image-<machine-name>.wic.gz
```
Expand the run in the Runs section which corresponds with the name of the board mfgtool-files and download the tools for that machine.

E.g: mfgtool-files-<machine-name>.tar.gz
Download and extract the file mfgtool-files-<machine-name>.tar.gz:
```
tar -zxvf mfgtool-files-<machine-name>.tar.gz
```

Organize all the files like the tree below:

├── lmp-partner-arduino-image-<machine-name>.wic
├── u-boot-<machine-name>.itb
├── sit-<machine-name>.bin
├── imx-boot-<machine-name>
└── mfgtool-files-<machine-name>
      ├── bootloader.uuu
      ├── full_image.uuu
      ├── imx-boot-mfgtool
      ├── uuu
      └── uuu.exe

Hardware Preparation¶

Set up the board for updating using the manufacturing tools:

Fig. 48 portenta-x8¶

OPTIONAL —Only required if you have problems and/or want to see the boot console output.

Fig. 49 UART 2 Pins¶

You may need to solder a six pin header to the UART2 pad.
Connect a TTL USB to UART 3v3 adapter to the corresponding UART 2 pins on the breakout board.
Connect the other end of the cable to a PC acting as a host terminal.
A UART connection will appear on the PC.
On a Linux® host for example:

$ ls -l /dev/serial/by-id/ total 0 lrwxrwxrwx 1 root root 13 Dec 18 11:09 usb-FTDI_TTL_RS232-if00-port0 -> ../../ttyUSB0

Using a serial terminal program like minicom, connect to the port with if00 in the name (in this example ttyUSB0) and apply the following configuration

Baud rate: 115200

Data bits: 8

Stop bit: 1

Parity: None

Flow control: None
A helpful reminder, if your not receiving console output to swap the TX and RX pins. Most TTL USB to UART adaptors do not provide the cross over function.
Ensure that the power is off (no power input connected)
Put the Portenta-x8 into programing mode:

Switch BT_SEL to ON and Switch BOOT ON as shown below.

Fig. 50 BT_SEL and BOOT programing settings¶
Connect your computer to the Portenta X8 board via either USB-C® to USB-A or USB-C® to USB-C®.
This connection will power your board ON. It is best to use 5V supply with at least 2A via a USB-C® connector. Negotiating power supplies do not always work and frequent reboots can be detected.

Flashing¶

Once in serial downloader mode and connected to your PC the evaluation board should show up as an NXP® USB device.

Note

For instructions on how to sign the required images before flashing them to the board with secure boot enabled, follow the instructions from Machines with secure aspects enabled by FoundriesFactory.

Verify target is present:
```
$ lsusb | grep NXP
Bus 001 Device 023: ID 1fc9:012b NXP Semiconductors i.MX 8M Dual/8M QuadLite/8M Quad Serial Downloader
```
In this mode you will use the uuu tools to program the images to the eMMC. The USB ID may differ if a different SoC is used.

Run the command below to program the LmP to the EMMC:

$ sudo mfgtool-files-<machine-name>/uuu -pp 1 mfgtool-files-<machine-name>/full_image.uuu
uuu (Universal Update Utility) for nxp imx chips -- libuuu_1.4.43-0-ga9c099a

Success 1    Failure 0


1:31     3/ 3 [=================100%=================] SDPV: jump
2:31     8/ 8 [Done                                  ] FB: done

Turn off the power.
Put the board into run mode

Start the Device Manager
Select View
Select Devices by container
Verify a device like the following:

Run the command below to program the LmP to the EMMC:

C:\Users\Someone> mfgtool-files-<machine-name>\uuu.exe -pp 1 mfgtool-files-<machine-name>\full_image.uuu
uuu (Universal Update Utility) for nxp imx chips -- libuuu_1.4.43-0-ga9c099a

Success 1    Failure 0


1:31     3/ 3 [=================100%=================] SDPV: jump
2:31     8/ 8 [Done                                  ] FB: done

Turn off the power.
Put the board into run mode

To put the Portenta X8 into run mode, switch BT_SEL and BOOT to OFF.