Search by Tags

iMX Recovery Mode

 
Subscribe for this article updates

Warning: Make sure there is no SD card inserted in the carrier board in order to enter recovery mode properly

On the Apalis iMX6 and Colibri iMX6, iMX7, iMX6ULL, the shared USB Client/Host port can be used to load Toradex Easy Installer and download a new OS image.

To do so successfully, it is necessary to perform the following steps.

  1. Unzip the Zip file in a local directory on a Windows or Linux host.
  1. Connect the Carrier Board USB OTG port to your Linux or Windows host machine

    • Apalis Evaluation Board

      Connect X49 or X50 (USBO1_CL/USBO1)

    • Ixora Carrier Board

      Connect to X9 on the underside of the Carrier Board. Be sure to remove JP2 in order to be able to use X9 in OTG Client mode.

  2. Enter recovery mode in one of this two ways:

    • Using hardware mechanism

      • Make sure the board is turned off.
      • Shorten the pads on the picture (e.g with tweezers) or if you have the Apalis iMX6 Mezzanine on the Apalis Evaluation Board, press the Recovery Mode button.


      • Power on the board.

    • Using a command in the bootloader

      • Connect the serial port UART1 of the carrier board with your host computer.

        • Apalis Evaluation Board

          Depending on JP10/12 connect the serial debug console to the lower X28 using a null modem RS-232 cable or X29 using a regular USB cable.

        • Ixora Carrier Board

          Connect the serial debug console to X22 using a null modem RS-232 cable and a 10 pin IDC to 9 pin D-sub male connector (DTK or Intel standard).

      • Open a terminal on your host computer (115200 baud, 8 data bits, no parity, one stop, no hardware/software flow control).

      • Power cycle the board and immediately press [space] on the terminal

      • If you are using U-Boot you should see the U-Boot banner and the prompt Apalis iMX6 #, in this case, type on the U-Boot command line:

        bmode usb
        
      • If you are using Eboot you should see a menu, in this case, type 'X' to enter the bootloader console, then on the Eboot command line:

        bootfrom usb
        reboot
        
  3. Use one of the following scripts on the host machine to download and run the Toradex Easy Installer through USB:

    • Windows: recovery-windows.bat
    • Linux: recovery-linux.sh
  1. Connect the Carrier Board USB OTG port to your Linux or Windows host machine

    • Colibri Evaluation Board

      Connect X29 or X30 (USB_CL/USB_OTG)

    • Iris Carrier Board

      Connect X12 micro USB (close to the Ethernet connector)

  2. Make sure that no SD card is in the SD card slot

  3. Enter recovery mode in one of this two ways:

    • Using hardware mechanism

      • Make sure the board is turned off.
      • Shorten the pads on the picture (e.g with tweezers).


      • Power on the board.

    • Using a command in the bootloader

      • Connect the serial port UART_A of the carrier board with your host computer.

        • Colibri Evaluation Board

          Depending on JP17/19 (and JP20/JP21 if you use a Carrier Board with V3.2 and later) connect the serial debug console to the bottom X25 using a null modem RS-232 cable or X27 using a regular USB cable.

        • Iris Carrier Board

          Connect the serial debug console to X13 using a null modem RS-232 cable and a 10 pin IDC to 9 pin D-sub male connector (DTK or Intel standard).

      • Open a terminal on your host computer (115200 baud, 8 data bits, no parity, one stop, no hardware/software flow control).

      • Power cycle the board and immediately press [space] on the terminal

      • If you are using U-Boot you should see the U-Boot banner and the prompt Colibri iMX6 #, in this case, type on the U-Boot command line:

        bmode usb
        
      • If you are using Eboot you should see a menu, in this case, type 'X' to enter the bootloader console, then on the Eboot command line:

        bootfrom usb
        reboot
        
  4. Use one of the following scripts on the host machine to download and run the Toradex Easy Installer through USB:

    • Windows: recovery-windows.bat
    • Linux: recovery-linux.sh

Note: Colibri iMX7 Solo/Dual 256/512MB V1.1A and older are not supported by Toradex Easy Installer.

Note: Colibri iMX7 Dual 1GB V1.1A and newer are using an eMMC flash and are supported by Toradex Easy Installer 1.2, 1.3 and 1.6 or newer.
Toradex Easy Installer 1.4 and 1.5 did now work reliably with these modules.

  1. Connect the Carrier Board USB OTG port to your Linux or Windows host machine

    • Colibri Evaluation Board

      Connect X29 or X30 (USB_CL/USB_OTG)

    • Iris Carrier Board

      Connect X12 micro USB (close to the Ethernet connector)

  2. Make sure that no SD card is in the SD card slot

  3. Enter recovery mode:

    • Colibri Evaluation Carrier Board

      • Make sure the board is turned off.
      • Press and hold the Recovery Mode button.
      • Power on the board while keep pressing the Recovery Mode button for additional 1-2 seconds.
    • Other Colibri Carrier Boards

      • Make sure the board is turned off.
      • Shorten the pads on the picture (e.g with tweezers).


      • Power on the board.

  4. Use one of the following scripts on the host machine to download and run the Toradex Easy Installer through USB:

    • Windows: recovery-windows.bat
    • Linux: recovery-linux.sh

Note: Colibri iMX6ULL 512MB Wi-Fi/Bluetooth are only supported by Toradex Easy Installer 1.3 and newer.

  1. Connect the Carrier Board USB OTG port to your Linux or Windows host machine

    • Colibri Evaluation Board

      Connect X29 or X30 (USB_CL/USB_OTG)

    • Iris Carrier Board

      Connect X12 micro USB (close to the Ethernet connector)

  2. Make sure that no SD card is in the SD card slot

  3. Enter recovery mode in one of this two ways:

    • Using hardware mechanism

      • Colibri Evaluation Carrier Board

        • Make sure the board is turned off.
        • Press and hold the Recovery Mode button.
        • Power on the board while keep pressing the Recovery Mode button for additional 1-2 seconds.
      • Other Colibri Carrier Boards

        • Make sure the board is turned off.
        • Shorten the pads on the picture (e.g with tweezers).

        • Power on the board.
    • Using a command in the bootloader

      • Connect the serial port UART_A of the carrier board with your host computer.

        • Colibri Evaluation Board

          Depending on JP17/19 (and JP20/JP21 if you use a Carrier Board with V3.2 and later) connect the serial debug console to the bottom X25 using a null modem RS-232 cable or X27 using a regular USB cable.

        • Iris Carrier Board

          Connect the serial debug console to X13 using a null modem RS-232 cable and a 10 pin IDC to 9 pin D-sub male connector (DTK or Intel standard).

      • Open a terminal on your host computer (115200 baud, 8 data bits, no parity, one stop, no hardware/software flow control).

      • Power cycle the board and immediately press [space] on the terminal

      • If you are using U-Boot you should see the U-Boot banner and the prompt Colibri iMX6ULL #, in this case, type on the U-Boot command line:

        bmode usb
        
  4. Use one of the following scripts on the host machine to download and run the Toradex Easy Installer through USB:

    • Windows: recovery-windows.bat
    • Linux: recovery-linux.sh

Note: If downloading gets stuck or fails with an error, try starting over from step 2. We have seen an issue with some USB 3.0 controllers during enumeration: If you use a USB 3.0 capable device, try connecting a USB 2.0 hub between the USB OTG port and your host.

Note: This does not write the Toradex Easy Installer to flash, it only loads it into the module's memory. You will have to redo these steps if you power off your module.

Note: During the recovery process the module connected via USB re-enumerates three times. This might cause multiple device detections on Windows. It also does not work well through virtualization since the individual re-enumerated USB devices get not routed through to the virtual machine guest automatically.

  1. You should see a User Interface appearing on DVI-I/HDMI, VGA or on the parallel RGB (Unified Interface Display) port. If you can't use any of these display options, you can access the same interface remotely using VNC. If you still have USB OTG connected the module provides a connection via USB RNDIS. The modules default IP address on USB RNDIS is 192.168.11.1.

Make sure that the module has Ethernet connected to a network which provides internet access. After some seconds you should see a list of Linux, WEC and Partner Demo images appearing.


  • TEZi images

    Toradex Easy Installer User Interface

To install an image, use a USB mouse to select and press the "Install (i)" button. You can also use a USB keyboard only: Use the arrows to select the image and press "i" to start the installation. Follow the instructions until installation begins. After the image has been successfully installed you should see the following message on your screen:


  • Toradex Easy Installer done

    Dialog after successful image installation

At this point, all data have been stored on internal flash and caches have been flushed (synced). It is not required to click on any of this three buttons, it is perfectly fine to just reset or turn off the system.