# FAQs
How do you recover your device?

  1. Download the software.

  2. Force the device to emergency download (EDL) mode.

  3. Flash the downloaded software.

For detailed instructions, see Ubuntu, Windows, or macOS, based on your OS.

How do you provision universal flash storage (UFS)?

UFS provisioning helps divide the storage into several logical unit numbers (LUNs), allowing you to store different types of data separately. This improves access efficiency and system organization.

Note

Based on the required SoC, download the respective provision from the UFS Provisioning table in the Software Release Notes.

On Ubuntu host computer

  1. To download the provision file, do the following:

    mkdir <provision_download_path>
Copy to clipboard
    cd <provision_download_path>
Copy to clipboard
    wget https://artifacts.codelinaro.org/artifactory/codelinaro-le/Qualcomm_Linux/QCS6490/provision.zip
Copy to clipboard
    unzip provision.zip
Copy to clipboard

  2. To provision UFS, run the following commands:

    cd <provision_download_path>
Copy to clipboard
    <qdl_tool_path>/QDL_2.3.9_Linux_x64/qdl --storage ufs prog_firehose_ddr.elf <Provision file>
Copy to clipboard

Example

<qdl_tool_path>/QDL_2.3.9_Linux_x64/qdl --storage ufs prog_firehose_ddr.elf provision_1_2.xml

On windows host computer

  1. Download the provision file by pasting the following link into a browser:

    https://artifacts.codelinaro.org/artifactory/codelinaro-le/Qualcomm_Linux/QCS6490/provision.zip
Copy to clipboard

  2. Unzip the downloaded provision file.

  3. Provision UFS by running the following command from the unzipped provision directory:

    .<unzipped-QDL-directory-path>\qdl.exe --storage ufs prog_firehose_ddr.elf <Provision file>
Copy to clipboard

Example

.<unzipped-QDL-directory-path>\qdl.exe --storage ufs prog_firehose_ddr.elf provision_1_2.xml
Copy to clipboard

On macOS host computer

  1. Download the provision file by pasting the following link into a browser:

    https://artifacts.codelinaro.org/artifactory/codelinaro-le/Qualcomm_Linux/QCS6490/provision.zip
Copy to clipboard

  2. Unzip the downloaded provision file by running the following command:

    unzip provision.zip
Copy to clipboard

  3. Move all provision files into the QDL directory or move the QDL tool and associated libraries into the provision directory.

    Note

    All required QDL binaries and supporting libraries must be present in the execution directory.

  4. Provision UFS by running the following command from the execution directory:

    ./qdl --storage ufs prog_firehose_ddr.elf <Provision file>
Copy to clipboard

    Example

    ./qdl --storage ufs prog_firehose_ddr.elf provision_1_2.xml
Copy to clipboard

    After successful UFS provision, the following message appears on the screen:

    UFS provisioning succeeded
Copy to clipboard
How to put the device into the EDL mode without using the DIP switches?

Run the following command from the ADB shell:

adb shell reboot edl
Copy to clipboard

Note

By default, ADB is not enabled on the device. For information on enabling ADB, see How do you install and connect to the android debug bridge (ADB) ?.

How do you update the USB and Ethernet controller firmware?

A firmware update to the USB controller may solve USB or Ethernet connectivity issues on the Dragonwing RB3 Gen 2 device.

Prerequisites

Procedure

  1. Download the firmware from https://www.renesas.com/us/en/products/interface/usb-switches-hubs/upd720201-usb-30-host-controller#design_development, register and log in to https://www.renesas.com/.

  2. Rename the downloaded firmware file to renesas_usb_fw.mem .

  3. Connect device to host computer through a USB cable for adb.

  4. Push firmware to device using one of the following commands:

    adb push renesas_usb_fw.mem /lib/firmware
Copy to clipboard

    OR

    scp renesas_usb_fw.mem root@<ip-address-of-device>:/lib/firmware
Copy to clipboard

    Example:

    scp renesas_usb_fw.mem root@10.92.175.138:/lib/firmware

  5. To activate the firmware, do either of the following options.

    • Option A: Reboot target for USB type A ports.

    • Option B: Manually bind the Renesas xHCI driver.

      echo "0001:04:00.0" > /sys/bus/pci/drivers/xhci-pci-renesas/bind
Copy to clipboard

    Note

    To retrieve the device ID, use the following command:

    sh-5.3# lspci
Copy to clipboard

    In the following sample output, 0001:04:00.0 is the device ID.

    0001:00:00.0 PCI bridge: Qualcomm Technologies, Inc SM8250 PCIe Root Complex [Snapdragon 865/870 5G]
0001:01:00.0 PCI bridge: Toshiba Corporation Device 0623
0001:02:01.0 PCI bridge: Toshiba Corporation Device 0623
0001:02:02.0 PCI bridge: Toshiba Corporation Device 0623
0001:02:03.0 PCI bridge: Toshiba Corporation Device 0623
0001:04:00.0 USB controller: Renesas Electronics Corp. uPD720201 USB 3.0 Host Controller (rev 03)
0001:05:00.0 Ethernet controller: Toshiba Corporation Device 0220
0001:05:00.1 Ethernet controller: Toshiba Corporation Device 0220
Copy to clipboard

  6. Verify firmware enumeration.

    dmesg
Copy to clipboard
How do you install the Qualcomm USB driver (QUD) on the host computer?

Install QUD on the host computer to detect the Dragonwing RB3 Gen 2 device.

Note

For Ubuntu 22.04, you may face an issue while installing QUD. To ensure a successful installation, you may need to enroll the public key on your Linux host computer. For more details, follow the steps provided in the README file available in the /opt/QUIC/sign/signReadme.txt directory.

  1. To clone the GitHub repository, run the following commands:

sudo apt install git
Copy to clipboard
sudo git clone https://github.com/quic/quic-usb-drivers.git
Copy to clipboard
cd quic-usb-drivers
Copy to clipboard

  1. To provide executable permissions to the file, run the following command:

sudo chmod +x QcDevDriver.sh
Copy to clipboard

  1. To install the QUD driver, run the following command:

sudo ./QcDevDriver.sh install
Copy to clipboard

  1. To detect the device, run the following command:

lsusb
Copy to clipboard

Sample output

Bus 002 Device 099: ID 05c6:901d Qualcomm, Inc. QCM6490_e05d8b80

How do you install and connect to the android debug bridge (ADB) ?

Some Qualcomm proprietary tools require an ADB. ADB is a command-line tool that allows communication with the Dragonwing RB3 Gen 2 device. The adb command facilitates various device actions, such as debugging, capturing kernel logs, and pushing applications and files to the device.

Enable ADB on the device

  1. Boot up the device and log in to the serial shell.

  2. Create the following file to enable USB debugging:

    touch /etc/usb-debugging-enabled
Copy to clipboard

  3. Choose one of the following options to start ADB:

    • Option 1: Reboot the device.

    • Option 2: Start the ADB service without reboot:

      systemctl start android-tools-adbd
Copy to clipboard

Note

Once enabled, ADB remains active across reboots. To disable ADB, remove the /etc/usb-debugging-enabled file and then reboot the device.

Install ADB on the host computer

  1. Install QUD.

  2. Run the following command on the Linux host computer:

    sudo apt install git android-tools-adb android-tools-fastboot wget
Copy to clipboard

  3. To verify the ADB version on the Linux host computer, run the following command:

    adb --version
Copy to clipboard

Sample output

Android Debug Bridge version 1.0.39 Version 1:8.1.0+r23-5ubuntu2

Connect to ADB

Side view of the Dragonwing RB3 Gen 2 Development Kit showing the USB Type-C port.

Figure: Location of the USB Type-C port

  1. Using the USB Type-C cable, connect the Dragonwing RB3 Gen 2 device with the host computer. Ensure that the device displays as an ADB device.

    adb devices
Copy to clipboard

    Sample output

    List of devices attached 68f592a device

  2. To enter the shell, run the following command:

    adb shell
Copy to clipboard

    Sample output

    #

How do you connect the Vision mezzanine to the Core Kit?

The Vision mezzanine supports interfacing cameras to the Dragonwing RB3 Gen 2 device through two, second-generation gigabit multimedia serial link (GMSL2) camera inputs and five CAM/CSI camera ports. This mezzanine also provides four DMICs, an IMU, compass/magnetometer, and a pressure sensor.

Top view of the Vision mezzanine showing the five CAM/CSI camera ports.

Figure: Vision mezzanine

For more information, see Vision mezzanine.

Follow these steps to connect the Vision mezzanine to the Core Kit. Flash the CDT to update the device configuration based on the new mezzanine. It’s essential to follow these steps because the Core and Vision kits have different CDTs and software.

  1. Flash the Vision Kit CDT, see Flash CDT.

  2. Download and flash the Vision Kit software for your respective host computer, see Update the software.

How do you troubleshoot flashing-related issues?

Note

Ensure that the host computer isn’t running the ModemManager tool, as it interferes with QDL flashing.

If you’re using a Linux distribution with systemd, stop the ModemManager tool using the following command:

sudo systemctl stop ModemManager
Copy to clipboard

If flashing fails, do the following and retry the flashing procedure:

  1. Power off the device.

  2. Disconnect the device from the host computer.

  3. Restart the host computer.

How do you reconnect to a different network when you’re already connected to one?

  1. To disconnect from the current network, run the following command:

    nmcli c down QualcommWiFi
Copy to clipboard

    Connection ‘QualcommWiFi’ successfully deactivated (D-Bus active path: /org/freedesktop/NetworkManager/ActiveConnection/1)

  2. To verify the disconnect status, run the following command:

    nmcli -p device
Copy to clipboard
    ../_images/nmcli_disconnected.png

  3. To connect to a different Wi-Fi network, run the following command:

    nmcli dev wifi connect QualcommAP password XXXXXXXXX
Copy to clipboard

    Device ‘wlan0’ successfully activated with ‘6159ac7c-58c2-44fa-938f-45dcb544fac3’.

How do you set up debug UART using Minicom?

Minicom is a serial communication program that allows an admin user to interact with the Dragonwing RB3 Gen 2 device through the serial port.

  1. To install Minicom on the Linux host computer, run the following commands:

sudo apt update
Copy to clipboard
sudo apt install minicom
Copy to clipboard

  1. To verify the USB port, run the following command:

ls /dev/ttyUSB*
Copy to clipboard

Sample output

/dev/ttyUSB0

  1. To open Minicom, run the following command:

sudo minicom -s
Copy to clipboard

  1. Select the Down arrow key to select the Serial port setup option.

../_images/image_21.png

  1. To set up the serial device configuration, do the following:

    1. Select A on your keyboard to set up the serial device name such as /dev/ttyUSB0.

    2. Select Enter to save the changes.

    3. Select E on your keyboard to set the baud rate. If the baud rate isn’t set to 115200, select the E key again. Select Q on your keyboard to set the configuration to 8N1.

    4. Select Enter to save the changes.

    5. Select F on your keyboard to set the Hardware Flow Control to No.

      Note

      Ensure that the letters A, E, Q, and F are in uppercase.

      ../_images/Image_01.png

    6. Select Enter to save the changes.

  2. Select the Save setup as dfl option and select Enter.

../_images/image_31.png

  1. Select Exit to open the UART console.

  2. Open the serial device and select ENTER to bring up the authentication prompt.

  3. To sign in to the UART console, specify the following:

Note

If the authentication console doesn’t display as expected, verify the USB connection. If necessary, disconnect and then reconnect the Micro-USB cable.

How do you change the default root password?

By default, root users can sign in using the oelinux123 password.

  1. Sign in as a root user.

  2. To change the root password, run the following command:

    passwd
Copy to clipboard

Note

This command prompts you to enter a new password.

  1. Sign out using the exit command.

  2. Sign in as root using your new password.

How do you create a non-root user account?

Note

By default, you can sign in as the root user.

  1. To create a non-root user account, run the following command in the shell.

    adduser guest
Copy to clipboard

Note

This command prompts you to enter a new password.

  1. Sign out using the exit command.

  2. Sign in to the shell using your new user account credentials.

## Further support Ask your questions on the [Qualcomm support forum](https://mysupport.qualcomm.com/supportforums/s/). Last Published: Jul 01, 2026 [Previous Topic Update the software](https://docs.qualcomm.com/bundle/publicresource/80-80023-251/topics/upgrade-rb3gen2-software.md) [Next Topic References](https://docs.qualcomm.com/bundle/publicresource/80-80023-251/topics/references.md)