DESK-MX-L-AN-0008: How to use UUU update utility

Info Box Applies to ORCA Application Notes Applies to MITO 8M Mini Application Notes

This application note was validated against specific versions of the kit only. It may not work with other versions. Supported versions are listed in the History section.

History

ID#	Date	Development Kit version
16675	07/10/2022	DESK-MX8M-L-2.0.0-rc2
18382	11/08/2023	DESK-MX8M-L-4.0.0

Introduction

This application note details how to use the UUU NXP Universal Update Utility for the i.MX platforms typically via SDP protocol, i.e. over USB OTG connection.

UUU is the replacement for MfgTool Command-line driven (no GUI). It allows a single command image download and it is fully scriptable. It supports all flash types (eMMC, NAND, QSPI, SD…).

Full open-source code is on Github with full documentation.

Build the UUU

The following instructions are used for building the uuu utility directly inside the DESK-MX8M-L-4.0.0 Virtual Machine

As reported in github README, the following Ubuntu packages have to be installed:

sudo apt-get install libusb-1.0-0-dev libbz2-dev libzstd-dev pkg-config cmake libssl-dev g++

then the git repository will be cloned:

git clone https://github.com/NXPmicro/mfgtools.git

For some Ubuntu 20.04 libzstd incompatibility, it is required to checkout a previous release:

git checkout uuu_1.5.109

Invoking the cmake utility, the application can be built:

cd mfgtools
cmake . && make

and install the application in the system directory:

sudo make install

MVM USB device

The USB device - for both SPL and u-boot stages - has to be enabled inside the VM using the VirtualBox proper Device menu. Once both USB devices are detected by the VM, it is possible to add them to the USB filters in order to enable them once detected:

ORCA

MVM USB settings are displayed here below:

• Boot configurations for USB Serial Download, i.e. with S2 switches BOOT_MODE[3:0] as 0001
  • J3 USB-C port is used for Power Delivery
  • J4 USB-C port is used for USB serial download connection

ORCA USB serial download connection

MITO 8M Mini

MVM USB settings are displayed here below:

MITO8M Mini Evaluation Kit has to be configured wih:

• Boot configurations from SD card, i.e. with J32 jumper inserted
• no SD card inserted for boot from USB serial download instead of SD card

MITO8M Mini USB serial download connection

uuu examples

ORCA

• device identification

dvdk@vagrant:~/mfgtools$ uuu -lsusb
uuu (Universal Update Utility) for nxp imx chips -- libuuu_1.5.109-0-g6c3190c

Connected Known USB Devices
        Path     Chip    Pro     Vid     Pid     BcdVersion
        ==================================================
        1:1      MX865   SDPS:   0x1FC9 0x0146   0x0002

dvdk@vagrant:~/mfgtools$ 

• binary download and programming

dvdk@vagrant:~/mfgtools$ sudo uuu -d desk-mx8m-l-4.0.0_imx8mp_flash.bin 
uuu (Universal Update Utility) for nxp imx chips -- libuuu_1.5.109-0-g6c3190c

Success 1    Failure 0                                                                                                                                                                          
                                                                                                                                                                                                 
                                                                                                                                                                                                 
1:1      2/ 2 [Done                                  ] SDPS: done                                                                                          

• once downloaded, the flash.bin boot image will be directly executed on the target and the serial console will show the u-boot messages:

U-Boot SPL 2022.04-desk-mx8m-l-4.0.0 (Jul 21 2023 - 14:01:51 +0200)
WARNING: SOM ConfigID on block 0 is UNLOCKED
SOM ConfigID#: 00000005
DDRINFO: start DRAM init
DDRINFO: DRAM rate 4000MTS

U-Boot SPL 2022.04-desk-mx8m-l-4.0.0 (Jul 21 2023 - 14:01:51 +0200)
WARNING: SOM ConfigID on block 0 is UNLOCKED
SOM ConfigID#: 00000005
DDRINFO: start DRAM init
DDRINFO: DRAM rate 4000MTS
DDRINFO:ddrphy calibration done
DDRINFO: ddrmix config done
Normal Boot
Trying to boot from BOOTROM
Boot Stage: USB boot

U-Boot SPL 2022.04-desk-mx8m-l-4.0.0 (Jul 21 2023 - 14:01:51 +0200)
WARNING: SOM ConfigID on block 0 is UNLOCKED
SOM ConfigID#: 00000005
DDRINFO: start DRAM init
DDRINFO: DRAM rate 4000MTS
DDRINFO:ddrphy calibration done
DDRINFO: ddrmix config done
Normal Boot
Trying to boot from BOOTROM
Boot Stage: USB boot
Find img info 0x&480265a0, size 888
Need continue download 1024
WARNING: CB ConfigID on block 0 is UNLOCKED
Download 1075808, Total size 1077440
WARNING: CB ConfigID on block 0 is UNLOCKED
Failed to find node!, err: -1!
Failed to find node!, err: -1!
NOTICE:  BL31: v2.6(release):desk-mx8m-l-4.0.0-rc2-0-g2b811b9b8
NOTICE:  BL31: Built : 19:00:25, Jun 29 2023


U-Boot 2022.04-desk-mx8m-l-4.0.0 (Jul 21 2023 - 14:01:51 +0200), Build: desk-mx8m-l-4.0.0

CPU:   Freescale i.MX8MP[8] rev1.1 1600 MHz (running at 1200 MHz)
CPU:   Industrial temperature grade (-40C to 105C) at 37C
Reset cause: POR
Model: DAVE i.MX8MPlus on SBC ORCA Rev A
DRAM:  6 GiB
Relocating to fff05000, new gd at fdbffda0, sp at fdbf5350
WARNING: CB ConfigID on block 0 is UNLOCKED
TCPC:  Vendor ID [0x1fc9], Product ID [0x5110], Addr [I2C2 0x50]
SNK.Power1.5 on CC2
PDO 0: type 0, 5000 mV, 500 mA [RSHUDE]
PDO 1: type 0, 9000 mV, 2180 mA []
PDO 2: type 0, 12000 mV, 1880 mA []
PDO 3: type 0, 15000 mV, 1510 mA []
PDO 4: type 0, 20000 mV, 1130 mA []
PDO 5: type 3, undefined
Requesting PDO 2: 12000 mV, 1880 mA
Source accept request
PD source ready!
tcpc_pd_receive_message: Polling ALERT register, TCPC_ALERT_RX_STATUS bit failed, ret = -62
TCPC:  Vendor ID [0x0], Product ID [0x202], Addr [I2C2 0x3d]
Core:  175 devices, 20 uclasses, devicetree: fit
MMC:   FSL_SDHC: 1, FSL_SDHC: 2
Loading Environment from nowhere... OK
Fail to setup video link
In:    serial
Out:   serial
Err:   serial

 BuildInfo:
  - ATF 2b811b9

WARNING: SOM ConfigID on block 0 is UNLOCKED
SOM ConfigID#: 00000005
SOM UniqueID#: 1e261000:55aa2564:469660d3:d0c2b602
CB ConfigID#: 00001008
CB UniqueID#: b7000035:c48de62d
WARNING: SOM ConfigID on block 0 is UNLOCKED
SOM: MX8MP-Mito8MPlus on SBC-ORCA HDMI + LVDStoHDMI
Card did not respond to voltage select! : -110
Detect USB boot. Will enter fastboot mode!
Net:
Warning: ethernet@30bf0000 (eth1) using random MAC address - 7e:fa:25:77:16:e1

Warning: ethernet@30be0000 (eth0) using random MAC address - 82:df:7f:29:63:b5
eth0: ethernet@30be0000, eth1: ethernet@30bf0000 [PRIME]
Fastboot: Normal
Boot from USB for mfgtools
*** Warning - Use default environment for                                mfgtools
, using default environment

Run bootcmd_mfg: run mfgtool_args;if iminfo ${initrd_addr}; then if test ${tee} = yes; then bootm ${tee_addr} ${initrd_addr} ${fdt_addr}; else booti ${loadaddr} ${initrd_addr} ${fdt_addr}; fi; else echo "Run fastboot ..."; fastboot 0; fi;
Hit any key to stop autoboot:  0

## Checking Image at 43800000 ...
Unknown image format!
Run fastboot ...

MITO 8M Mini

• device identification

dvdk@vagrant:~/mfgtools$ uuu -lsusb
uuu (Universal Update Utility) for nxp imx chips -- libuuu_1.5.109-0-g6c3190c

Connected Known USB Devices
        Path     Chip    Pro     Vid     Pid     BcdVersion
        ==================================================
        1:1      MX8MM   SDP:    0x1FC9 0x0134   0x0101

• binary download and programming

dvdk@vagrant:~/mfgtools$ sudo uuu -d desk-mx8m-l-4.0.0_imx8mm_flash.bin
uuu (Universal Update Utility) for nxp imx chips -- libuuu_1.5.109-0-g6c3190c

Success 10    Failure 0                                                                                                                                                                         
                                                                                                                                                                                                 
                                                                                                                                                                                                 
1:1      3/ 3 [Done                                  ] SDPV: done
1:2      2/ 2 [Done                                  ] SDP: done

• once downloaded, the flash.bin boot image will be directly executed on the target and the serial console will show the u-boot messages:

U-Boot SPL 2022.04-desk-mx8m-l-4.0.0 (Jul 21 2023 - 14:02:10 +0200)
WARNING: SOM ConfigID on block 0 is UNLOCKED
SOM ConfigID#: 00000002
DDRINFO: start DRAM init
DDRINFO: DRAM rate 3000MTS
DDRINFO:ddrphy calibration done
DDRINFO: ddrmix config done
Normal Boot
Trying to boot from USB SDP
SDP: initialize...
SDP: handle requests...
Downloading file of size 1216224 to 0x40400000... done
Jumping to header at 0x40400000
Header Tag is not an IMX image
Found header at 0x404293a0
WARNING: CB ConfigID on block 0 is UNLOCKED
NOTICE:  BL31: v2.6(release):desk-mx8m-l-4.0.0-rc1-0-g704f320b3
NOTICE:  BL31: Built : 07:49:14, Jun 20 2023


U-Boot 2022.04-desk-mx8m-l-4.0.0 (Jul 21 2023 - 14:02:10 +0200), Build: desk-mx8m-l-4.0.0

CPU:   Freescale i.MX8MMQ rev1.0 1600 MHz (running at 1200 MHz)
CPU:   Industrial temperature grade (-40C to 105C) at 58C
Reset cause: POR
Model: DAVE i.MX8MM MITO8MMINI board on SBCX
DRAM:  2 GiB
Relocating to bff0b000, new gd at bdf0adb0, sp at bdf00460
WARNING: CB ConfigID on block 0 is UNLOCKED
PMIC: PF8121 detected
Core:  149 devices, 19 uclasses, devicetree: fit
MMC:   FSL_SDHC: 0, FSL_SDHC: 1
Loading Environment from MMC... Card did not respond to voltage select! : -110
*** Warning - No block device, using default environment

Fail to setup video link
In:    serial
Out:   serial
Err:   serial

 BuildInfo:
  - ATF 704f320

WARNING: SOM ConfigID on block 0 is UNLOCKED
SOM ConfigID#: 00000002
SOM UniqueID#: c6536d65:222bc1aa
CB ConfigID#: 0000100a
CB UniqueID#: 09000035:c4b0bd2d
WARNING: SOM ConfigID on block 0 is UNLOCKED
SOM: MX8MM-Mito8MMini on SBCX-MINI LVDStoHDMI converterI
Card did not respond to voltage select! : -110
Detect USB boot. Will enter fastboot mode!
Net:   
Warning: ethernet@30be0000 (eth0) using random MAC address - 2e:d5:59:c1:4b:ae
eth0: ethernet@30be0000
Fastboot: Normal
Boot from USB for mfgtools
*** Warning - Use default environment for 				 mfgtools
, using default environment

Run bootcmd_mfg: run mfgtool_args;if iminfo ${initrd_addr}; then if test ${tee} = yes; then bootm ${tee_addr} ${initrd_addr} ${fdt_addr}; else booti ${loadaddr} ${initrd_addr} ${fdt_addr}; fi; else echo "Run fastboot ..."; fastboot 0; fi;
Hit any key to stop autoboot:  0 

## Checking Image at 43800000 ...
Unknown image format!
Run fastboot ...
No USB device found
USB init failed: -19
u-boot=>