How to flash the Ubuntu image on RB5

This document provides detailed instructions on how to flash the image to eMMC of I-Pi SMARC RB5 Plus using Windows.

Prerequisites(Windows)

Please make sure the following drivers installed on your development host if not please install them.
- Qualcomm HS-USB QDLoader 9008 Driver
- ADB Driver
You need to install few applications on your development host.
- QFIL
- ADB Fastboot Tool
You can download the image from the following here (file size 25.3GB).

If the targeted device already has an image on it, you can flash the latest image using the ADB tool.
If it does not have an image or if it’s crashed, flash the image using [QFIL method](#Flashing the image using QFIL).
Set the boot setting to eMMC 1000.

Power up the targeted device with all the necessary cables (USB OTG cable, Keyboard & Mouse, Ethernet).
Connect the USB OTG cable from your development host to targeted device.
You can open the ‘cmd prompt’ in the (image downloaded directory/BSP_Images) by going to the image downloaded directory.

To get started, type the following commands.

adb devices -l

adb reboot bootloader

fastboot devices

fastboot flash abl_a abl.elf

fastboot flash abl_b abl.elf

fastboot flash system qti-ubuntu-robotics-image-qrb5165-rb5-sysfs.ext4

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 reboot

The image has been successfully flashed on targeted device. The device is now ready to be used. Now you can turn on your targeted device and connect the ethernet cable with the device so that, it will receive the kernel updates and the ubuntu desktop while getting boot-up.

Note:

Make sure have you connected all the necessary cables and devices. (HDMI, Ethernet, Keyboard & Mouse, Power cord).
In order enter into the console mode type the following login credentials,
- username: root
- password: oelinux123
- To get download the ubuntu desktop type the the following command.
  cd /
  sh ubuntu-desktop.sh
It may take a while to download the all necessary files be patience.
For login please select “Ubuntu on Wayland”.
For next time once you entered into console just type the following command to get the ubuntu desktop.
init 5

Don’t power up the targeted device now. connect all the necessary cables (USB OTG cable, Keyboard & Mouse, Ethernet) with the targeted device.
Connect the USB OTG cable from your development host to targeted device.
It is also possible to connect the UART cable to see progress on the PuTTY terminal.
The QFIL application appears as shown below when you open it.

Click ‘select port’ and enter in to 9008 download mode using F_DL key.
Since we don’t have the F_DL key, we can use the tweezers to short two points to enter into 9008 download mode instead of using the key.

It is also recommended that you connect the power supply at the same time as you short those two points. Now the port should be detected automatically on QFIL. If not, choose it.
Next, select the options as illustrated in the following figure.

Click the ‘Load Content’ button and select the file ‘contents.xml’.
In the folder called ‘LEC-QRB5165_Yocto_ARM_QUALCOMM_QRB5165_4G_1v1.0.0’, you should find a file called contents.xml..

After it has finished, click on ‘Download Content’.
It will notify you when the download is complete.
After the prompt has finished, turn off the device.
Now you can turn on your targeted device and connect the ethernet cable with the device so that, it will receive the kernel updates while getting boot-up.

Note:

Make sure have you connected all the necessary cables and devices. (HDMI, Ethernet, Keyboard & Mouse, Power cord).
In order enter into the console mode type the following login credentials,
- username: root
- password: oelinux123
- To get download the ubuntu desktop type the the following command.
  cd /
  sh ubuntu-desktop.sh
It may take a while to download the all necessary files be patience.
For login please select “Ubuntu on Wayland”.
For next time once you entered into console just type the following command to get the ubuntu desktop.
init 5