# Update the software
To update the software on your Qualcomm Dragonwing^™^ RB3 Gen 2 device, download and flash the prebuilt images of the latest software from a host computer running Ubuntu, Windows, or mac operating systems.
You can also update the software incrementally using Over-the-air (OTA) update tools including the Capsule mechanism and the OSTree tool, as described in the [Qualcomm Linux Yocto Guide](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-27/update_fw_and_os_qualcomm_linux_using_capsule_and_ostree_mechanisms.html).
Caution
Updating the software with the prebuilt images erases all data on your device and installs a newer image. Back up important data before you start.
## Update the Qualcomm Linux software using Qualcomm Visual Studio Code Extension
The Qualcomm Visual Studio Code Extension is an integrated application development environment for Qualcomm development kits. It provides a graphical interface for device setup and software development functions including compiling, debugging, and binary flashing. Use this extension to update Qualcomm Linux software on the development kit from an Ubuntu or Windows host computer.
### Prerequisites
- Back up any important data on your Dragonwing RB3 Gen2 device.
- Check that the host computer has enough free storage. The software requires at least 19 GB of space.
- [Install](https://docs.qualcomm.com/bundle/publicresource/topics/80-79972-1/quick_start.html) the Qualcomm Visual Studio Code Extension on the host computer.
### Procedure
To update the Qualcomm Linux software on host computer, see the [Qualcomm Visual Studio Code Extension Reference Guide](https://docs.qualcomm.com/bundle/publicresource/topics/80-79972-1/quick_start.html).
## Update the Qualcomm Linux software manually using a host computer
Use the following workflow to upgrade the software from a host computer.
**Figure: Software upgrade workflow of Dragonwing RB3 Gen 2 Development Kit**
### Prerequisites
- Back up any important data on your Dragonwing RB3 Gen2 device.
- Check that the host computer has enough free storage. The software requires at least 19 GB of space.
### Procedure
To update the Qualcomm Linux software, complete the following steps based on the operating system of your host computer.
Tab Ubuntu
Tab Windows
Tab macOS
- *class* tabincludedirective
- #### Download the software
The Dragonwing RB3 Gen 2 device supports the following SDKs:
>
>
> - **Qualcomm Intelligent Multimedia (QIM) SDK**: This is the recommended software for the Dragonwing RB3 Gen 2 device. The software comes with multimedia applications.
> - **Qualcomm Intelligent Robotics (QIR) SDK**: This version of the Dragonwing RB3 Gen 2 software includes robotic applications.
You can download these SDKs on either an x86 or Arm-based host computer using the following links:
| Core Kit |
|
This document describes the download procedure for an x86-based host computer. If you are using an Arm-based host computer, update the commands with the appropriate download links.
##### Download QIM SDK
###### Core Kit
1. To download the QIM SDK, run the following command:
wget https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qimpsdk/qcs6490-rb3gen2-core-kit/x86-qcom-6.6.97-QLI.1.6-Ver.1.2_qim-product-sdk-image-2.1.1.zip
Copy to clipboard
2. To unzip the downloaded file on the development host, run the following command:
unzip x86-qcom-6.6.97-QLI.1.6-Ver.1.2_qim-product-sdk-image-2.1.1.zip
Copy to clipboard
###### Vision Kit
1. To download the QIM SDK, run the following command:
wget https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qimpsdk/qcs6490-rb3gen2-vision-kit/x86-qcom-6.6.97-QLI.1.6-Ver.1.2_qim-product-sdk-image-2.1.1.zip
Copy to clipboard
2. To unzip the downloaded file on the development host, run the following command:
unzip x86-qcom-6.6.97-QLI.1.6-Ver.1.2_qim-product-sdk-image-2.1.1.zip
Copy to clipboard
##### Download QIR SDK (Vision Kit only)
1. To download the QIR SDK, run the following command:
wget https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qirpsdk/qcs6490-rb3gen2-vision-kit/x86-qcom-6.6.97-QLI.1.6-Ver.1.2_robotics-sdk-image-1.2.zip
Copy to clipboard
2. To unzip the downloaded file on the development host, run the following command:
unzip x86-qcom-6.6.97-QLI.1.6-Ver.1.2_robotics-sdk-image-1.2.zip
Copy to clipboard
#### Force device into emergency download mode
The device enters emergency download (EDL) mode under two conditions:
- If the device doesn’t have installed software upon initial power-up
- If the currently installed software malfunctions
To facilitate software flashing, you must force the device into EDL mode using one of the following methods.
**Using ADB shell**
To force the device into EDL mode, run the following command:
adb shell reboot edl
Copy to clipboard
For information about how to install ADB, see [FAQs](https://docs.qualcomm.com/doc/80-70022-251/topic/faqs.html#install-adb).
**Using F\_DL button**
1. Connect the device to the host computer through the USB Type-C connector.
2. Hold down the **F\_DL** button.
**Figure: Location of the USB Type-C port and F\_DL button**
3. Connect the device to a 12-V wall power supply.
4. Release the **F\_DL** button. The device should now be in EDL mode.
5. To verify whether the device has entered EDL mode, run the following command on your host computer:
lsusb
Copy to clipboard
**Sample output**
Bus 002 Device 014: ID 05c6:9008 Qualcomm, Inc. Gobi Wireless Modem (QDL mode)
#### Update udev rules
Udev rules ensure consistent device recognition and naming, facilitate seamless hardware changes, and allow dynamic device management.
Ensure that you configure the `udev` USB rules for the Qualcomm manufacturing vendor ID **05c6** on the Ubuntu host computer. Run the following commands on your Ubuntu host computer:
1. To go to the directory, run the following command:
cd /etc/udev/rules.d
Copy to clipboard
2. To list the contents of the directory, run the following command:
ls
Copy to clipboard
- If the `51-qcom-usb.rules` file isn’t present, use `sudo vi 51-qcom-usb.rules` to create it, and add the following content to the file:
SUBSYSTEMS=="usb", ATTRS{idVendor}=="05c6", ATTRS{idProduct}=="9008", MODE="0664", GROUP="plugdev"
Copy to clipboard
- If the file exists, then check for the earlier content. Use the following command to view the content:
cat 51-qcom-usb.rules
Copy to clipboard
3. To restart `udev`, run the following command:
sudo systemctl restart udev
Copy to clipboard
If the USB cable is already connected to the host computer, unplug the cable and then reconnect it for the updated rules to take effect.
#### Flash using the QDL tool
The Qualcomm Download (QDL) tool is a flashing utility that communicates with USB devices identified by ID 05c6:9008. The tool uploads a flash loader to the device, which then flashes the images to the universal flash storage (UFS) built into the device.
1. Download the [QDL tool](https://softwarecenter.qualcomm.com/catalog/item/Qualcomm_Device_Loader?osArch=X86&osDist=Debian&osType=Linux&version=2.3.9) and unzip the contents of the downloaded folder. Qualcomm Linux 1.4 or later version requires QDL version 2.3.1 or higher.
2. To provide executable permission, run the following command:
>
>
> chmod +x ./qdl
> Copy to clipboard
For more information about QDL tool usage, see the **QDL\_User\_Guide** in your unzipped `qdl` directory.
Important
If your device uses Qualcomm Linux 1.0, 1.1, or 1.2, you must perform a one-time [UFS provisioning](https://docs.qualcomm.com/doc/80-70022-251/topic/faqs.html#provision-ufs) and [CDT flashing](https://docs.qualcomm.com/doc/80-70022-251/topic/faqs.html#flash-cdt) to upgrade to Qualcomm Linux 1.3 or later due to a change in the UFS partition table.
3. To flash the images, run the following commands:
cd /target/qcs6490-rb3gen2-vision-kit/qcom-multimedia-image
Copy to clipboard
Note
- If flashing fails, see [How to troubleshoot flashing-related issues](https://docs.qualcomm.com/doc/80-70022-251/topic/faqs.html#flash-issues) for further help.
- Replace the `` with the extracted `x86-qcom-6.6.97-QLI.1.6-Ver.1.0_qim-product-sdk-image-2.1.0.zip` file path.
>
>
> /QDL_2.3.9_Linux_x64/qdl --storage ufs prog_firehose_ddr.elf rawprogram*.xml patch*.xml
> Copy to clipboard
After flashing and successfully rebooting the device, you can view the device information in the terminal window by running the `lsusb` command.
>
>
> The line 4 of the following sample output shows the device information:
>
>
> # Sample output for QCS6490
>
>
> Bus 002 Device 003: ID 05c6:9135 Qualcomm, Inc. qcs6490-rb3gen2-vision-kit
>
>
> Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
>
>
> Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Note
If you’ve performed UFS provisioning, proceed to [Update USB and Ethernet controller firmware](https://docs.qualcomm.com/doc/80-70022-251/topic/faqs.html#usb-firmware).
- *class* tabincludedirective
- #### Download the software
The Dragonwing RB3 Gen 2 device supports the following SDKs:
>
>
> - **Qualcomm Intelligent Multimedia (QIM) SDK**: This is the recommended software for the Dragonwing RB3 Gen 2 device. The software comes with multimedia applications.
> - **Qualcomm Intelligent Robotics (QIR) SDK**: This version of the Dragonwing RB3 Gen 2 software includes robotic applications.
You can download these SDKs on either an x86 or Arm-based host computer using the following links:
| Core Kit |
|
This document describes the download procedure for an x86-based host computer. If you are using an Arm-based host computer, update the commands with the appropriate download links.
##### Download QIM SDK
###### Core Kit
1. To download the QIM SDK, paste the following link into a browser:
https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qimpsdk/qcs6490-rb3gen2-core-kit/x86-qcom-6.6.97-QLI.1.6-Ver.1.2_qim-product-sdk-image-2.1.1.zip
Copy to clipboard
2. Unzip the downloaded file on the development host.
###### Vision Kit
1. To download the QIM SDK, paste the following link into a browser:
https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qimpsdk/qcs6490-rb3gen2-vision-kit/x86-qcom-6.6.97-QLI.1.6-Ver.1.2_qim-product-sdk-image-2.1.1.zip
Copy to clipboard
2. Unzip the downloaded file on the development host.
##### Download QIR SDK (Vision Kit only)
1. To download the QIR SDK, paste the following link into a browser:
https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qirpsdk/qcs6490-rb3gen2-vision-kit/x86-qcom-6.6.97-QLI.1.6-Ver.1.2_robotics-sdk-image-1.2.zip
Copy to clipboard
2. Unzip the downloaded file on the development host.
##### Force device into emergency download mode
The device enters emergency download (EDL) mode under two conditions:
- If the device doesn’t have installed software upon initial power-up
- If the currently installed software malfunctions
To facilitate software flashing, you must force the device into EDL mode using one of the following methods.
**Using ADB shell**
To force the device into EDL mode, run the following command:
adb shell reboot edl
Copy to clipboard
For information about how to install ADB, see [FAQs](https://docs.qualcomm.com/doc/80-70022-251/topic/faqs.html#install-adb).
**Using F\_DL button**
1. Connect the device to the host computer through the USB Type-C connector.
2. Hold down the **F\_DL** button.
**Figure: Location of the USB Type-C port and F\_DL button**
3. Connect the device to a 12-V wall power supply.
4. Release the **F\_DL** button.
#### Flash using the QDL tool
The Qualcomm Download (QDL) tool is a flashing utility that communicates with USB devices identified by ID 05c6:9008. The tool uploads a flash loader to the device, which then flashes the images to the universal flash storage (UFS) built into the device.
1. Uninstall any other drivers for the device. Ensure that drivers like Qualcomm USB driver aren’t installed. The device shouldn’t appear under **COM Ports** in the **Device Manager**.
2. Download the [QDL tool](https://softwarecenter.qualcomm.com/catalog/item/Qualcomm_Device_Loader?osArch=X86&osType=Windows&version=2.3.9.1) and unzip the contents of the downloaded folder. Qualcomm Linux 1.4 or later version requires QDL version 2.3.1 or higher.
3. Run the `install_driver.bat` script from the unzipped QDL directory.
4. To flash the images, run the following command:
Important
If your device uses Qualcomm Linux 1.0, 1.1, or 1.2, you must perform a one-time [UFS provisioning](https://docs.qualcomm.com/doc/80-70022-251/topic/faqs.html#provision-ufs) and [CDT flashing](https://docs.qualcomm.com/doc/80-70022-251/topic/faqs.html#flash-cdt) to upgrade to Qualcomm Linux 1.3 or later due to a change in the UFS partition table.
.\QDL_2.3.9.1_Win_x64\QDL.exe prog_firehose_ddr.elf rawprogram0.xml rawprogram1.xml rawprogram2.xml rawprogram3.xml rawprogram4.xml patch0.xml patch1.xml patch2.xml patch3.xml patch4.xml
Copy to clipboard
Note
- Wildcards aren’t supported for program filenames. List each image file in the command.
- If flashing fails, see [How to troubleshoot flashing-related issues](https://docs.qualcomm.com/doc/80-70022-251/topic/faqs.html#flash-issues) for further help.
- Replace the `` with the extracted `x86-qcom-6.6.97-QLI.1.6-Ver.1.0_qim-product-sdk-image-2.1.0.zip` file path.
- If you’ve performed UFS provisioning, proceed to [Update USB and Ethernet controller firmware](https://docs.qualcomm.com/doc/80-70022-251/topic/faqs.html#usb-firmware).
- *class* tabincludedirective
- * * *
#### Download the software
The Dragonwing RB3 Gen 2 device supports the following SDKs:
>
>
> - **Qualcomm Intelligent Multimedia (QIM) SDK**: This is the recommended software for the Dragonwing RB3 Gen 2 device. The software comes with multimedia applications.
> - **Qualcomm Intelligent Robotics (QIR) SDK**: This version of the Dragonwing RB3 Gen 2 software includes robotic applications.
##### Download QIM SDK
###### Core Kit
1. To download the QIM SDK, paste the following link into a browser:
https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qimpsdk/qcs6490-rb3gen2-core-kit/arm-qcom-6.6.97-QLI.1.6-Ver.1.2_qim-product-sdk-image-2.1.1.zip
Copy to clipboard
2. To unzip the downloaded file on the development host, run the following command:
unzip arm-qcom-6.6.97-QLI.1.6-Ver.1.2_qim-product-sdk-image-2.1.1.zip
Copy to clipboard
###### Vision Kit
1. To download the QIM SDK, paste the following link into a browser:
https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qimpsdk/qcs6490-rb3gen2-vision-kit/arm-qcom-6.6.97-QLI.1.6-Ver.1.2_qim-product-sdk-image-2.1.1.zip
Copy to clipboard
2. To unzip the downloaded file on the development host, run the following command:
unzip arm-qcom-6.6.97-QLI.1.6-Ver.1.2_qim-product-sdk-image-2.1.1.zip
Copy to clipboard
##### Download QIR SDK (Vision Kit only)
1. To download the QIR SDK, run the following command:
wget https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qirpsdk/qcs6490-rb3gen2-vision-kit/arm-qcom-6.6.97-QLI.1.6-Ver.1.2_robotics-sdk-image-1.2.zip
Copy to clipboard
2. To unzip the downloaded file on the development host, run the following command:
unzip arm-qcom-6.6.97-QLI.1.6-Ver.1.2_robotics-sdk-image-1.2.zip
Copy to clipboard
##### Force device into emergency download mode
The device enters emergency download (EDL) mode under two conditions:
- If the device doesn’t have installed software upon initial power-up
- If the currently installed software malfunctions
To facilitate software flashing, you must force the device into EDL mode using one of the following methods.
**Using ADB shell**
To force the device into EDL mode, run the following command:
adb shell reboot edl
Copy to clipboard
For information about how to install ADB, see [FAQs](https://docs.qualcomm.com/doc/80-70022-251/topic/faqs.html#install-adb).
**Using F\_DL button**
1. Connect the device to the host computer through the USB Type-C connector.
2. Hold down the **F\_DL** button.
>
>
> 
**Figure: Location of the USB Type-C port and F\_DL button**
3. Connect the device to a 12-V wall power supply.
4. Release the **F\_DL** button. The device should now be in EDL mode.
5. To verify whether the device has entered EDL mode, run the following command on your host computer:
lsusb
Copy to clipboard
**Sample output**
Bus 002 Device 014: ID 05c6:9008 Qualcomm, Inc. Gobi Wireless Modem (QDL mode)
#### Flash using the QDL tool
The Qualcomm Download (QDL) tool is a flashing utility that communicates with USB devices identified by ID 05c6:9008. The tool uploads a flash loader to the device, which then flashes the images to the universal flash storage (UFS) built into the device.
1. Download the [QDL tool](https://softwarecenter.qualcomm.com/catalog/item/Qualcomm_Device_Loader?osArch=ARM64&osType=macOS&version=2.3.6) and unzip the contents of the downloaded folder. Qualcomm Linux 1.5 on macOS host requires QDL version 2.3.6 or higher.
For more information about QDL tool usage, see **QDL\_User\_Guide** in your unzipped `qdl` directory.
Important
If your device uses Qualcomm Linux 1.0, 1.1, or 1.2, you must perform a one-time [UFS provisioning](https://docs.qualcomm.com/doc/80-70022-251/topic/faqs.html#provision-ufs) and [CDT flashing](https://docs.qualcomm.com/doc/80-70022-251/topic/faqs.html#flash-cdt) to upgrade to Qualcomm Linux 1.3 or later due to a change in the UFS partition table.
2. To flash the images, run the following command:
cd /target/qcs6490-rb3gen2-vision-kit/qcom-multimedia-image
Copy to clipboard
Note
- If flashing fails, see [How to troubleshoot flashing-related issues](https://docs.qualcomm.com/doc/80-70022-251/topic/faqs.html#flash-issues) for further help.
- Replace the `` with the extracted `arm-qcom-6.6.97-QLI.1.6-Ver.1.0_qim-product-sdk-image-2.1.0.zip` file path.
>
>
> /QDL_2.3.6_Mac_ARM/QDL_Mac_ARM/qdl prog_firehose_ddr.elf rawprogram*.xml patch*.xml
> Copy to clipboard
After flashing and successfully rebooting the device, you can view the device information in the terminal window by running the `lsusb` command.
>
>
> The line 4 of the following sample output shows the device information.
>
>
> # Sample output for QCS6490
>
>
> Bus 002 Device 003: ID 05c6:9135 Qualcomm, Inc. qcs6490-rb3gen2-vision-kit
>
>
> Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
>
>
> Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Note
If you’ve performed UFS provisioning, proceed to [Update USB and Ethernet controller firmware](https://docs.qualcomm.com/doc/80-70022-251/topic/faqs.html#usb-firmware).
## Next steps
>
>
> 1. [Set up the device](https://docs.qualcomm.com/doc/80-70022-251/topic/set_up_the_device.html#set-up-the-device).
> 2. [Run sample applications](https://docs.qualcomm.com/doc/80-70022-251/topic/demo_app.html#task-ccx-b24-k1c).
Last Published: Dec 31, 2025
[Previous Topic
Develop an application](https://docs.qualcomm.com/bundle/publicresource/80-70022-251/topics/develop_application.md) [Next Topic
FAQs](https://docs.qualcomm.com/bundle/publicresource/80-70022-251/topics/faqs.md)