Freescale/NXP I.MX Chip image deploy tools. original linux version uses "linux" branch, windows version uses "windows" branch
uuu (universal update utility) for nxp imx chips -- libuuu-1.0.1-gffd9837
Succeded:0 Failed:3 Wait for Known USB Devices to Appear...
1:11 5/5 [ ] SDP: jump -f u-boot-dtb.imx -ivtinitramf....
2:1 1/5 [===> ] SDP: boot -f u-boot-imx7dsabresd_sd.imx ....
- The real cross platform. Linux, Windows, MacOS(not test yet)
- Multi devices program support
- Daemon mode support
- Few dependencies (only libusb, zlibc, libbz2)
- Firmware (uboot/kernel) uses WCID to auto load the winusb driver on the Windows side. Windows7 users need to install the winusb driver from https://zadig.akeo.ie/ Windows10 will install the driver automatically.
uuu u-boot.imx Download u-boot.imx via HID device
uuu list.uu Run all the commands in list.uu
uuu -s Enter shell mode. Input command.
uuu -v u-boot.imx verbose mode
uuu -d u-boot.imx Once it detects the attachment of a known device, download boot.imx.
u-boot.imx can be replaced, new file will be download once board reset.
Do not unplug the SD card, write to the SD card, nor plug in a SD card when debugging uboot.
uuu -b emmc u-boot.imx write u-boot.imx to emmc boot partition. u-boot.imx need enable fastboot
uuu -b emmc_all wic.zst decompress wic.zst file and download the whole image into emmc
The prebuilt image and document are here:
- https://github.com/nxp-imx/mfgtools/releases
- ubuntu 22.04, 'apt-get install uuu'
- UUU.pdf is snapshot of wiki
git clone --recurse-submodules https://github.com/nxp-imx/mfgtools.gitcd mfgtoolsopen msvs/uuu.sln with Visual Studio 2017
Visual Studio
Note that, since uuu is an OSI compliant Open Source project, you are entitled to download and use the freely available Visual Studio Community Edition to build, run or develop for uuu. As per the Visual Studio Community Edition license this applies regardless of whether you are an individual or a corporate user.
git clone https://github.com/nxp-imx/mfgtools.gitcd mfgtoolssudo apt-get install libusb-1.0-0-dev libbz2-dev libzstd-dev pkg-config cmake libssl-dev g++ zlib1g-dev libtinyxml2-devcmake . && make
The above commands build mfgtools in source. To build it out of source (requires cmake 3.13 or newer):
cmake -S . -B buildcmake --build build --target all
For cmake prior 3.13:
mkdir build && cd buildcmake .. && make
git clone https://github.com/nxp-imx/mfgtools.gitcd mfgtoolsbrew install cmake libusb openssl pkg-config tinyxml2cmake -DOPENSSL_ROOT_DIR=$(brew --prefix)/opt/openssl . && make
Note that we assume brew is installed and can be used to resolve dependencies as shown above. The remaining dependency libbz2 can be resolved via the XCode supplied libraries.
Note if you meet "can't detach kernel driver" try to check libusb version.
brew info libusb
==> libusb: stable 1.0.26 (bottled), HEAD
- Windows 10 64 bit
- Linux (Ubuntu) 64 bit
- macOS (Catalina)
- 32 bit systems will have problems with big files.
uuu is licensed under the BSD license. See LICENSE. The BSD licensed prebuilt Windows binary version of uuu is statically linked with the LGPL libusb library, which remains LGPL.
- bzip2 (BSD license) is from https://sourceware.org/git/bzip2.git
- zlib (zlib license) is from https://github.com/madler/zlib.git
- libusb (LGPL-2.1) is from https://github.com/libusb/libusb.git
- zstd (Dual BSD\GPLv2 Licenses) is from https://github.com/facebook/zstd
- tinyxml (zlib license) is from https://github.com/leethomason/tinyxml2
Release date: 2021-02-04
Release date: 2020-03-23
Release date: 2020-02-12
Release date: 2020-02-04
Release date: 2019-12-26
normal usage: $ uuu -b cmd_type parameter1 parameter2 parameter3
cmd_type:
- emmc_imx6_img : Avaible CPU TYPE => iMX6Q and iMX6DL
- emmc_imx7_img : Avaible CPU TYPE => iMX7D
- emmc_imx6ul_img : Avaible CPU TYPE => iMX6UL and iMX6ULL
parameter1 : secondary program loader (SPL) parameter2 : universal boot loader (u-boot.img) parameter3 : system image without compressing which generated by Yocto
imx6 example: $ suod PATH_TO/uuu -b emmc_imx6_img imx6-SPL imx6-u-boot.img fsl-image-qt5-validation-imx-pico-imx6-xxxxxx.rootfs.sdcard or $ sudo PATH_TO/uuu -b emmc_imx6_img imx6-SPL imx6-u-boot.img fsl-image-qt5-validation-imx-pico-imx6-xxxxxx.rootfs.sdcard.bz2/*
imx7 example: $ sudo PATH_TO/uuu -b emmc_imx7_img imx7-SPL imx7-u-boot.img fsl-image-qt5-validation-imx-pico-imx7-xxxxxx.rootfs.sdcard or $ sudo PATH_TO/uuu -b emmc_imx7_img imx7-SPL imx7-u-boot.img fsl-image-qt5-validation-imx-pico-imx7-xxxxxx.rootfs.sdcard.bz2/*
imx6ul example: $ sudo PATH_TO/uuu -b emmc_imx6ul_img imx6ul-SPL imx6ul-u-boot.img fsl-image-qt5-validation-imx-pico-imx6ul-xxxxxx.rootfs.sdcard or $ sudo PATH_TO/uuu -b emmc_imx6ul_img imx6ul-SPL imx6ul-u-boot.img fsl-image-qt5-validation-imx-pico-imx6ul-xxxxxx.rootfs.sdcard.bz2/*
multiboard usage:
-
copy all of binaries you need include xxx-SPL, xxx-u-boot.img, fsl-image-xxx.rootfs.sdcard into multiboard folder
-
change file name to specific name for script recognize. for iMX6 iMX7 iMX6UL iMX6ULL xxx-SPL => _SPL xxx-u-boot.img => _UBOOT fsl-image-xxx.rootfs.sdcard => _rootfs.sdcard for iMX8MQ iMX8M-mini xxx-imx8mx-xxx.bin => _flash.bin fsl-image-xxx.rootfs.sdcard => _rootfs.sdcard
-
change directory to multiboard $ ../uuu/linux64/uuu -d xxxx.auto
imx6 multiboard example $ cp imx6/imx6-SPL multiboard/_SPL; cp imx6/imx6-u-boot.img multiboard/_UBOOT; cp path_to/fsl-image-xxx.rootfs.sdcard /multiboard/_rootfs.sdcard $ cd multiboard $ sudo ../uuu/linux64/uuu -d emmc_imx6_img.auto
imx8mm multiboard example $ cp imx8mm/pico-imx8mm-flash.bin multiboard/_flash.bin; cp path_to/fsl-image-xxx.rootfs.sdcard /multiboard/_rootfs.sdcard $ cd multiboard $ sudo ../uuu/linux64/uuu -d emmc_img.auto
For more details information and iMX8 series please refer to the following website https://github.com/TechNexion/u-boot-tn-imx/wiki/Use-mfgtool-%22uuu%22-to-flash-eMMC