> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Get from zero to a running app on your Qualcomm® dev kit in minutes.

## Prerequisites

Complete the setup steps before starting this guide:

<CardGroup cols={2}>
  <Card title="Install Visual Studio Code" icon="code" href="./setup/install-vscode">
    Set up VS Code on Ubuntu or Windows with WSL.
  </Card>

  <Card title="Install the Extension" icon="puzzle-piece" href="./setup/install-extension">
    Download the `.vsix` from Qualcomm Software Center and install it in VS
    Code.
  </Card>

  <Card title="Configure udev Rules" icon="sliders" href="./setup/udev-rules">
    Allow USB access for ADB and EDL on Linux hosts.
  </Card>

  <Card title="USB Forwarding (WSL)" icon="usb" href="./setup/wsl-usb">
    Forward the device from Windows into WSL using usbipd.
  </Card>
</CardGroup>

<Check>
  Before continuing, confirm the Qualcomm extension icon is visible in the VS
  Code Activity Bar and the **Home** page loads with a **Get Started** button.
</Check>

***

## Step 1 — Run the Getting Started Wizard

Click **Get Started** on the Home page to launch the setup wizard.

<img src="https://mintcdn.com/qualcomm-prod/ajmq44Q1W0vLtUT4/Tools/QVSCE/images/stepper_get_started_button.png?fit=max&auto=format&n=ajmq44Q1W0vLtUT4&q=85&s=ee9cd330a690de36a5589f7974e10e2a" alt="Get Started button on Home page" width="858" height="427" data-path="Tools/QVSCE/images/stepper_get_started_button.png" />

The wizard configures your host and dev kit in 5 steps:

<AccordionGroup>
  <Accordion title="Step 1 — Dev Kit" icon="server" defaultOpen="true">
    Select the development kit you want to target. If a device is already connected via USB, the extension detects and pre-selects it. You can also select a kit that is not yet physically connected.

    <img src="https://mintcdn.com/qualcomm-prod/ajmq44Q1W0vLtUT4/Tools/QVSCE/images/stepper_devkit_selection.png?fit=max&auto=format&n=ajmq44Q1W0vLtUT4&q=85&s=04d5bc4ee5c1cdcd27d25678abec9ced" alt="Wizard — dev kit selection" width="1920" height="1140" data-path="Tools/QVSCE/images/stepper_devkit_selection.png" />

    <Tip>
      **Qualcomm Device Cloud** support — develop and debug on cloud-hosted devices — is coming soon.
    </Tip>

    <Warning>
      Device not showing up? Verify the USB cable, check `lsusb`, and confirm [udev rules](./setup/udev-rules) and [WSL USB forwarding](./setup/wsl-usb) are configured.
    </Warning>
  </Accordion>

  <Accordion title="Step 2 — Operating System" icon="circle-half-stroke">
    Choose the target OS for the selected dev kit. Select the **Variant** and **Version** using the inline dropdowns. The selected device is shown in the top-right corner.

    <img src="https://mintcdn.com/qualcomm-prod/ajmq44Q1W0vLtUT4/Tools/QVSCE/images/stepper_osvariant_selection.png?fit=max&auto=format&n=ajmq44Q1W0vLtUT4&q=85&s=45e6bb5c79333c3df9e169f49cf4c95d" alt="Wizard — OS selection" width="1920" height="1140" data-path="Tools/QVSCE/images/stepper_osvariant_selection.png" />
  </Accordion>

  <Accordion title="Step 3 — SDKs" icon="box">
    The wizard lists SDKs available for the selected dev kit and OS. Select the version using the inline dropdown. The latest version for your host architecture (x86\_64 or arm64) is pre-selected.

    <img src="https://mintcdn.com/qualcomm-prod/ajmq44Q1W0vLtUT4/Tools/QVSCE/images/stepper_sdk_selection.png?fit=max&auto=format&n=ajmq44Q1W0vLtUT4&q=85&s=43f3db63fc227e61bab50a3a7c8b8f20" alt="Wizard — SDK selection" width="1920" height="1140" data-path="Tools/QVSCE/images/stepper_sdk_selection.png" />

    <Note>
      To change the SDK version after initial setup, go to **Dashboard → Downloads → SDK tab**.
    </Note>
  </Accordion>

  <Accordion title="Step 4 — Host Tools" icon="wrench">
    Select the development tools to install on your host machine:

    <img src="https://mintcdn.com/qualcomm-prod/ajmq44Q1W0vLtUT4/Tools/QVSCE/images/stepper_sw_selection.png?fit=max&auto=format&n=ajmq44Q1W0vLtUT4&q=85&s=b12e15af3e98fb91c38aa13c38b85479" alt="Wizard — host tools selection" width="1920" height="1140" data-path="Tools/QVSCE/images/stepper_sw_selection.png" />

    <CardGroup cols={2}>
      <Card title="Host Software" icon="terminal">
        ADB, GCC toolchain, and debugger. ADB is required and cannot be deselected.
      </Card>

      <Card title="VS Code Extensions" icon="puzzle-piece">
        C/C++ IntelliSense, CMake Tools, and others that enhance the editor.
      </Card>
    </CardGroup>

    <Tip>
      Keep the defaults if unsure. You can add more tools later from **Dashboard → Downloads**.
    </Tip>

    <Warning>
      Some tools require elevated privileges. Watch the **VS Code Terminal** for `sudo` password prompts (**View → Terminal** if hidden).
    </Warning>
  </Accordion>

  <Accordion title="Step 5 — Downloads" icon="download">
    Click **Download & Install** to fetch and install everything from the previous steps. Progress is shown across four sections: **Operating System**, **SDK**, **Tools**, and **Extensions**.

    <img src="https://mintcdn.com/qualcomm-prod/ajmq44Q1W0vLtUT4/Tools/QVSCE/images/stepper_software_downloads.png?fit=max&auto=format&n=ajmq44Q1W0vLtUT4&q=85&s=84c637446174ef368318e51fd4c731a2" alt="Wizard — downloads and installation" width="1920" height="1140" data-path="Tools/QVSCE/images/stepper_software_downloads.png" />

    <Tip>
      Use **Install from archive** (OS) or **Install from zip** (SDK) to skip the download if you already have the files on disk.
    </Tip>

    <Warning>
      **Do not close VS Code** during the download — interrupted installs can break the toolchain. Watch the Terminal for `sudo` prompts.
    </Warning>

    After installation, all software appears in **Dashboard → Downloads**:

    | Tab              | Contents                                                         |
    | ---------------- | ---------------------------------------------------------------- |
    | Operating System | OS images for your dev kit — flash directly from here            |
    | SDKs             | Host-side libraries and headers — configure device after install |
    | Tools            | CLI tools (ADB, GCC toolchain, debugger)                         |
    | Extensions       | VS Code extensions (C/C++, CMake Tools, etc.)                    |
  </Accordion>
</AccordionGroup>

***

## Step 2 — Activate Your Device

Navigate to the **Device** section and click **Activate** next to your connected device. This sets it as the *Active Device* for builds and flashing.

<img src="https://mintcdn.com/qualcomm-prod/RietNfmN9gs2vaJw/Tools/QVSCE/images/devices_available.png?fit=max&auto=format&n=RietNfmN9gs2vaJw&q=85&s=86c20a8929cc42318d85393ed1b54212" alt="Available devices list" width="670" height="199" data-path="Tools/QVSCE/images/devices_available.png" />

<img src="https://mintcdn.com/qualcomm-prod/RietNfmN9gs2vaJw/Tools/QVSCE/images/devices_active.png?fit=max&auto=format&n=RietNfmN9gs2vaJw&q=85&s=22d4796b9b434d0a565d33420f4fc6fa" alt="Activated device" width="654" height="346" data-path="Tools/QVSCE/images/devices_active.png" />

<Note>
  For devices running Ubuntu OS, see the [Ubuntu Device
  Setup](./setup/install-vscode#ubuntu-device-setup) section.
</Note>

***

## Step 3 — Flash Device Software

Open **Dashboard → Downloads → Operating System tab** and click **Flash & Setup Device** next to the image for your dev kit.

<img src="https://mintcdn.com/qualcomm-prod/C3kDUdllcH5eq3jY/Tools/QVSCE/images/dashboard_downloads_os.png?fit=max&auto=format&n=C3kDUdllcH5eq3jY&q=85&s=ef4dce200d2a521fba286a4ba371553d" alt="Downloads — Operating System tab" width="1569" height="378" data-path="Tools/QVSCE/images/dashboard_downloads_os.png" />

<Warning>
  **Do not disconnect the device during flashing.** An interrupted flash can
  destabilize the device and may require power-cycle + manual EDL + reflash to
  recover.
</Warning>

***

## Step 4 — Develop Your Application

Navigate to **Projects** to browse sample projects or import templates from the SDK. IntelliSense is configured automatically when a project is open.

<img src="https://mintcdn.com/qualcomm-prod/RietNfmN9gs2vaJw/Tools/QVSCE/images/projects_recent.png?fit=max&auto=format&n=RietNfmN9gs2vaJw&q=85&s=135cdf6885aa499bfdf9a802b1a51e15" alt="Projects — recent projects" width="332" height="226" data-path="Tools/QVSCE/images/projects_recent.png" />

Use the **Status Bar buttons** to build, deploy, run, and select your target device:

<CardGroup cols={3}>
  <Card title="Build" icon="hammer">
    Cross-compile the application for the active device.
  </Card>

  <Card title="Deploy" icon="rocket">
    Build and push the binary to the active device.
  </Card>

  <Card title="Run" icon="play">
    Execute the deployed binary on the device.
  </Card>

  <Card title="Refresh Device" icon="arrows-rotate">
    Re-scan for connected devices.
  </Card>

  <Card title="Select a Connected Device" icon="microchip">
    Choose which connected device to target.
  </Card>
</CardGroup>

<img src="https://mintcdn.com/qualcomm-prod/C3kDUdllcH5eq3jY/Tools/QVSCE/images/status_bar_buttons.png?fit=max&auto=format&n=C3kDUdllcH5eq3jY&q=85&s=d61c51a239243b544eb62d961d4e973b" alt="VS Code Status Bar — Build, Deploy, Run, Refresh Device, and device selector buttons" width="1548" height="1016" data-path="Tools/QVSCE/images/status_bar_buttons.png" />

<Warning>
  By default, **Deploy** installs the binary at `/usr/bin`, overwriting any
  existing binary with the same name on the device.
</Warning>