Flashing Guide for Ubuntu OS on I-Pi SMARC RB5

This document provides detailed information on flashing Ubuntu OS on the I-Pi SMARC RB5.

1. Prerequisites

  • A Windows PC (Windows 10/Windows 11) is required to flash the OS on the I-Pi SMARC RB5.

  • Please contact ipi.wiki@adlinktech.com for the image.

1.1. Download and Install ADB and Fastboot drivers

  1. Please download the ADB and Fastboot drivers and install them using the link provided below.

Note: If you encounter “0 Files Copied Error”, download and install the “15_Second_ADB_Installer_v1.3.0” version as the latest version might not be compatible with the Windows version of your computer.

1.2. Download QPST Tool and QUALCOMM USB Driver to Flash the Image

  1. Please download the driver below, which requires a QUALCOMM account with special privileges to access. To obtain new login access, please contact Qualcomm.

  2. USB driver: QUD.WIN.1.1 INSTALLER

  3. When installing the USB driver, please select the setup type as ETHERNET-DHCP.


  2. Please select Complete during installation as mentioned below.

  1. After installing QPST, the Qualcomm Flash Image Loader (QFIL) Tool will be installed on your PC. Please open the QFIL Tool (Search bar -> Application -> QFIL).

2. How to Flash the Image

To initiate the flashing process for the Ubuntu image, it is essential to first transition the module into Emergency Download (EDL) mode. Once the module is in EDL mode, the Ubuntu image can be flashed using either Qualcomm Flash Image Loader (QFIL) or Android Debug Bridge (ADB).

2.1. Enter into EDL(Emergency Download) Mode

  1. Micro USB.

  2. Power jack.

  3. UART Pins (See How to Read Console Output).

  4. F_DL button (requires removal of the heatsink).

  5. Follow these steps to enter into EDL mode.

  6. Press the F_DL Key Button on the module

  7. Hold the F_DL Key Button and power on the module by connecting the power cable.

  8. Release the F_DL Key Button and connect the Micro USB cable.

2.2. Flashing on Module (QFIL)

  1. The image being flashed contains the NON HIGH LEVEL OPERATING SYSTEM (NON-HLOS) firmware, boot-loader, kernel, and file-system.

  2. Please use the QFIL Tool and follow the steps below.

  3. Make sure image path is short in host PC from drive as below.

  4. Enter the module into Download mode (refer to section 2.0 for instructions).After LEC-RB5 Enters into EDL mode -> QFIL Tool will detect LEC-RB5 module as Qualcomm HS-USB QDLoader 9008.

  5. Open QFIL Tool ,click Select Port and make sure that the COM port is detected.

  6. Choose the Flat build option.

  7. In ‘Configuration’ menu, select **‘FireHose Configuration’ **and edit the configuration as shown in the image below.

  8. Go to the “Browse “ tab.

  9. select prog_firehose_ddr.elf

  10. Go to “LOAD XML” tab,select all .xml file.

  1. Click download.The QFIL start will process and notify download succeed,Once completed

Attention : After, the image flashed successfully, the target device automatically reset by itself. Don’t turn off (or) Reset the target device manually. It causes the image packages to break, resulting in the inability to boot.

  1. At this point, wait for the Ubuntu terminal to show up on the target HDMI.

  1. After this, Ubuntu desktop installation will start on the target and it could take around 30 minutes to complete. This is expected behaviour after flashing using QFIL tool. During the installation process, please do not turn off the module. Once installation is completed, we have ubuntu login on target HDMI. Proceed logging into Ubuntu Wayland desktop as detailed in 2.4. Logging in to Wayland Desktop.

2.3. Flashing on Module (ADB)

You can skip this section if you prefer to update the entire image using QFIL tool as detailed in section 2.1
If you wish to only update the Bootloader,kernel,Filesystem and not the NON-HLOS firmware, follow the steps below:

The image being flashed contains the kernel and file-system.
Please use the ADB Tool and follow the steps below.

  1. Image needed “qti-ubuntu-robotics-image-qrb5165-rb5-boot.img”, “qti-ubuntu-robotics-image-qrb5165-rb5-sysfs.ext4” and “abl.elf”.

  2. Image can found on path :

    FHD HDMI : /LEC-RB5-8G–UBUNTU_20_04_xx/LEC-RB5-8G-HLOS-UBUNTU_20_04_xx/LEC-RB5-8G-FHD-UBUNTU_20_04_xx/

    4K HDMI :/LEC-RB5-8G–UBUNTU_20_04_xx/LLEC-RB5-8G-HLOS-UBUNTU_20_04_xx/LEC-RB5-8G-4K-BUNTU_20_04_xx/

  3. Power on the Target board and connect the USB OTG/Micro USB between Target and Host PC.

  4. Open command prompt.

  5. Go to /LEC-RB5-8G–UBUNTU_20_04_xx/LEC-RB5-8G-HLOS-UBUNTU_20_04_xx/LEC-RB5-8G-FHD-UBUNTU_20_04_xx/ (for FHD).

  6. Check Target board (LEC-RB5) got detected using below command.

    $ cd /LEC-RB5-8G--UBUNTU_20_04_xx/LEC-RB5-8G-HLOS-  UBUNTU_20_04_xx/LEC-RB5-8G-FHD-UBUNTU_20_04_xx/
    $ adb devices

Note: In case the “#adb devices” command shows no device , please check your Device Manager for any yellow bang in the Qualcomm USB driver  for troubleshooting. Refer (2.3.1)

  1. Enter into ADB mode.

    $ adb root
    $ adb reboot bootloader
  2. Check module detected.

    $ fastboot devices

Note: In case of device not listed , please check device manager for yellow bang and update driver (refer 2.3.1).

  1. Enter into Fastboot mode.

    $ fastboot flash boot_a qti-ubuntu-robotics-image-qrb5165-rb5-boot.img
    $ fastboot flash boot_b qti-ubuntu-robotics-image-qrb5165-rb5-boot.img
    $ fastboot flash system qti-ubuntu-robotics-image-qrb5165-rb5- sysfs.ext4
    $ fastboot flash abl_a abl.elf
    $ fastboot flash abl_b abl.elf
    $ fastboot reboot

Attention : After, the image flashed successfully, the target device automatically reset by itself. Don’t turn off (or) Reset the target device manually. It causes the image packages to break, resulting in the inability to boot.

2.3.1. Troubleshooting Qualcomm USB driver (yellow bang)

  1. The driver may have to be manually selected and updated as detailed in the screenshots below.

  2. Right click on Android select Update drivers.

  3. The driver is already present in the system at this stage and should be available in the list as ‘Android ADB Interface’.

  4. After updating driver,check adb devices in command prompt.

$ adb devices 

2.4. Logging in to Wayland Desktop

  1. After updating the image, Ubuntu desktop will be installed automatically.

  2. During the installation process, please do not turn off the module.

  3. Once the desktop is installed, you will see the desktop login page. Select “Ubuntu with Wayland“ and log in to the desktop using the following credentials:

    User: adlink

    Password: adlink123

Note: In case the ‘Ubuntu with Wayland’ context menu item is not visible, please click on the user icon and it should pop-up.

2.5. Enbling the network manager

The network manager needs to be reinstalled after installing the desktop environment. Follow the below command on the RB5 Ubuntu desktop terminal. It will enable the network manager.

$ su
$ apt reinstall wpasupplicant network-manager -y

2.6. Erasing image from Module

To Erase the images on module, follow the below steps.

  1. Check LEC-RB5 detected on host.

    $ adb devices 
  2. Enter module into ADB mode.

    $ adb root
    $ adb reboot bootloader
  3. Check module detected on host.

    $ fastboot devices  
  4. Run below command to erase kernel and filesystem.

    $ fastboot erase system
    $ fastboot erase boot_a
    $ fastboot erase boot_b
    $ fastboot reboot