> ## 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.

# Flash Ubuntu using Qualcomm® Launcher

> Use the Qualcomm Launcher GUI tool to download and flash Ubuntu onto the IQ-9075 EVK from any host OS.

**Qualcomm® Launcher** is a graphical tool that handles downloading and flashing OS images onto Qualcomm development kits. It runs on **Windows, Linux, and macOS** and requires no command-line setup. The tool manages the image download and flashing process end to end.

Use this method if you prefer a GUI workflow. If you need full control or are scripting an automated setup, use [**Flash Ubuntu using QDL**](./flash-over-qli) instead.

<Warning>
  Flashing erases all data on the device. Back up anything important before you begin.
</Warning>

## What you need

* IQ-9075 EVK with 12 V power supply
* USB Type-C cable (USB0 port on the EVK → host computer)
* Micro-USB cable (for the UART setup step after flashing)
* Host computer running Windows, Linux, or macOS
* Powered USB hub (recommended): the EVK's two Type-C ports (USB0, USB1) sit close together, and a hub also helps if your host is short on USB ports. Needed if you plan to use the board as an SBC with a keyboard, mouse, and other USB peripherals.

## Step 1: Install Qualcomm Launcher

1. Go to the Qualcomm Software Center: [**https://softwarecenter.qualcomm.com/catalog/item/Qualcomm\_Launcher**](https://softwarecenter.qualcomm.com/catalog/item/Qualcomm_Launcher)
2. Select the **OS type** and **architecture** that matches your host machine.
3. Download the latest version and run the installer.

<img src="https://mintcdn.com/qualcomm-prod/kAKe9NmJg3DGZBpB/Ubuntu/images/update-software/qsc_launcher_download.png?fit=max&auto=format&n=kAKe9NmJg3DGZBpB&q=85&s=4e542e1f872888964cd1260278d6b60d" alt="Qualcomm Launcher download page" width="1920" height="1304" data-path="Ubuntu/images/update-software/qsc_launcher_download.png" />

Once installed, open the **Qualcomm Launcher** application.

<Accordion title="Ubuntu host: device not detected? Set up udev rules first" icon="triangle-exclamation">
  On Ubuntu, the kernel needs a udev rule to grant permission to communicate with the device when it enters EDL mode. Without this rule, the Launcher will not detect the device even when it is connected and powered on.

  **1. Check whether the rule already exists:**

  ```shell theme={null}
  ls /etc/udev/rules.d/51-qcom-usb.rules
  ```

  **2. If the file is not present, create it in one command:**

  ```shell theme={null}
  echo 'SUBSYSTEMS=="usb", ATTRS{idVendor}=="05c6", ATTRS{idProduct}=="9008", MODE="0664", GROUP="plugdev"' | sudo tee /etc/udev/rules.d/51-qcom-usb.rules
  ```

  If the file already exists, verify the rule is present:

  ```shell theme={null}
  cat /etc/udev/rules.d/51-qcom-usb.rules
  ```

  **3. Reload udev:**

  ```shell theme={null}
  sudo systemctl restart udev
  ```

  If the USB cable was already connected, disconnect and reconnect it.

  You only need to do this once. After that, the Launcher will detect the device automatically.
</Accordion>

## Step 2: Select your development kit

On the **Choose OS** screen, click **Select Development Kit** and choose **IQ-9075 Evaluation Kit** from the list.

<img src="https://mintcdn.com/qualcomm-prod/kAKe9NmJg3DGZBpB/Ubuntu/images/update-software/iq9075-launcher-select-kit.png?fit=max&auto=format&n=kAKe9NmJg3DGZBpB&q=85&s=3a81bff240b2e7f537174c76577b597a" alt="Select Development Kit dialog" width="1440" height="1264" data-path="Ubuntu/images/update-software/iq9075-launcher-select-kit.png" />

## Step 3: Choose the OS image

With the kit selected, the **Choose OS** screen shows the operating system options.

1. Under **Target Operating System**, select the **Ubuntu** card.
2. Leave **Official** selected and choose the image (**Ubuntu Server** or **Ubuntu Desktop**) and the latest available version from the two dropdowns. (To flash a locally built image instead, use **Custom → Select Folder**.)
3. Leave the **Download Location** at the default, or choose a custom folder with enough space.

<img src="https://mintcdn.com/qualcomm-prod/kAKe9NmJg3DGZBpB/Ubuntu/images/update-software/iq9075-launcher-choose-os.png?fit=max&auto=format&n=kAKe9NmJg3DGZBpB&q=85&s=724959951ce1f452cae1242c8288e6bf" alt="Ubuntu selected on the Choose OS screen" width="1436" height="1300" data-path="Ubuntu/images/update-software/iq9075-launcher-choose-os.png" />

## Step 4: Put the device in EDL mode

Emergency Download (EDL) mode tells the device to accept a new firmware image over USB. Until the device is detected, the **Choose OS** screen shows *No compatible device detected* and the **Flash** button stays disabled.

1. **Turn on** the SW2-3 DIP switch by pushing it up.

   <img src="https://mintcdn.com/qualcomm-prod/kAKe9NmJg3DGZBpB/Ubuntu/images/update-software/EDL_mode_dipSwitch.png?fit=max&auto=format&n=kAKe9NmJg3DGZBpB&q=85&s=f5764a27d34ffd1dd36f97bb81a5a2bf" alt="SW2-3 DIP switch location" width="1131" height="318" data-path="Ubuntu/images/update-software/EDL_mode_dipSwitch.png" />

2. Connect the **12 V power supply** to the EVK.

3. Connect the **USB Type-C cable** from **USB0** on the EVK to your host computer.

   <img src="https://mintcdn.com/qualcomm-prod/kAKe9NmJg3DGZBpB/Ubuntu/images/update-software/iq9075-flashsetup.png?fit=max&auto=format&n=kAKe9NmJg3DGZBpB&q=85&s=62735e8fd3f1b3cdb680ae392a222625" alt="Flash setup: USB and power connections" width="926" height="672" data-path="Ubuntu/images/update-software/iq9075-flashsetup.png" />

4. Toggle the **power switch** to turn on the device.

Once the device enumerates in EDL mode, the **Flash** button becomes active.

<img src="https://mintcdn.com/qualcomm-prod/kAKe9NmJg3DGZBpB/Ubuntu/images/update-software/iq9075-launcher-flash-ready.png?fit=max&auto=format&n=kAKe9NmJg3DGZBpB&q=85&s=9df35d620255f707fe0d1484ecc44b54" alt="Flash button active once the device is detected" width="1440" height="1100" data-path="Ubuntu/images/update-software/iq9075-launcher-flash-ready.png" />

## Step 5: Flash

Click the **Flash** button. The Launcher first downloads the OS image, then flashes the device in two phases.

**Phase 1: Additional firmware.** The Launcher provisions UFS storage and writes the CDT, then advances to the OS image. When this phase finishes, it pauses and asks you to put the device back into EDL mode:

<img src="https://mintcdn.com/qualcomm-prod/kAKe9NmJg3DGZBpB/Ubuntu/images/update-software/iq9075-launcher-edl-reprompt.png?fit=max&auto=format&n=kAKe9NmJg3DGZBpB&q=85&s=f9052f1139d2973841c5f3963495a492" alt="Put Device in EDL Mode to Continue prompt" width="1439" height="1250" data-path="Ubuntu/images/update-software/iq9075-launcher-edl-reprompt.png" />

The SW2-3 DIP switch is still up, so simply **toggle the power switch off and on**. The device re-enters EDL mode and the Launcher continues automatically.

**Phase 2: OS image.** The Launcher downloads the operating system image and writes it to the device. Keep power and USB connected throughout.

<img src="https://mintcdn.com/qualcomm-prod/kAKe9NmJg3DGZBpB/Ubuntu/images/update-software/iq9075-launcher-os-download.png?fit=max&auto=format&n=kAKe9NmJg3DGZBpB&q=85&s=d9e7e02e8541a03a950cdb815f819de9" alt="OS image download in progress" width="1436" height="1100" data-path="Ubuntu/images/update-software/iq9075-launcher-os-download.png" />

If the Launcher appears to hang waiting for the device, toggle the power switch off and on; it will reconnect and continue.

<img src="https://mintcdn.com/qualcomm-prod/kAKe9NmJg3DGZBpB/Ubuntu/images/update-software/iq9075-launcher-os-flash.png?fit=max&auto=format&n=kAKe9NmJg3DGZBpB&q=85&s=33e45b3584d91161b9a9bf21ceaf6a7a" alt="OS image flash in progress" width="1440" height="1100" data-path="Ubuntu/images/update-software/iq9075-launcher-os-flash.png" />

When flashing is complete, the status shows **OS image Flash completed successfully** and the **Configure Login** button becomes active.

<img src="https://mintcdn.com/qualcomm-prod/kAKe9NmJg3DGZBpB/Ubuntu/images/update-software/iq9075-launcher-flash-complete.png?fit=max&auto=format&n=kAKe9NmJg3DGZBpB&q=85&s=85d7cdab2dbfecd7f5df511f3cef260e" alt="Flash completed successfully" width="1432" height="1100" data-path="Ubuntu/images/update-software/iq9075-launcher-flash-complete.png" />

## Step 6: Configure login

The Launcher can guide you through serial and network setup automatically. You can complete this step here, or skip it and follow the manual instructions in [**Set up the device**](../set-up-the-device).

**To continue with the Launcher:**

1. Turn off the **SW2-3 DIP switch** by pushing it down. Keep the device in normal boot mode for the rest of setup; do not switch back to EDL.
2. Connect the **micro-USB cable** from the **JTAC** port on the EVK to your host computer.
3. Power-cycle the device (turn off, then on using the power switch).
4. Click **Configure Login**.

The Launcher detects the serial connection and shows **UART Connection Status: Connected**. Enter and confirm a **new password** for the device, then click **Sign In to Device**.

<img src="https://mintcdn.com/qualcomm-prod/kAKe9NmJg3DGZBpB/Ubuntu/images/update-software/iq9075-launcher-configure-login.png?fit=max&auto=format&n=kAKe9NmJg3DGZBpB&q=85&s=13d6389789b8795ce2a14c1f6541ad64" alt="UART connected, create a new password" width="1438" height="1350" data-path="Ubuntu/images/update-software/iq9075-launcher-configure-login.png" />

<Note>
  This flow replaces the default `ubuntu` / `ubuntu` credentials with the password you set here. Remember it; you will use it to SSH into the device.
</Note>

## Step 7: Set up Wi-Fi

The **SSH Access** screen shows the available Wi-Fi networks.

* Select a network from the list, or click **+ Add network** to enter credentials manually.
* Click **Configure Wi-Fi**.

The device connects to the network.

<img src="https://mintcdn.com/qualcomm-prod/kAKe9NmJg3DGZBpB/Ubuntu/images/update-software/iq9075-launcher-wifi.png?fit=max&auto=format&n=kAKe9NmJg3DGZBpB&q=85&s=9fa2439c4559cf849fa34ff44abf1a82" alt="Wi-Fi network selection" width="1438" height="1050" data-path="Ubuntu/images/update-software/iq9075-launcher-wifi.png" />

## Step 8: Setup complete

Once Wi-Fi is configured, the Launcher displays the **Configuration Summary** with the device IP address and the SSH command ready to copy. The device reboots once to apply the post-flash configuration.

<img src="https://mintcdn.com/qualcomm-prod/kAKe9NmJg3DGZBpB/Ubuntu/images/update-software/iq9075-launcher-setup-complete.png?fit=max&auto=format&n=kAKe9NmJg3DGZBpB&q=85&s=d86e3aeb2e79d9837b7004e4f466621c" alt="Setup complete: configuration summary" width="1436" height="1400" data-path="Ubuntu/images/update-software/iq9075-launcher-setup-complete.png" />

You can now SSH directly into the device using the password you set in Step 6:

```shell theme={null}
ssh ubuntu@<ip-address>
```

<Note>
  If Qualcomm Launcher does not work on your host or does not detect the device, use [**Flash Ubuntu using QDL**](./flash-over-qli) as an alternative.
</Note>

## Next steps

After successfully setting up Wi-Fi, choose one of the following paths for additional driver installation and application development:

<Tabs>
  <Tab title="Manual Method">
    Continue to [**Set up the device**](../set-up-the-device) to verify the software version, connect over SSH, and set up the display.
  </Tab>

  <Tab title="IDE Method">
    You can create AI and multimedia applications on the IQ-9075 EVK using the **Qualcomm® Visual Studio Code Extension**, an integrated development environment for Qualcomm development kits. The extension runs on Ubuntu (or WSL with Ubuntu) and facilitates device configuration, software development including compilation, debugging, and binary flashing.

    For more information, see the [**Qualcomm Visual Studio Code Extension Reference Guide**](https://docs.qualcomm.com/bundle/publicresource/topics/80-79972-1/quick_start.html).
  </Tab>
</Tabs>
