Flash the robotics image - Qualcomm Dragonwing Documentation

You can configure the development kits supported by the QIR SDK using Ubuntu, Windows, and macOS® host computers. The procedure on this page supplements the EVK flashing guide — it replaces only the final image-flashing step with the QIR SDK robotics image.

NoteYou can also set up a virtual machine (VM) running Ubuntu 24.04 on Microsoft® Windows® or Apple® macOS®. For details, see Qualcomm Linux Virtual Machine Setup Guide.

Prerequisites

The robotics image for QIR SDK is ready from either of the following sources:

QIR SDK prebuilt package

Download the prebuilt packages

Robotics image built on the host computer

Flash robotics image to your Dragonwing™ device

Ubuntu
Windows
macOS

Configure device for flash.

Complete the following configurations according to your Dragonwing device.a. Download QDL.b. Set up the QDL driver.c. Set up the QDL path.d. Put the device in EDL mode.e. Provision UFS and toggle the power switch off and on.f. Flash the security island (SAIL) firmware.

IQ-9075 EVK documentation

IQ-8275 EVK documentation

Note

After UFS provisioning completes, the device disconnects from USB. Toggle the power switch off and on to reboot it back into EDL mode before flashing SAIL.
Skip the step “Flash Qualcomm Linux”. Use the following step 2 to flash the robotics image instead.

Flash the robotics image.

Flash the robotics image using the qcom-robotics-proprietary-image you have downloaded or built.a. Navigate to the main image folder.

cd <path-to-image>/images/iq-9075-evk/qcom-robotics-proprietary-image-iq-9075-evk.rootfs.qcomflash

cd <path-to-image>/images/iq-8275-evk/qcom-robotics-proprietary-image-iq-8275-evk.rootfs.qcomflash

b. Flash the robotics image:

<qdl_dir>/qdl --storage ufs prog_firehose_ddr.elf rawprogram*.xml patch*.xml

<qdl_dir>/qdl --storage ufs prog_firehose_ddr.elf rawprogram*.xml patch*.xml

The flash is complete when the final line reads:

partition 1 is now bootable

Any sector-truncation warnings during flashing are harmless.
If flashing fails at any point, disconnect the USB cable and power supply, reconnect them, and retry from the EDL mode step.

Boot to the device terminal.

a. Turn off the SW2-3 DIP switch by pushing it down.b. Power-cycle the device. It boots into the newly flashed robotics image.

Configure device for flash.

Complete the following configurations according to your Dragonwing device.a. Download QDL.b. Set up QDL driver.c. Put the device in EDL mode.d. Provision UFS and toggle the power switch off and on.e. Flash security island (SAIL) firmware.

IQ-9075 EVK documentation

IQ-8275 EVK documentation

Note

After UFS provisioning completes, the device disconnects from USB. Toggle the power switch off and on to reboot it back into EDL mode before flashing SAIL.
Skip the step “Flash Qualcomm Linux”. Use the following step 2 to flash the robotics image instead.

Flash the robotics image.

Flash the robotics image using the qcom-robotics-proprietary-image you have downloaded or built.a. Navigate to the main image folder.

cd <path-to-image>/images/iq-9075-evk/qcom-robotics-proprietary-image-iq-9075-evk.rootfs.qcomflash

cd <path-to-image>/images/iq-8275-evk/qcom-robotics-proprietary-image-iq-8275-evk.rootfs.qcomflash

b. Flash the robotics image:

Replace <qdl_dir> with your QDL folder path — Windows does not support wildcards, list all files explicitly.

Command prompt

"<qdl_dir>\qdl.exe" prog_firehose_ddr.elf rawprogram0.xml rawprogram1.xml rawprogram2.xml rawprogram3.xml rawprogram4.xml rawprogram5.xml patch0.xml patch1.xml patch2.xml patch3.xml patch4.xml patch5.xml

"<qdl_dir>\qdl.exe" prog_firehose_ddr.elf rawprogram0.xml rawprogram1.xml rawprogram2.xml rawprogram3.xml rawprogram4.xml rawprogram5.xml patch0.xml patch1.xml patch2.xml patch3.xml patch4.xml patch5.xml

PowerShell

& "<qdl_dir>\qdl.exe" prog_firehose_ddr.elf rawprogram0.xml rawprogram1.xml rawprogram2.xml rawprogram3.xml rawprogram4.xml rawprogram5.xml patch0.xml patch1.xml patch2.xml patch3.xml patch4.xml patch5.xml

& "<qdl_dir>\qdl.exe" prog_firehose_ddr.elf rawprogram0.xml rawprogram1.xml rawprogram2.xml rawprogram3.xml rawprogram4.xml rawprogram5.xml patch0.xml patch1.xml patch2.xml patch3.xml patch4.xml patch5.xml

The flash is complete when the final line reads:

partition 1 is now bootable

If flashing fails at any point, disconnect the USB cable and power supply, reconnect them, and retry from the EDL mode step.

Boot to the device terminal.

a. Turn off the SW2-3 DIP switch by pushing it down.b. Power-cycle the device. It boots into the newly flashed robotics image.

Configure device for flash.

Complete the following configurations according to your Dragonwing device.a. Download QDL.b. Set up QDL path.c. Put the device in EDL mode.d. Provision UFS and toggle the power switch off and on.e. Flash security island (SAIL) firmware.

IQ-9075 EVK documentation

IQ-8275 EVK documentation

Note

After UFS provisioning completes, the device disconnects from USB. Toggle the power switch off and on to reboot it back into EDL mode before flashing SAIL.
Skip the step “Flash Qualcomm Linux”. Use the following step 2 to flash the robotics image instead.

Flash the robotics image.

Flash the robotics image using the qcom-robotics-proprietary-image you have downloaded or built.a. Navigate to the main image folder.

cd <path-to-image>/images/iq-9075-evk/qcom-robotics-proprietary-image-iq-9075-evk.rootfs.qcomflash

cd <path-to-image>/images/iq-8275-evk/qcom-robotics-proprietary-image-iq-8275-evk.rootfs.qcomflash

b. Flash the robotics image:

<qdl_dir>/qdl --storage ufs prog_firehose_ddr.elf rawprogram*.xml patch*.xml

<qdl_dir>/qdl --storage ufs prog_firehose_ddr.elf rawprogram*.xml patch*.xml

The flash is complete when the final line reads:

partition 1 is now bootable

Any sector-truncation warnings during flashing are harmless.
If flashing fails at any point, disconnect the USB cable and power supply, reconnect them, and retry from the EDL mode step.

Boot to the device terminal.

a. Turn off the SW2-3 DIP switch by pushing it down.b. Power-cycle the device. It boots into the newly flashed robotics image.

Check the Qualcomm Linux version

To check the Qualcomm Linux version, run the following command in your device shell:

cat /etc/os-release

The output shows the Qualcomm Linux version.

ID=qcom-robotics-ros2-jazzy
NAME="Qualcomm Linux Robotics Reference Distro with ROS"
VERSION="2.0"
VERSION_ID=2.0
PRETTY_NAME="Qualcomm Linux Robotics Reference Distro with ROS 2.0"
CPE_NAME="cpe:/o:openembedded:qcom-robotics-ros2-jazzy:2.0"

Result

You have flashed the robotics image onto the device and are able to connect to the device using SSH.

Next step

Set up for running sample applications

​Prerequisites

QIR SDK prebuilt package

Robotics image built on the host computer

​Flash robotics image to your Dragonwing™ device

IQ-9075 EVK documentation

IQ-8275 EVK documentation

IQ-9075 EVK documentation

IQ-8275 EVK documentation

IQ-9075 EVK documentation

IQ-8275 EVK documentation

​Check the Qualcomm Linux version

​Result

​Next step

Prerequisites

Flash robotics image to your Dragonwing™ device

Check the Qualcomm Linux version

Result

Next step