USB & UART loader for i.MX5/6/7/8 series
Switch branches/tags
Nothing to show
Clone or download
eduardoabinader and gibsson imx_uart: fix type on help
Signed-off-by: Eduardo Abinader <>
Latest commit 4aa9809 Nov 5, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
msvc Add Visual Studio 2015 project file for imx_usb Dec 7, 2016
tests tests: update tests since now J_HEADER=3 Apr 25, 2018
.gitignore introduce tests Apr 2, 2018
COPYING COPYING: the license is LGPLv2.1, not GPLv3 Sep 25, 2014
Makefile move SDP client-side emulation to separate compile unit Apr 25, 2018
Makefile.mingw Add Makefile for MinGW Dec 7, 2016 README: Include i.MX7 in the supported list of SoCs Oct 9, 2017
image.h resync image.h with U-Boot v2017.09 Sep 13, 2017
imx_loader.h bump version to 0.2pre Apr 2, 2018
imx_loader_config.c remove default load address Apr 25, 2018
imx_loader_config.h move config file parsing in separate file Apr 24, 2018
imx_sdp.c treat plug-in field in boot data as flags May 4, 2018
imx_sdp.h move work handling to imx_sdp Apr 25, 2018
imx_sdp_simulation.c move SDP client-side emulation to separate compile unit Apr 25, 2018
imx_sdp_simulation.h move SDP client-side emulation to separate compile unit Apr 25, 2018
imx_uart.c imx_uart: fix type on help Nov 5, 2018
imx_usb.c imx_usb: fix type on imx_usb help Nov 5, 2018
imx_usb.conf add mx6ull_usb_work.conf Aug 9, 2018
mx50_usb_work.conf Add DCD loading address parameter in conf file Sep 26, 2016
mx51_usb_work.conf Add DCD loading address parameter in conf file Sep 26, 2016
mx53_usb_work.conf mx53_usb_work.conf: change crlf to lf Sep 28, 2016
mx6_usb_sdp_spl.conf add U-Boot header example Sep 13, 2017
mx6_usb_work.conf imx_loader_config: rename jump_script to jump_direct Apr 25, 2018
mx6ull_usb_work.conf mx6ull_usb_work.conf: fix copy/paste error in comment Aug 9, 2018
mx7_usb_work.conf Add DCD loading address parameter in conf file Sep 26, 2016
mx7ulp_usb_work.conf mx7ulp_usb_work.conf: Add support for i.MX7ULP device Sep 13, 2017
mx8mq_usb_work.conf mx8mq_usb_work.conf: use files so magic addresses aren't needed Jun 8, 2018
portable.h portable: use __builtin_bswap16 for BE16 if >= 4.8 GNUC Aug 10, 2018
vybrid_usb_work.conf Add DCD loading address parameter in conf file Sep 26, 2016


i.MX/Vybrid recovery utility


This utility allows to download and execute code on Freescale i.MX5/i.MX6/i.MX7 and Vybrid SoCs through the Serial Download Protocol (SDP). Depending on the board, there is usually some kind of recovery button to bring the SoC into serial download boot mode, check documentation of your hardware.

The utility support USB and UART as serial link.


  1. Clone
  2. Make sure libusb (1.0) is available
  3. Compile using make

Two binaries are available, imx_usb and imx_uart for the two supported connections.


Two variants have been tested successfully to build imx_usb and imx_uart on Windows:

  1. MinGW (using the Microsoft C runtime)
  2. Visual Studio 2015


MinGW allows to use the GNU toolchain (including GCC) to compile a native Microsoft Windows application. A MinGW specific make file (Makefile.mingw) is available which allows to build imx_usb/imx_uart with the native make port (mingw32-make.exe). After installing MinGW, make sure you have a compiled copy of libusb available and build imx_loader using:

mingw32-make -f Makefile.mingw LIBUSBPATH=C:\path\to\libusb

This dynamically links against libusb, hence make sure to ship the library libusb-1.0.dll along with imx_usb.exe.

Visual Studio

The subdirectory msvc/ contains the project files for Visual Studio 2015. Make sure you have the Visual C++ component installed. There is one solution containing two projects, one for imx_usb and one for imx_uart. The imx_usb project requires libusb to be present at ../../libusb (relative to the msvc) directory. If you use an alternative location or compile libusb from source too, you will have to alter the include/library path in the project settings.


libusb and pkg-config can be installed via Homebrew.

If imx_usb fails to claim interface, needs to be unloaded so libusb can claim, run:

sudo kextunload -b


Using USB, your device should be detected automatically using the USB VID/PID from imx_usb.conf. Using UART, the user has to specify a configuration file. This file is needed to use the correct protocol variant for the target device (transfer configuration). The configuration file can also contains work item(s).

Work items can also be defined using the command line. By specifying a file in the command line, the utility automatically uses this file as a work item and reads parameter from its header:

./imx_usb u-boot.imx

However, parameters can also specified manually, e.g.

./imx_usb u-boot.imx -l0x3f400400 -s370796 -v

The UART link uses hardware flow control using RTS/CTS, so make sure those are available. The imx_uart utility will configure the target tty with the right baud rate (115200) and flow control settings:

./imx_uart /dev/ttyUSB0 vybrid_usb_work.conf u-boot.imx