IoT Session
IoT devices in QDC are accessed through SSH over an SSH tunnel. Depending on the device configuration, ADB (Android Debug Bridge) access may also be available. This guide walks you through the full connection process.
Prerequisites
Before you begin, make sure you have:
- An SSH key imported or generated in QDC. See SSH Keys for setup instructions.
- A running Interactive Session with an IoT device.
Step 1: Set up SSH tunneling (For Linux/Ubuntu devices)
The SSH tunnel creates a secure connection between your local machine and the remote device. This tunnel must stay running for the entire session.
Open a PowerShell or Terminal window and run the SSH command shown in the Connect dialog.
The command format depends on your device configuration. For SSH-only devices:
ssh -i {path_to_private_key} -L {ssh_port}:sa{session_id}.sa.svc.cluster.local:22 -N sshtunnel@ssh.qdc.qualcomm.comFor devices with SSH + ADB access:
ssh -i {path_to_private_key} -L {ssh_port}:sa{session_id}.sa.svc.cluster.local:22 -L {adb_port}:sa{session_id}.sa.svc.cluster.local:5037 -N sshtunnel@ssh.qdc.qualcomm.com| Value | Description | Where to find it |
|---|---|---|
{path_to_private_key} | Path to your SSH private key file | The file you created/uploaded when setting up SSH keys |
{ssh_port} | Local port for SSH access to the device | Shown in the Connect dialog |
{adb_port} | Local port for ADB access (Android only) | Shown in the Connect dialog |
{session_id} | Your session execution ID | Shown in the Connect dialog |
Keep this window open
The SSH tunnel must remain active for the duration of your session. Do not close the terminal window running this command.
Step 2: SSH into the device (For Linux/Ubuntu devices only)
Once the tunnel is running, open a new terminal window and connect to the device:
ssh -o StrictHostKeychecking=no -o UserKnownHostsFile=/dev/null -p {ssh_port} {username}@localhostWhen prompted, enter the password oelinux123.
Device credentials
| Device OS | Username | Password |
|---|---|---|
| Standard Linux | root | oelinux123 |
| Ubuntu | ubuntu | oelinux123 |
The Connect dialog will show the correct username for your device.
Step 3: Run ADB commands (Android only)
If your IoT device supports ADB, you can run ADB commands after specifying an ADB port in the Connect dialog. Open a new terminal window and use ADB to interact with the device:
adb devices — Verify the device is connected
adb shell — Open a remote shell on the device
adb push / adb pull — Copy files to and from the device
For a full list of commands and examples, see the ADB Commands reference.
Troubleshooting
Having trouble connecting? See SSH Troubleshooting for solutions to common issues including host authenticity warnings, permission denied errors, and connecting to additional ports.