# 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 flash the configuration data table (CDT)?

CDT provides platform or device-dependent data such as platform ID, subtype, and version. Various software (drivers/firmware) modules can use this information to dynamically detect and initialize the platform.

Ensure that the device is in EDL mode. For more information, see Force device into emergency download mode.

  1. Download the CDT binary.

Based on the required development kit, download the respective CDT from the Flash CDT table in the Release Notes.

mkdir <cdt_download_path>
Copy to clipboard
cd <cdt_download_path>
Copy to clipboard
wget https://artifacts.codelinaro.org/artifactory/codelinaro-le/Qualcomm_Linux/QCS6490/cdt/rb3gen2-vision-kit.zip
Copy to clipboard

Note

The download link provided is for the Vision Kit. For information on other development kit CDTs, see Release Notes.


unzip rb3gen2-vision-kit.zip
Copy to clipboard
  1. To flash the CDT, run the following commands:

cd <cdt_download_path>
Copy to clipboard
<qdl_tool_path>/QDL_2.3.9_Linux_x64/qdl prog_firehose_ddr.elf rawprogram3.xml patch3.xml
Copy to clipboard
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

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

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

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
  1. 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
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
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

Note

This procedure is applicable only to an Ubuntu 22.04 host computer. If you’re using a Windows or macOS host computer, set up an Ubuntu virtual machine by following the instructions described in the Virtual Machine Setup Guide.

  1. To download the firmware, register and sign in to the Renesas website. After signing in, you can access the firmware from the following link.

  2. To create the usb_fw.img image and copy the USB firmware, run the following commands on the Linux host computer:

dd if=/dev/zero of=usb_fw.img bs=4k count=240
Copy to clipboard
mkfs -t ext4 usb_fw.img
Copy to clipboard
mkdir usb_fw
Copy to clipboard
sudo mount -o loop usb_fw.img usb_fw/
Copy to clipboard

Note

Rename the downloaded firmware file as renesas_usb_fw.mem and then run the following commands.

sudo cp -rf renesas_usb_fw.mem usb_fw
Copy to clipboard
sudo umount usb_fw
Copy to clipboard
  1. To start the device in Fastboot mode, run the following commands:

adb root
Copy to clipboard
adb shell
Copy to clipboard
reboot bootloader
Copy to clipboard
  1. When the device is in Fastboot mode, run the following command:

fastboot devices
Copy to clipboard

Sample output

7dc85f5e fastboot

  1. To flash the usb_fw.img image to the device, run the following commands:

fastboot erase usb_fw
Copy to clipboard
fastboot flash usb_fw usb_fw.img
Copy to clipboard
fastboot reboot
Copy to clipboard
  1. To confirm that the firmware update was successful, run the following command:

adb shell dmesg
Copy to clipboard

Sample output

[ 6.589462] usbcore: registered new device driver onboard-usb-hub [ 6.653277] usb 2-1: new SuperSpeed USB device number 2 using xhci_hcd [ 7.013061] usb 2-1.1: new SuperSpeed USB device number 3 using xhci_hcd [ 7.120657] ax88179_178a 2-1.1:1.0 eth0: register ‘ax88179_178a’ at usb-0001:04:00.0-1.1, ASIX AX88179 USB 3.0 Gigabit Ethernet, 3e:9e:5e:ff:d3:fb [ 7.120767] usbcore: registered new interface driver ax88179_178a

  1. To confirm that the firmware is available at the required location, run the following command:

#ls -la /var/usbfw
Copy to clipboard

If you are unable to update the Renesas USB firmware with the preceding steps, do the following:

  1. Rename the K2026090.mem file as renesas_usb_fw.mem.

  2. Push the renesas_usb_fw.mem file to /var/usbfw.

    For example, adb push renesas_usb_fw.mem /var/usbfw.

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 the android debug bridge (ADB) on the host computer?

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.

Install ADB

  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
  1. 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

  1. 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 20, 2026 [Previous Topic Update the software](https://docs.qualcomm.com/bundle/publicresource/80-70030-251/topics/upgrade-rb3gen2-software.md) [Next Topic References](https://docs.qualcomm.com/bundle/publicresource/80-70030-251/topics/references.md)