====== NXP UUU (Universal Update Utility) ======
The UUU (Universal Update Utility is an open source programm provided by NXP, it is the successor of NXP's MFG Tools, intended to download and execute code on i.MX SoC family via the Serial Download Protocol (SDP).
Documentation, source code and prebuild releases are available via the [[https://github.com/NXPmicro/mfgtools|NXP mfgtools github repository]].
\\

===== Prerequisites =====
1. Download the latest release from Universal Update Utility repository or build it from source 
  * [[https://github.com/NXPmicro/mfgtools/releases|Prebuild releases]]
  * [[https://github.com/NXPmicro/mfgtools#how-to-build|Build from source ]]
2. <label mod_name>MOD_NAME</label> BSP built following the [[<label lang>LANG</label>:<label mod_arch>MOD_ARCH</label>:<label mod_name>MOD_NAME</label>:<label bsp_name>BSP_NAME</label>:<label build_system>BUILD_SYSTEM</label>:quickstart_yocto|BSP quickstart instructions.]]
\\
==== Download a Prebuild UUU Release Version ====
A prebuild UUU release version can be downloaded from the [[https://github.com/NXPmicro/mfgtools/releases|UUU git repository]].
<callout type="info" icon="true">It is recommended to use the latest avialable release.</callout>

\\
==== Building the Universal Update Utility from source ====
The Universal Update Utility (UUU) tool can be compiled manually. The build instructions for Linux, Windows are available in the UUU documentation: 
  * [[https://github.com/NXPmicro/mfgtools#linux|Linux]]
  * [[https://github.com/NXPmicro/mfgtools#windows|Windows]]

\\
==== U-Boot Binary ====
A U-Boot binary with the U-Boot configuration <label uuu_uboot_conf>UUU_UBOOT_CONF</label> is required to use the UUU. This particular U-Boot will be built during the <label mod_name>MOD_NAME</label> Yocto BSP build process and is located in the build directory deploy folder named <label uuu_uboot_binary>UUU_UBOOT_BINARY</label>. 

\\
===== Usage =====
<callout type="info" icon="true">
The syntax of the UUU tool is identical for Windows and Linux.\\  In Windows **uuu.exe** has to be used while in Linux the uuu binary has no file extension.
</callout>
==== Prepare Host Computer ====
For the sake of siplicity, copy the following components to a new folder e.g. in your home directory:
  * UUU binary (manually compiled or prebuilt release)
  * U-Boot binary with UUU configuration <label uuu_uboot_binary>UUU_UBOOT_BINARY</label>
  * SD / eMMC image for example the default image <label mtq_default_image>MTQ_DEFAULT_IMAGE</label>
The following commands are executed in the folder containing the tool and the binaries. 
\\
\\
==== Prepare <label stk_name>STK_NAME</label> ====
  * Set the <label stk_name>STK_NAME</label> DIP switches to Serial Downloader Mode ([[<label lang>LANG</label>:<label mod_arch>MOD_ARCH</label>:<label mod_name>MOD_NAME</label>:<label mb_name>MB_NAME</label>:dip_switches|See DIP-Switch Settings]])
  * Connect <label stk_name>STK_NAME</label> via connector <label stk_serial_dl_connector>STK_SERIAL_DL_CONNECTOR</label> to the Host Computer
\\
==== List detected devices ====
After connecting the kit, it should be automatically detected when it is in serial downloader mode.
Run the following command to list all detected devices:
<code>uuu -lsusb</code>
\\
==== Start U-Boot over Serial Downloader ====
To load the U-boot binary into the RAM and start it from there use the command below:
<code>uuu <u-boot binary></code>
**Example for the <label stk_name>STK_NAME</label>:**
<code>uuu <label uuu_uboot_binary>UUU_UBOOT_BINARY</label></code>
\\
==== Program U-Boot over Serial Downloader ====
Use the following command to program a U-Boot binary into the eMMC.    

<code>uuu -b emmc <u-boot binary></code>
**Example for the <label stk_name>STK_NAME</label>:**
<code>uuu -b emmc <label uuu_uboot_binary>UUU_UBOOT_BINARY</label></code>
\\

**Use a custom workflow:**\\  
For a custom workflow uuu commands can be listed in a cmdlist file. The following example shows how to program a wic image to eMMC user area, without writing the bootstream to the eMMC boot partition. 

<callout type="warning" icon="true">Following example is tested with uuu version 1.5.4.</callout>

**Example cmdlist file on <label stk_name>STK_NAME</label>:**

For the sake of simplicity, create the cmdlist file in the same location as the uuu executable. For example uuu.<label mod_name_code>MOD_NAME_CODE</label>

<code>
uuu_version 1.5.4

SDPS: delay 500
SDPS: @ boot -f @BOOTSTREAM@
SDPS: delay 1000
FB: ucmd setenv fastboot_dev mmc
FB: ucmd setenv mmcdev ${emmc_dev}
FB: ucmd mmc dev ${emmc_dev}
FB: @ flash -raw2sparse all @WICIMAGE@
FB: done
</code>

**Example command for the <label stk_name>STK_NAME</label> using custom cmdlist:** 
<code>uuu -e BOOTSTREAM=<bootstream for uuu> -e WICIMAGE=<wic image for eMMC> uuu.<label mod_name_code>MOD_NAME_CODE</label></code>

<code>uuu -e BOOTSTREAM=<label uuu_uboot_binary>UUU_UBOOT_BINARY</label> -e WICIMAGE=<label mtq_default_image>MTQ_DEFAULT_IMAGE</label> uuu.<label mod_name_code>MOD_NAME_CODE</label></code>

----