# Set up the device
The Qualcomm Dragonwing^™^ RB3 Gen 2 Development Kit includes preloaded software to facilitate the setup process.
Use one of the following methods to set up the device.
**Use the Qualcomm Visual Studio Code Extension to set up the device**
Set up the device using an integrated development environment. For instructions, see [Qualcomm Visual Studio Code Extension Reference Guide](https://docs.qualcomm.com/bundle/publicresource/topics/80-79972-1/quick_start.html).
https://docs.qualcomm.com/bundle/publicresource/topics/80-79972-1/quick_start.html
**Use a host computer to manually set up the device**
Set up the device manually using an Ubuntu, Windows^®^, or macOS^®^-based host computer. For instructions, see [Set up the device manually using a host computer](https://docs.qualcomm.com/doc/80-70030-251/topic/set_up_the_device.html#set-up-device-manually).
https://docs.qualcomm.com/doc/80-70030-251/topic/set_up_the_device.html#set-up-device-manually
## Set up the device manually using a host computer
Use the following workflow to manually set up the Dragonwing RB3 Gen 2 device using an Ubuntu, Windows^®^, or macOS^®^-based host computer.
**Figure: Setup workflow of Dragonwing RB3 Gen 2 Development Kit**
### Power up the device
Connect the +12-V power adapter, and do one of the following:
>
>
> - Hold the **Power** button for 2-3 seconds until the power LED stays illuminated.
> - Plug in the USB Type-C to USB Type-A or Type-C cable to establish an ADB connection and to flash the software.
### Set up debug UART
The debug UART displays diagnostic messages and provides access to the device through the UART shell. Select an option for detailed instructions depending on the host computer OS.
Tab Ubuntu host
Tab Windows host
Tab macOS host
- *class* tabincludedirective
- 1. Connect the Micro-USB cable from the Micro-USB port on the Qualcomm Dragonwing™ RB3 Gen 2 Development Kit to the Linux host. The following image shows the Micro-USB port on the side of the Dragonwing RB3 Gen 2 Development Kit:
**Figure: Location of the Micro-USB port**
2. To install the `Screen` application on the Ubuntu host computer, run the following commands:
sudo apt update
Copy to clipboard
sudo apt install screen
Copy to clipboard
3. To verify the USB port, run the following command:
ls /dev/ttyUSB*
Copy to clipboard
**Sample output**
/dev/ttyUSB0
4. To open the debug UART, run the following command:
sudo screen
Copy to clipboard
**Example command**: `sudo screen /dev/ttyUSB0 115200`
5. Open the debug UART and select **ENTER** to bring up the authentication prompt.
6. To sign in to the UART console, specify the following:
- **Sign in**: `root`
- **Password**: `oelinux123`
>
>
> Note
>
>
> If you don’t see the authentication console as expected, check the USB connection. If needed, disconnect and reconnect the Micro-USB cable.
- *class* tabincludedirective
- 1. Connect the Micro-USB cable from the Micro-USB port on the Qualcomm Dragonwing™ RB3 Gen 2 Development Kit to the Windows host. The following image shows the Micro-USB port on the side of the Dragonwing RB3 Gen 2 Development Kit:
**Figure: Location of the Micro-USB port**
2. Download [PuTTY](https://putty.software/) for your Windows host computer. Choose the correct version for your Windows (32-bit or 64-bit).
3. Run the installation wizard and follow the prompts.
4. After installation, open the PuTTY application from the list of installed programs in the **Start** menu or search for it using the search bar in the taskbar.
5. In the **PuTTY Configuration** dialog, do the following:
1. Select **Serial**.
2. Specify a **Serial line** based on the UART port detected on the **Windows Device Manager**.
Note
If the UART port isn’t detected, download the driver and use Windows Device Manager to update the driver.
- On x86: [USB-to-UART serial driver](https://ftdichip.com/wp-content/uploads/2023/09/CDM-v2.12.36.4-WHQL-Certified.zip)
- On Arm^®^: Go to the [https://ftdichip.com/drivers/vcp-drivers/](https://ftdichip.com/drivers/vcp-drivers/) web page. In the **Drivers** section, select **FTDI CDM VCP Drivers**.
3. Set the baud rate to **115200**.
4. Select **Open** to start a PuTTY session.
6. Open the serial device and select **ENTER** to bring up the authentication prompt.
7. To sign in to the UART console, provide the following:
- **Sign in**: `root`
- **Password**: `oelinux123`
- *class* tabincludedirective
- 1. Connect the Micro-USB cable from the Micro-USB port on the Qualcomm Dragonwing™ RB3 Gen 2 Development Kit to the mac host. The following image shows the Micro-USB port on the side of the Dragonwing RB3 Gen 2 Development Kit:
**Figure: Location of the Micro-USB port**
2. To check for the serial devices connected to the macOS host computer, run the following command:
ls /dev/cu.*
Copy to clipboard
3. Locate the serial device from the listed serial devices. The device should appear in the list.
4. To open the serial device, run the following command:
screen
Copy to clipboard
Note
- Replace `` with your device node name.
- Replace `` with the appropriate baud rate.
**Example command**
`ceteam@Qualcomms-MacBook-Pro ~ % screen /dev/cu.usbserial-DM03SDQQ 115200`
5. Open the serial device and select the **ENTER** key to bring up the authentication prompt.
6. To sign in to the UART console, provide the following:
- **Sign in**: `root`
- **Password**: `oelinux123`
### Verify the Qualcomm Linux version
To verify the Qualcomm Linux version, run one of the following commands in your device shell or ADB shell:
- >
>
> uname -a
> Copy to clipboard
The output shows the Qualcomm Linux version.
>
>
> Linux qcs6490-rb3gen2-vision-kit 6.6.136-qli-1.9-ver.1.1-06431-gf573faa2a87b-dirty #1 SMP PREEMPT Fri Jun 19 18:55:24 UTC 2026 aarch64 GNU/Linux
or
- >
>
> cat /etc/os-release
> Copy to clipboard
The output shows the Qualcomm Linux version.
>
>
> ID=qcom-wayland
> NAME=”Qualcomm Linux”
> VERSION=”1.9-ver.1.1”
> VERSION\_ID=1.8-ver.1.1
> PRETTY\_NAME=”Qualcomm Linux 1.9-ver.1.1”
> CPE\_NAME=”cpe:/o:openembedded:qcom-wayland:1.9-ver.1.1”
>
>
> Note
>
>
> These commands are supported only on Qualcomm Linux 1.3 or later versions.
>
>
> If you’re using an older Qualcomm Linux version and want to upgrade, see [Update the software](https://docs.qualcomm.com/doc/80-70030-251/topic/upgrade-rb3gen2-software.html#upgrade-rb3gen2-software).
### Connect to a network
Establish an internet connection to retrieve the device IP address using one of the following methods.
Tab Ethernet
Tab Wi-Fi
1. Insert one end of the Ethernet cable into the Ethernet port (RJ45) of the Dragonwing RB3 Gen 2 device and connect the other end to your network router.
**Figure: Location of the Ethernet port**
2. After establishing the connection, run the following command on the UART serial console to obtain the IP address:
ifconfig eth2
Copy to clipboard
Note
If you are unable to establish the connection, see [Update USB and Ethernet controller firmware](https://docs.qualcomm.com/doc/80-70030-251/topic/faqs.html#usb-firmware).
The device operates Wi-Fi in station mode. When the device boots up, it initializes the Wi-Fi host driver and authenticates for network management. You can establish a wireless connection using the **nmcli** command-line tool.
1. To connect to the wireless access point (Wi-Fi router), run the following command:
>
>
> nmcli dev wifi connect password
> Copy to clipboard
>
>
> **Example**
>
>
> root@qcs6490-rb3gen2-vision-kit:~# nmcli dev wifi connect QualcommWiFi password 1234567890
> Copy to clipboard
>
>
> Device ‘wlan0’ successfully activated with ‘d7b990bd-3b77-4b13-b239-b706553abaf8’.
2. To verify connection and device status, run the following command:
>
>
> nmcli -p device
> Copy to clipboard
>
> 
3. To verify the WLAN connection status and IP address of the device, run the following command:
>
>
> ifconfig wlan0
> Copy to clipboard
>
> 
4. To verify that the connection is active, ping a website like Qualcomm:
>
>
> ping qualcomm.com
> Copy to clipboard
### Connect to SSH
SSH facilitates secure file transfers between the host computer and the Dragonwing RB3 Gen 2 device.
Before connecting over SSH, ensure that your device is connected to the network.
1. To find the IP address of the Dragonwing RB3 Gen 2 device based on the type of network connection, run the appropriate command on the UART console of the host computer.
For Ethernet:
ifconfig eth2
Copy to clipboard
For Wi-Fi:
ifconfig wlan0
Copy to clipboard
2. From the host computer, run the following command to establish an SSH connection to the device. Use the IP address obtained from **step 1**.
ssh root@ip-address
Copy to clipboard
**Example**
`ssh root@192.168.0.222`
3. To connect to the SSH, enter the following password:
oelinux123
Copy to clipboard
Note
Ensure that you have connected the remote host to the same Wi‑Fi access point as the device.
### Connect to HDMI display
To view the output of sample applications on your connected display, follow these steps:
1. Connect one end of the HDMI cable to the HDMI port on the development kit and the other end to your display monitor.
**Figure: Location of the HDMI port and power button**
2. Power on the device and look for the following pattern on the display monitor.
If the display doesn’t appear as expected, toggle the **Switch 4** on **DIP\_SW\_0** to OFF. For more details, see [DIP switches](https://docs.qualcomm.com/doc/80-70030-251/topic/references.html#dip-switches).
If the issue persists, see [Debug HDMI display](https://docs.qualcomm.com/bundle/publicresource/topics/80-70030-18/debug.html#debug-hdmi-display) to resolve the issue.
### Enable audio
To enable audio, see [Qualcomm Linux Audio Guide](https://docs.qualcomm.com/bundle/publicresource/topics/80-70030-16/enable-audio.html).
### Next steps
- [Update the software](https://docs.qualcomm.com/doc/80-70030-251/topic/upgrade-rb3gen2-software.html#upgrade-rb3gen2-software)
- [Run sample applications using a host computer](https://docs.qualcomm.com/doc/80-70030-251/topic/demo_app.html#run-apps-using-host-computer)
- [Develop applications](https://docs.qualcomm.com/bundle/publicresource/topics/80-79972-1/quick_start.html)
Last Published: Jul 20, 2026
[Previous Topic
Hardware overview](https://docs.qualcomm.com/bundle/publicresource/80-70030-251/topics/rb3_hardware_overview.md) [Next Topic
Run sample applications](https://docs.qualcomm.com/bundle/publicresource/80-70030-251/topics/demo_app.md)