Set up the device - Qualcomm Dragonwing Documentation

After flashing Qualcomm Linux, use this page to bring the device up. Start with the debug serial console to log in and verify the software version. From there, choose one of the following connectivity options based on your setup:

Option	Best for
USB (ADB)	No network available; direct USB cable from host to device
Wi-Fi	Wireless access; SSH into the device over the network
Ethernet	Wired network access; SSH into the device over the network

If you have not flashed the device yet, start with Update software.

Set up the debug UART

The debug UART gives you a serial console into the device, your primary way to log in and check the device after flashing.

Connect one end of a micro-USB cable to the micro-USB port on the IQ-8275 EVK.
Connect the other end to your host computer.

Open the serial console for your host OS:

Ubuntu
Windows
macOS

Install screen:

sudo apt update
sudo apt install screen

List the serial devices:

ls /dev/ttyUSB*

Sample output:

/dev/ttyUSB0  /dev/ttyUSB1  /dev/ttyUSB2  /dev/ttyUSB3

The IQ-8275 EVK’s onboard adapter exposes four serial devices; the main console is the second one (/dev/ttyUSB1). Open it at 115200 baud:

sudo screen /dev/ttyUSB1 115200

List the serial devices:

ls /dev/cu.*

Find your device node (for example, /dev/cu.usbserial-DM03SDQQ) and open it at 115200 baud:

screen /dev/cu.usbserial-DM03SDQQ 115200

Press Enter to bring up the login prompt, then sign in:
- Username: root
- Password: oelinux123

Verify the software version

Confirm the device is running Qualcomm Linux:

cat /etc/os-release

Expected output:

ID=qcom-distro-sota
NAME="Qualcomm Linux Reference Distro(OTA-enabled)"
VERSION="2.0"
PRETTY_NAME="Qualcomm Linux Reference Distro (OTA-enabled) 2.0"

Check the kernel version:

uname -a

Expected output:

Linux iq-8275-evk 6.18.30-... #1 SMP PREEMPT ... aarch64 GNU/Linux

If the version doesn’t match, or you can’t reach a login prompt at all, the image is missing or outdated. Go back to Update software and flash the latest Qualcomm Linux.

Connect to the device

Choose one of the options below. All three require the UART console for the initial setup commands (see Set up the debug UART). After the first setup, USB (ADB) gives you a direct USB shell; Wi-Fi and Ethernet let you connect over SSH.

USB (ADB)
Wi-Fi
Ethernet

ADB (Android Debug Bridge) gives you a USB shell into the device. Because adbd is disabled by default, you need to enable it once via UART before ADB will work.1. Install ADB on your host:

sudo apt install android-tools-adb android-tools-fastboot

Verify:

adb --version

2. Enable adbd on the device (one-time, from the UART console):

touch /etc/usb-debugging-enabled
systemctl enable --now android-tools-adbd

3. Connect and open a shell:Connect a USB Type-C cable from your host to the device.

adb devices
adb shell

Sample output:

List of devices attached
68f592a device

1. Connect to a Wi-Fi network (from the UART console):

nmcli dev wifi list
nmcli dev wifi connect <WiFi-SSID> password <WiFi-password>

Example — network QualcommWiFi, password 1234567890:

nmcli dev wifi connect QualcommWiFi password 1234567890

Sample output:

Device 'wlp1s0' successfully activated with 'd7b990bd-3b77-4b13-b239-b706553abaf8'.

2. Get the device IP address:

ip addr show wlp1s0

3. SSH from your host (must be on the same network):

ssh root@<ip-address>

Enter the password oelinux123 when prompted.

Connect an Ethernet cable from the RJ45 port on the EVK to your network router. An Ethernet cable is not included in the kit.1. Get the device IP address (from the UART console):

ip addr show end0

The value of inet in the output is the device IP address.2. SSH from your host (must be on the same network):

ssh root@<ip-address>

Example:

ssh root@192.168.0.222

Enter the password oelinux123 when prompted.

Connect a display

Connect a monitor to DisplayPort0 (JEDP0) or JEDP1 on the EVK using an active Mini DisplayPort-to-DisplayPort cable (included in the box), or an active Mini DisplayPort-to-HDMI adapter (not included).

Display output works only through the DisplayPort connectors. There is no display output through the USB Type-C ports.

Power on the device and verify the display shows the expected startup output.

Connect Bluetooth peripherals

Use bluetoothctl to pair and connect a Bluetooth keyboard or mouse.

Open the Bluetooth manager:
bluetoothctl
Power on and start scanning:
power on scan on
Wait for your device to appear and note its MAC address:
[NEW] Device F8:7D:76:9D:9B:6B MyKeyboard

Pair, trust, and connect:

pair F8:7D:76:9D:9B:6B
trust F8:7D:76:9D:9B:6B
connect F8:7D:76:9D:9B:6B

Stop scanning and exit:
scan off exit

The device reconnects automatically on future boots. For full Wi-Fi and Bluetooth details, see Wi-Fi and Bluetooth.

SBC (Single Board Computer) mode

To use the EVK as a standalone computer with a keyboard, mouse, and monitor:

Power: connect the 12 V adapter.
Serial console: micro-USB to your host for UART logs (optional once set up).
USB hub: connect a powered USB hub to a USB Type-C port for multiple peripherals.
Keyboard & mouse: plug into the USB hub.
USB camera: connect to the USB hub (must be UVC-compliant).
MIPI camera: attach to a MIPI CSI connector on the board.
Display: Mini DisplayPort to DisplayPort cable, or an active Mini DisplayPort-to-HDMI adapter.

IQ8275-AC (20 TOPS) Simulation

The AC SKU Simulation feature allows a IQ8275 AA SKU hardware platform to operate with the frequency and feature configuration of the IQ8275 AC SKU. The simulation is enabled through a single OEM configuration property in the QTEE devcfg file — no firmware source changes or rebuild of TZ core components are required. When to use this feature:

Bring-up and validation of IQ8275 AC SKU software on AA SKU hardware boards before AC SKU silicon is available.
Testing AC SKU frequency and feature configurations in a pre-production environment.

Supported simulation:

Simulation	Property Value	Description
Disabled (default)	`0`	Hardware SKU detection — normal production behaviour
IQ8275 AC SKU	`3`	Applies IQ8275 AC frequency and feature configuration on AA hardware

NoteThis feature is intended for pre-production use only. It must be disabled (0) on all production devices.

Usage

Step 1: Open the OEM configuration file

trustzone_images/ssg/securemsm/trustzone/qsee/mink/oem/config/monaco/oem_config.xml

Step 2: Locate the `OEM_softsku_sim_config` property

The property is located under the /tz/oem device node:

<props name="OEM_softsku_sim_config" type=DALPROP_ATTR_TYPE_UINT32>
  0
</props>

Step 3: Enable AC SKU simulation

Change the value from 0 to 3 to enable IQ8275 AC SKU simulation:

<props name="OEM_softsku_sim_config" type=DALPROP_ATTR_TYPE_UINT32>
  3
</props>

Step 4: Rebuild and flash

Rebuild the DevCfg image for IQ8275 and flash to the target board:

Build cmd: python3 trustzone_images/build/ms/build_all.py CHIPSET=monaco devcfg_iot

Build instructions for DevCfg image can be found at https://dragonwingdocs.qualcomm.com/System/Security/enable-device-configurations-from-qualcomm-tee. Flash the updated DevCfg binaries: Updated DevCfg image can be flashed using the fastboot command

fastboot flash devcfg_a trustzone_images/build/ms/bin/FAQAANAA/devcfg_iot.mbn

Full build flashing instructions can be found at https://dragonwingdocs.qualcomm.com/Key-Documents/Flash-Guide/flash-with-qdl. Disabling Simulation (Production) To disable simulation and restore normal hardware SKU detection, set the property back to 0:

<props name="OEM_softsku_sim_config" type=DALPROP_ATTR_TYPE_UINT32>
  0
</props>

Rebuild and reflash. If the property is absent from the file, the driver defaults to 0 automatically — no simulation is applied. Important Notes

Production devices must have this property set to 0. Enabling simulation on production hardware may result in incorrect frequency/feature configuration.
This feature applies to IQ8275 only. It is not supported on other platforms in this release.
Only value 3 (IQ8275 AC SKU) is supported in this release. Other non-zero values are reserved for future releases and will have no effect.

Next steps

Explore peripherals and interfaces

​Set up the debug UART

​Verify the software version

​Connect to the device

​Connect a display

​Connect Bluetooth peripherals

​SBC (Single Board Computer) mode

​IQ8275-AC (20 TOPS) Simulation

​Step 1: Open the OEM configuration file

​Step 2: Locate the OEM_softsku_sim_config property

​Step 3: Enable AC SKU simulation

​Step 4: Rebuild and flash

​Next steps

Set up the debug UART

Verify the software version

Connect to the device

Connect a display

Connect Bluetooth peripherals

SBC (Single Board Computer) mode

IQ8275-AC (20 TOPS) Simulation

Step 1: Open the OEM configuration file

Step 2: Locate the `OEM_softsku_sim_config` property

Step 3: Enable AC SKU simulation

Step 4: Rebuild and flash

Next steps