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.
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>
cd <cdt_download_path>
wget https://artifacts.codelinaro.org/artifactory/codelinaro-le/Qualcomm_Linux/QCS6490/cdt/rb3gen2-vision-kit.zip
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
To flash the CDT, run the following commands:
cd <cdt_download_path>
<qdl_tool_path>/QDL_2.3.9_Linux_x64/qdl prog_firehose_ddr.elf rawprogram3.xml patch3.xml
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
To download the provision XML file and check the applicability of UFS provisioning for different SoCs, see the UFS Provisioning table in the Release Notes.
Ensure that the device is in EDL mode. For more information, see Force device into emergency download mode.
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>
cd <provision_download_path>
wget https://artifacts.codelinaro.org/artifactory/codelinaro-le/Qualcomm_Linux/QCS6490/provision.zip
unzip provision.zip
To provision UFS, run the following commands:
cd <provision_download_path>
<qdl_tool_path>/QDL_2.3.9_Linux_x64/qdl --storage ufs prog_firehose_ddr.elf <Provision file>
Example
Run the following command from the ADB shell:
adb shell reboot edl
A firmware update to the USB controller may solve USB or Ethernet connectivity issues on the Dragonwing RB3 Gen 2 device.
Prerequisites
Ensure that you upgrade the software as described in Update the software before updating the Renesas firmware.
Ensure that you install the ADB tool. Fastboot comes installed along with it.
Connect the device to the Ubuntu host computer using a USB Type-C cable.
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.
To download the firmware, register and sign in to the Renesas website. After signing in, you can access the firmware from the following link.
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
mkfs -t ext4 usb_fw.img
mkdir usb_fw
sudo mount -o loop usb_fw.img usb_fw/
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
sudo umount usb_fw
To start the device in Fastboot mode, run the following commands:
adb root
adb shell
reboot bootloader
When the device is in Fastboot mode, run the following command:
fastboot devices
Sample output
7dc85f5e fastboot
To flash the usb_fw.img image to the device, run the following commands:
fastboot erase usb_fw
fastboot flash usb_fw usb_fw.img
fastboot reboot
To confirm that the firmware update was successful, run the following command:
adb shell dmesg
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
To confirm that the firmware is available at the required location, run the following command:
#ls -la /var/usbfw
If you are unable to update the Renesas USB firmware with the preceding steps, do the following:
Rename the
K2026090.memfile asrenesas_usb_fw.mem.Push the renesas_usb_fw.mem file to
/var/usbfw.For example,
adb push renesas_usb_fw.mem /var/usbfw.
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.
To clone the GitHub repository, run the following commands:
sudo apt install git
sudo git clone https://github.com/quic/quic-usb-drivers.git
cd quic-usb-drivers
To provide executable permissions to the file, run the following command:
sudo chmod +x QcDevDriver.sh
To install the QUD driver, run the following command:
sudo ./QcDevDriver.sh install
To detect the device, run the following command:
lsusb
Sample output
Bus 002 Device 099: ID 05c6:901d Qualcomm, Inc. QCM6490_e05d8b80
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
Run the following command on the Linux host computer:
sudo apt install git android-tools-adb android-tools-fastboot wget
To verify the ADB version on the Linux host computer, run the following command:
adb --version
Sample output
Android Debug Bridge version 1.0.39 Version 1:8.1.0+r23-5ubuntu2
Connect to ADB
Figure: Location of the USB Type-C port
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
Sample output
List of devices attached 68f592a device
To enter the shell, run the following command:
adb shell
Sample output
#
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.
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.
Flash the Vision Kit CDT, see Flash CDT.
Download and flash the Vision Kit software for your respective host computer, see Update the software.
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
If you need ModemManager, restart it after the flashing is complete.
If flashing fails, do the following and retry the flashing procedure:
Power off the device.
Disconnect the device from the host computer.
Restart the host computer.
To disconnect from the current network, run the following command:
nmcli c down QualcommWiFiConnection ‘QualcommWiFi’ successfully deactivated (D-Bus active path: /org/freedesktop/NetworkManager/ActiveConnection/1)
To verify the disconnect status, run the following command:
nmcli -p device![]()
To connect to a different Wi-Fi network, run the following command:
nmcli dev wifi connect QualcommAP password XXXXXXXXXDevice ‘wlan0’ successfully activated with ‘6159ac7c-58c2-44fa-938f-45dcb544fac3’.
Minicom is a serial communication program that allows an admin user to interact with the Dragonwing RB3 Gen 2 device through the serial port.
To install Minicom on the Linux host computer, run the following commands:
sudo apt update
sudo apt install minicom
To verify the USB port, run the following command:
ls /dev/ttyUSB*
Sample output
/dev/ttyUSB0
To open Minicom, run the following command:
sudo minicom -s
Select the Down arrow key to select the Serial port setup option.
To set up the serial device configuration, do the following:
Select A on your keyboard to set up the serial device name such as
/dev/ttyUSB0.Select Enter to save the changes.
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.
Select Enter to save the changes.
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.
![]()
Select Enter to save the changes.
Select the Save setup as dfl option and select Enter.
Select Exit to open the UART console.
Open the serial device and select ENTER to bring up the authentication prompt.
To sign in to the UART console, specify the following:
Sign in: root
Password: oelinux123
Note
If the authentication console doesn’t display as expected, verify the USB connection. If necessary, disconnect and then reconnect the Micro-USB cable.
By default, root users can sign in using the oelinux123 password.
Sign in as a root user.
To change the root password, run the following command:
passwd
Note
This command prompts you to enter a new password.
Sign out using the exit command.
Sign in as root using your new password.
Note
By default, you can sign in as the root user.
To create a non-root user account, run the following command in the shell.
adduser guest
Note
This command prompts you to enter a new password.
Sign out using the exit command.
Sign in to the shell using your new user account credentials.