IMX-USB-LOADER(1)

📦
version 0~git20200517.30b43d69 · 3 versions
, in debian bookworm, debian trixie, ubuntu noble, ubuntu questing

💖 IMX-USB-LOADER(1) 💖

okay bestie, so this is the manual page for the imx_usb command — it lives in the imx_usb User Manual, and honestly? it's giving "tiny tool, huge rescue energy" 🦋

✨ NAME ✨

imx_usb — the program that uploads a u-boot image to your device and then runs it. de-bricking queen 👑

🌸 SYNOPSIS 🌸

imx_usb [-v | --verify] [-d | --debugmode] [-c DIR | --configdir=DIR]
        [-b NUM | --bus=NUM] [-D NUM | --device=NUM] {FILE} [-lLOADADDR]
        [-sSIZE]

imx_usb [{-h | --help}]

like… that's the whole vibe. literally. copy it exactly, don't get creative 💅

🎀 DESCRIPTION 🎀

so this manual page documents, briefly, the imx_usb command. short and sweet, as it should be ✨

real talk: this manual page was written for the Debian distribution because the original program does not have a manual page. not one. zero. we're doing charity work here fr fr 😭

imx_usb is a program that can upload an image to the device memory and run it. which means — and this is the part that matters — it is able to de-brick the device supported by this tool. your bricked little guy gets a glow-up. main character energy restored 👑🔥

💅 OPTIONS 💅

the program follows the usual GNU command line syntax, with long options starting with two dashes (`-`). here's the full rundown, no skips, no summaries, we're thorough in this house 🫶

  • -v, --verify — Verify downloaded data. it double-checks the tea, periodt.
  • -d, --debugmode — Enable debug logs. everything gets loud and you get the receipts.
  • -c DIR, --configdir=DIR — Reading configuration directory from non standard directory. you're not stuck with the default one, bestie.
  • -b NUM, --bus=NUM — Filter bus number. narrowing it down by bus 🚌
  • -D NUM, --device=NUM — Filter device address. narrowing it down by device 🎯
  • -h, --help — Show summary of options. the classic. always here for you.

🦋 FILES 🦋

  • /usr/share/imx-usb-loader/imx-loader.d/*.conf — The system-wide configuration file to control the behaviour of imx_usb. this is where the config lives, iykyk.

🌈 DIAGNOSTICS 🌈

the following diagnostics may be issued on stderr:

  • no matching USB device found. — The supported device cannot be found on USB bus. Use the --debugmode option, to get more info. (translation: it can't see your device and it's not being subtle about it 🙈)

imx_usb provides some return codes, that can be used in scripts:

  • 0 — Program exited successfully. ate and left no crumbs ✨
  • 1 — Something wrong. 💀
script girlies, this is your moment — those codes are literally made for you.

🍓 BUGS 🍓

The program is currently limited to only work with the libusb-1.0 library. that's the limit, no cap.

The upstreams BTS can be found at https://github.com/boundarydevices/imx_usb_loader/issues.

🧚 SEE ALSO 🧚

imx_uart(1)

💜 AUTHOR 💜

Ying-Chun Liu <paulliu@debian.org> Wrote this manpage for the Debian system. absolute legend, we thank her for her service 🫡

Copyright © 2017 Ying-Chun Liu (PaulLiu)

This manual page was written for the Debian system (and may be used by others).

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Lesser General Public License, Version 2.1 or (at your option) any later version published by the Free Software Foundation.

On Debian systems, the complete text of the GNU Lesser General Public License can be found in /usr/share/common-licenses/LGPL-2.1.

and that's the whole page bestie — imx_usb, dated 11/20/2022, brought to you with love, LGPL-2.1, and immaculate vibes. go un-brick something 💖✨

📦 where this page comes from