UUU - Universal Update Utility

The Universal Update Utility is used to program your board. It repaces NXP’s “MFG-Tool”. We actually use uuu to flash our TX8M module series. For everything below (TX6 and TXUL series) please continue to use MFG-Tool.

Getting uuu

Get the latest stable file uuu (for Linux) or uuu.exe (for Windows) from NXP’s official repository: https://github.com/NXPmicro/mfgtools/releases

udev Rules

Note

This is just relevant for LINUX users.

There’s no need to call uuu as sudo. Just update your udev rules as follows.

SUBSYSTEM=="usb", ATTRS{idVendor}=="1fc9", ATTRS{idProduct}=="012f", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="1fc9", ATTRS{idProduct}=="0129", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="1fc9", ATTRS{idProduct}=="0147", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="15a2", ATTRS{idProduct}=="004f", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="1fc9", ATTRS{idProduct}=="013e", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="1fc9", ATTRS{idProduct}=="0146", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="1fc9", ATTRS{idProduct}=="014a", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="1fc9", ATTRS{idProduct}=="014b", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="15a2", ATTRS{idProduct}=="0076", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="15a2", ATTRS{idProduct}=="0054", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="15a2", ATTRS{idProduct}=="0061", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="15a2", ATTRS{idProduct}=="0063", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="15a2", ATTRS{idProduct}=="0071", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="15a2", ATTRS{idProduct}=="007d", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="15a2", ATTRS{idProduct}=="0080", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="1fc9", ATTRS{idProduct}=="0128", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="1fc9", ATTRS{idProduct}=="0126", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="1fc9", ATTRS{idProduct}=="0135", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="1fc9", ATTRS{idProduct}=="0134", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="1fc9", ATTRS{idProduct}=="012b", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0525", ATTRS{idProduct}=="b4a4", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0525", ATTRS{idProduct}=="b4a4", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0525", ATTRS{idProduct}=="b4a4", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="3016", ATTRS{idProduct}=="1001", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="3016", ATTRS{idProduct}=="1001", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="066f", ATTRS{idProduct}=="9afe", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="066f", ATTRS{idProduct}=="9bff", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0525", ATTRS{idProduct}=="a4a5", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="18d1", ATTRS{idProduct}=="0d02", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="3016", ATTRS{idProduct}=="0001", TAG+="uaccess"

Put above udev run into /etc/udev/rules.d/70-uuu.rules and update udev-rules.

This can be achieved running the following two commands:

sudo sh -c "uuu -udev >> /etc/udev/rules.d/70-uuu.rules"
sudo udevadm control --reload

Usage

UUU uses the android fastboot protocol. The usual way to flash our modules is to start the mfg-uboot, write the default u-boot into eMMC and then flash the Boot-partition and Rootfs as filesystem image.

Tip

You can use pre-compiled images and scripts from our Customer Area or your own Yocto built images.

Running uuu

On Windows 10 or Linux uuu will work fine. For Windows 7 see Running UUU on Windows 7.

  1. Put the bootmode jumper in place (for Help see Enabling USB-Bootmode) and connect your module via OTG-programming port of the baseboard.

  2. Get terminal access. If you need help for this see TTL Converter Terminal Connection.

  1. Open a command line inside the folder where uuu is and run the following command to use the before created script:

uuu -v <script-file>

Tip

Inside your terminal you should now see progress and information while uuu is programming your module.

UUU with Custom Files

Creating Filesystems

For e.g. the /boot partition you can create an own filesystem image. The example below gives you an idea how this is done.

It also shows you how existing filesystems can be mounted.

dd if=/dev/zero of=bootfs.fat bs=1M count=0 seek=32
mkfs -t vfat bootfs.fat
sudo mount -o loop bootfs.fat /mnt/temp/
sudo cp Image imx8mn-tx8m-nd00-mipi-mb.dtb /mnt/temp/
sudo umount /mnt/temp

Script Examples 1

Hint

Some commands differ depending on the module you are using.

Module

Loading bootloader command-set

Comments

tx8m-1610

 
SDP: boot -f <mfg-uboot>
SDPV: write -f <mfg-boot> -offset 0x57c00
SDPV: jump

tx8m-1620

 
SDP: boot -f <mfg-uboot>
SDPV: write -f <mfg-boot> -offset 0x57c00
SDPV: jump

tx8m-nd00

 
SDPS: boot -f <mfg-uboot>
SDPV: write -f <mfg-boot> -offset 0x57c00
SDPV: jump

UUU has a problem recognizig the device at the first start - you will see an error. After this just run uuu -v again and it will work. You can also start uuu in Daemon mode uuu -v -d to prevent this.

tx8p-ml81

 
SDPS: boot -f <mfg-uboot>

tx8p-ml82

 
SDPS: boot -f <mfg-uboot>

qsxp-ml81

 
SDPS: boot -f <mfg-uboot>

qsxm-mm60

 
SDP: boot -f <mfg-uboot>
SDPV: write -f <mfg-boot> -offset 0x57c00
SDPV: jump

qs8m-mq00

 
SDP: boot -f <mfg-uboot>
SDPV: write -f <mfg-boot> -offset 0x57c00
SDPV: jump

qs8m-nd00

 
SDPS: boot -f <mfg-uboot>
SDPV: write -f <mfg-boot> -offset 0x57c00
SDPV: jump

UUU has a problem recognizig the device at the first start - you will see an error. After this just run uuu -v again and it will work. You can also start uuu in Daemon mode uuu -v -d to prevent this.

Flashing U-Boot to eMMC

 1uuu_version 1.0.1
 2
 3#
 4# author: Markus Bauer <mb@karo-electronics.de>
 5# (c) 2019
 6#
 7# This file flashes default u-boot to your TX8M
 8
 9### boot uboot with fastboot support
10SDPS: boot -f imx-boot-tx8m-nd00-mipi-mb-mfg.bin-flash_tx8m
11SDPV: delay 1000
12SDPV: write -f imx-boot-tx8m-nd00-mipi-mb-mfg.bin-flash_tx8m -offset 0x57c00
13SDPV: jump
14
15### Writing default u-boot to emmc
16FB: ucmd setenv emmc_dev 0
17FB: ucmd setenv fastboot_dev mmc
18FB: ucmd setenv mmcdev ${emmc_dev}
19FB: ucmd mmc dev ${emmc_dev}
20FB: flash bootloader imx-boot-tx8m-nd00-mipi-mb-default.bin-flash_tx8m
21FB: ucmd mmc partconf ${emmc_dev} 1 1 0
22
23FB: done

Flashing filesystems

 1uuu_version 1.0.1
 2
 3#
 4# author: Markus Bauer <mb@karo-electronics.de>
 5# (c) 2019
 6#
 7# This file flashes desktop release (QT from Yocto) and bootfs to your TX8M
 8
 9### Boot our uboot with fastboot support
10SDPS: boot -f imx-boot-tx8m-nd00-mipi-mb-mfg.bin-flash_tx8m
11SDPV: delay 1000
12SDPV: write -f imx-boot-tx8m-nd00-mipi-mb-mfg.bin-flash_tx8m -offset 0x57c00
13SDPV: jump
14
15### GPT partition layout
16#
17# 32M /boot
18# MAX /
19FB: ucmd setenv partitions 'uuid_disk=${uuid_gpt_disk};name=boot,size=32M,start=1MiB,uuid=${uuid_boot};name=rootfs,size=MAX,uuid=0cc66cc0-5458-384d-1610-726f6f746673;'
20FB: ucmd gpt write mmc 0 ${partitions}
21
22### force re-read partition table
23FB: ucmd setenv fastboot_dev sata
24FB: ucmd setenv fastboot_dev mmc
25
26### Flashing partitions
27FB: flash boot bootfs.fat
28FB: flash -raw2sparse rootfs fsl-image-qt5.rootfs.ext4
29
30FB: done

Note

Run man fastboot on your host to see which possibilities you have with FB: command in uuu.

Importing environment

 1uuu_version 1.0.1
 2
 3#
 4# author: Markus Bauer <mb@karo-electronics.de>
 5# (c) 2019
 6#
 7# This file imports u-boot environment file.
 8# The entries into the file look like:
 9#
10# append_bootargs=quiet
11# {variable}={value}
12# ...
13#
14# The file has to end with a ZERO byte.
15
16### Boot our uboot with fastboot support
17SDPS: boot -f imx-boot-tx8m-nd00-mipi-mb-mfg.bin-flash_tx8m
18SDPV: delay 1000
19SDPV: write -f imx-boot-tx8m-nd00-mipi-mb-mfg.bin-flash_tx8m -offset 0x57c00
20SDPV: jump
21
22### Importing u-boot environment
23FB: ucmd setenv fastboot_buffer ${loadaddr}
24FB: download -f emmc-boot.env
25FB: ucmd env default -a
26FB: ucmd env import ${loadaddr}
27FB: ucmd printenv
28FB: ucmd saveenv
29
30FB: done
1

Further information about uuu, and the official documentation can be found in uuu.pdf