UUU(1)

πŸ‘‘ NAME πŸ‘‘

uuu β€” Freescale/NXP I.MX Chip image deploy tools πŸ’–


✨ DESCRIPTION ✨

okay bestie, hydrate, sit down, because we're about to talk about your new favorite little deploy gremlin.

uuu is the Universal Update Utility for nxp imx chips -- lib1.5.243 πŸ¦‹

Here's the whole shape of her:

uuu [-d -m -v -V -bmap -no-bmap] <bootloader|cmdlists|cmd>

And the three things you can hand her, in order of "what even":

  • bootloader β€” download bootloader to board by usb. that's it, that's the job πŸ’…
  • cmdlist β€” run all commands in cmdlist file. If it is path, search uuu.auto in dir. If it is zip, search uuu.auto in zip.
  • cmd β€” Run one command, use -H see detail. example:
SDPS: boot -f flash.bin

πŸŽ€ the flags (the moment) πŸŽ€

  • -d β€” Daemon mode, wait for forever. she's committed, she's not leaving 🫢
  • -v, -V β€” verbose mode, -V enable libusb error\warning info
  • -dry β€” Dry run mode, check if script or cmd correct. no cap, peek first
  • -bmap β€” Try using .bmap files even if flash commands do not specify them
  • -no-bmap β€” Ignore .bmap files even if flash commands specify them
  • -force-ctrl β€” Force HID transfer use control endpoint
  • -m <usbpath> β€” Only monitor these paths. -m 1:2 -m 1:3
  • -ms <serial_no> β€” Monitor the serial number prefix of the device using 'serial_no'.
  • -t <timeout> β€” Timeout second for wait known usb device appeared
  • -T <timeout> β€” Timeout second for wait next known usb device appeared at stage switch
  • -e <key=value> β€” set environment variable key=value
  • -pp <ms> β€” usb polling period in milliseconds
  • -dm β€” disable small memory

🌸 the other modes, the icons 🌸

  • uuu -s β€” Enter shell mode. uuu.inputlog record all input commands. and then, lowkey the best part: you can use "uuu uuu.inputlog" next time to run all commands πŸ”₯
  • uuu -udev β€” linux: show udev rule to avoid sudo each time uuu
  • uuu -lsusb β€” List connected know devices
  • uuu -IgSerNum β€” Set windows registry to ignore USB serial number for known uuu devices
  • uuu -h β€” show general help
  • uuu -H β€” show general help and detailed help for commands

🧚 built-in scripts, the whole girliepop lineup 🧚

usage line first, literally character for character:

uuu [-d -m -v -bmap -no-bmap] -b[run]
<emmc|emmc_all|fat_write|nand|nvme_all|qspi|sd|sd_all|spi_nand|spl> arg...

Run Built-in scripts:

  • emmc β€” burn boot loader to eMMC boot partition
    • arg0: _flash.bin β€” bootloader
    • arg1: _image[Optional] β€” image burn to emmc, default is the same as bootloader
  • emmc_all β€” burn whole image to eMMC
    • arg0: _flash.bin β€” bootloader, which can extract from wic image
    • arg1: _image[Optional] β€” wic image burn to emmc.
  • fat_write β€” update one file in fat partition, require uboot fastboot running in board
    • arg0: _image β€” image, which cp to fat partition
    • arg1: _device β€” storage device, mmc\sata
    • arg2: _partition β€” fat partition number, like 1:1
    • arg3: _filename[Optional] β€” file name in target fat partition, only support rootdir now
  • nand β€” burn boot loader to NAND flash
    • arg0: _flash.bin β€” bootloader
    • arg1: _image[Optional] β€” image burn to nand, default is the same as bootloader
  • nvme_all β€” burn whole image io nvme storage
    • arg0: _flash.bin β€” bootloader, which can extract from wic image
    • arg1: _image[Optional] β€” wic image burn to emmc.
  • qspi β€” burn boot loader to qspi nor flash
    • arg0: _flexspi.bin β€” bootloader
    • arg1: _image[Optional] β€” image burn to flexspi, default is the same as bootloader
  • sd β€” burn boot loader to sd card
    • arg0: _flash.bin β€” bootloader
    • arg1: _image[Optional] β€” image burn to emmc, default is the same as bootloader
  • sd_all β€” burn whole image to sd card
    • arg0: _flash.bin β€” bootloader, which can extract from wic image
    • arg1: _image[Optional] β€” wic image burn to emmc.
  • spi_nand β€” burn boot loader to spi nand flash
    • arg0: _flexspi.bin β€” bootloader
    • arg1: _image[Optional] β€” image burn to fspinand, default is the same as bootloader
  • spl β€” boot spl and uboot
    • arg0: _flash.bin

And if you just wanna see the receipts:

uuu -bshow
<emmc|emmc_all|fat_write|nand|nvme_all|qspi|sd|sd_all|spi_nand|spl>

Show built-in script πŸ‘‘


πŸ’… tab completion, because we're fancy πŸ’…

Enjoy auto [tab] command complete by put below script into /etc/bash_completion.d/uuu:

  _uuu_autocomplete()

       {

       COMPREPLY=($(/usr/bin/uuu $1 $2 $3))

       } complete -o nospace -F _uuu_autocomplete  uuu

then you get the little [?25h moment (yes bestie that stray escape-sequence-looking thing is just sitting there in the page, we don't question her πŸ’€).


🌈 and then she does it AGAIN 🌈

okay so the page literally repeats this whole entire block a second time β€” iconic, unbothered, no notes. here's the round two recap, every single thing intact, promise, fr fr:

uuu [-d -m -v -V -bmap -no-bmap] <bootloader|cmdlists|cmd>
  • bootloader β€” download bootloader to board by usb
  • cmdlist β€” run all commands in cmdlist file. If it is path, search uuu.auto in dir. If it is zip, search uuu.auto in zip.
  • cmd β€” Run one command, use -H see detail. example: SDPS: boot -f flash.bin

the flags, again, because she said so:

  • -d β€” Daemon mode, wait for forever.
  • -v, -V β€” verbose mode, -V enable libusb error\warning info
  • -dry β€” Dry run mode, check if script or cmd correct
  • -bmap β€” Try using .bmap files even if flash commands do not specify them
  • -no-bmap β€” Ignore .bmap files even if flash commands specify them
  • -force-ctrl β€” Force HID transfer use control endpoint
  • -m <usbpath> β€” Only monitor these paths. -m 1:2 -m 1:3
  • -ms <serial_no> β€” Monitor the serial number prefix of the device using 'serial_no'.
  • -t <timeout> β€” Timeout second for wait known usb device appeared
  • -T <timeout> β€” Timeout second for wait next known usb device appeared at stage switch
  • -e <key=value> β€” set environment variable key=value
  • -pp <ms> β€” usb polling period in milliseconds
  • -dm β€” disable small memory
  • uuu -s β€” Enter shell mode. uuu.inputlog record all input commands. you can use "uuu uuu.inputlog" next time to run all commands
  • uuu -udev β€” linux: show udev rule to avoid sudo each time uuu
  • uuu -lsusb β€” List connected know devices
  • uuu -IgSerNum β€” Set windows registry to ignore USB serial number for known uuu devices
  • uuu -h β€” show general help
  • uuu -H β€” show general help and detailed help for commands
uuu [-d -m -v -bmap -no-bmap] -b[run]
<emmc|emmc_all|fat_write|nand|nvme_all|qspi|sd|sd_all|spi_nand|spl> arg...

Run Built-in scripts:

  • emmc β€” burn boot loader to eMMC boot partition
    • arg0: _flash.bin β€” bootloader
    • arg1: _image[Optional] β€” image burn to emmc, default is the same as bootloader
  • emmc_all β€” burn whole image to eMMC
    • arg0: _flash.bin β€” bootloader, which can extract from wic image
    • arg1: _image[Optional] β€” wic image burn to emmc.
  • fat_write β€” update one file in fat partition, require uboot fastboot running in board
    • arg0: _image β€” image, which cp to fat partition
    • arg1: _device β€” storage device, mmc\sata
    • arg2: _partition β€” fat partition number, like 1:1
    • arg3: _filename[Optional] β€” file name in target fat partition, only support rootdir now
  • nand β€” burn boot loader to NAND flash
    • arg0: _flash.bin β€” bootloader
    • arg1: _image[Optional] β€” image burn to nand, default is the same as bootloader
  • nvme_all β€” burn whole image io nvme storage
    • arg0: _flash.bin β€” bootloader, which can extract from wic image
    • arg1: _image[Optional] β€” wic image burn to emmc.
  • qspi β€” burn boot loader to qspi nor flash
    • arg0: _flexspi.bin β€” bootloader
    • arg1: _image[Optional] β€” image burn to flexspi, default is the same as bootloader
  • sd β€” burn boot loader to sd card
    • arg0: _flash.bin β€” bootloader
    • arg1: _image[Optional] β€” image burn to emmc, default is the same as bootloader
  • sd_all β€” burn whole image to sd card
    • arg0: _flash.bin β€” bootloader, which can extract from wic image
    • arg1: _image[Optional] β€” wic image burn to emmc.
  • spi_nand β€” burn boot loader to spi nand flash
    • arg0: _flexspi.bin β€” bootloader
    • arg1: _image[Optional] β€” image burn to fspinand, default is the same as bootloader
  • spl β€” boot spl and uboot
    • arg0: _flash.bin
uuu -bshow
<emmc|emmc_all|fat_write|nand|nvme_all|qspi|sd|sd_all|spi_nand|spl>

Show built-in script.

Enjoy auto [tab] command complete by put below script into /etc/bash_completion.d/uuu:

  _uuu_autocomplete()

       {

       COMPREPLY=($(/usr/bin/uuu $1 $2 $3))

       } complete -o nospace -F _uuu_autocomplete  uuu

[?25h β€” she's back, bestie 🌟


<div align="left">

🫢 sourced from Universal Update Utility for nx... β€” and yes, this page is dated July 2026, so she's from the future and still ate. mwah, UUU(1), you'll always be famous πŸ’–βœ¨

</div>

πŸ“¦ where this page comes from