# 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-80023-251/topic/set_up_the_device.html#set-up-device-manually).
https://docs.qualcomm.com/doc/80-80023-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:
- >
>
> uname -a
> Copy to clipboard
The output shows the Qualcomm Linux version.
>
>
> Linux rb3gen2-core-kit 6.18.30-01953-g5086fd78561b-dirty #1 SMP PREEMPT Mon Jun 22 14:20:22 UTC 2026 aarch64 GNU/Linux
or
- >
>
> cat /etc/os-release
> Copy to clipboard
The output shows the Qualcomm Linux version.
>
>
> ID=qcom-distro
> NAME=”Qualcomm Linux Reference Distro”
> VERSION=”2.0”
> VERSION\_ID=2.0
> PRETTY\_NAME=”Qualcomm Linux Reference Distro 2.0”
> CPE\_NAME=”cpe:/o:openembedded:qcom-distro:2.0”
> BUILD\_ID=”local-20260625153136”
### 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:
ip addr
Copy to clipboard
The value of `inet` in the output indicates that the IP address of the device is `10.219.1.127`.
enP1p4s0u1u1: mtu 1500 qdisc fq_codel state UP group default qlen 1000
link/ether 00:0e:c6:81:79:01 brd ff:ff:ff:ff:ff:ff
altname enx000ec6817901
inet 10.219.1.127/23 brd 10.219.1.255 scope global dynamic noprefixroute enP1p4s0u1u1
valid_lft 1795sec preferred_lft 1795sec
inet6 fe80::1929:ea1a:43a7:5b36/64 scope link noprefixroute
valid_lft forever preferred_lft forever
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-80023-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
Note
To get the list of available Wi-Fi networks in the vicinity, run the following command:
nmcli dev wifi list
Copy to clipboard
**Example**
The name of the Wi-Fi network is `QualcommWi-Fi` and the password is `1234567890`. To connect to this network, run the following command:
>
>
> root@rb3gen2-core-kit:~# nmcli dev wifi connect QualcommWiFi password 1234567890
> Copy to clipboard
**Sample output**
The following sample output indicates successful connection.
Device ‘wlp1s0’ successfully activated with ‘33b01480-c760-4347-bcc2-da30cba6f9a8’.
2. To verify connection and device status, run the following command:
>
>
> nmcli -p device
> Copy to clipboard
>
>
> =================
> Status of devices
> =================
> DEVICE TYPE STATE CONNECTION
> ----------------------------------------------------------------
> wlp1s0 wifi connected QualcommWiFi
> lo loopback connected (externally) lo
> p2p-dev-wlp1s0 wifi-p2p disconnected --
> end0 ethernet unavailable
> Copy to clipboard
3. To verify the WLAN connection status and IP address of the device, run the following command:
>
>
> >
> >
> > ip addr
> > Copy to clipboard
>
>
>
> The value of `inet` in the output indicates that the IP address of the device is `10.92.205.107`.
>
>
>
> >
> >
> > inet 10.92.205.107/19 brd 10.92.223.255 scope global dynamic noprefixroute wlp1s0
> > 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:
>
>
> ip addr show end0
> Copy to clipboard
- For Wi-Fi:
>
>
> ip addr
> 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**
`inet 10.92.205.107`
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.
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-80023-251/topic/references.html#dip-switches).
If the issue persists, see [Debug HDMI](https://dragonwingdocs.qualcomm.com/Technologies/Display/troubleshoot-debug-hdmi) to resolve the issue.
### Enable camera
To validate camera use cases, ensure that you are using the `qcom-multimedia-proprietary-image`, which includes the downstream camera driver components. The downstream camera driver is disabled by default. To enable camera, do the following:
1. Configure the camera overlay by running the following commands in SSH:
>
>
> echo -n "camx" > /var/data
> Copy to clipboard
>
>
> efivar -n 882f8c2b-9646-435f-8de5-f208ff80c1bd-VendorDtbOverlays -w -f /var/data
> Copy to clipboard
>
>
> efivar -n 882f8c2b-9646-435f-8de5-f208ff80c1bd-VendorDtbOverlays -p
> Copy to clipboard
2. Sync the changes and reboot the device:
sync
Copy to clipboard
>
>
> Reboot
> Copy to clipboard
3. Verify that the camera services are active by running the following command:
ps -ef | grep cam-server
Copy to clipboard
4. Verify if the **qtiqmmfsrc** plugin is enabled by running the following command:
gst-inspect-1.0 qtiqmmfsrc
Copy to clipboard
>
>
> If the **qtiqmmfsrc** plugin is disabled or missing, clear the GStreamer cache and reverify using the following commands:
>
>
> rm ~/.cache/gstreamer-1.0/registry.aarch64.bin
> Copy to clipboard
>
>
> gst-inspect-1.0 qtiqmmfsrc
> Copy to clipboard
### Enable audio
To enable audio, see [Audio Guide](https://dragonwingdocs.qualcomm.com/Technologies/Audio/audio-guide/enable-audio).
### Next steps
- [Update the software](https://docs.qualcomm.com/doc/80-80023-251/topic/upgrade-rb3gen2-software.html#upgrade-rb3gen2-software)
- [Run sample applications using a host computer](https://docs.qualcomm.com/doc/80-80023-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 01, 2026
[Previous Topic
Hardware overview](https://docs.qualcomm.com/bundle/publicresource/80-80023-251/topics/rb3_hardware_overview.md) [Next Topic
Run sample applications](https://docs.qualcomm.com/bundle/publicresource/80-80023-251/topics/demo_app.md)