> ## 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 Qualcomm Linux using Qualcomm® Launcher

> Use the Qualcomm Launcher GUI tool to download and flash Qualcomm Linux onto the IQ-8275 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 Qualcomm Linux 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-8275 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

## 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/ZhwPHeig5GFrMRIg/Linux/images/update-software/qsc_launcher_download.png?fit=max&auto=format&n=ZhwPHeig5GFrMRIg&q=85&s=e769e9ce43575ef394a48bff9ee4d5f6" alt="Qualcomm Launcher download page" width="1920" height="1304" data-path="Linux/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-8275 Evaluation Kit** from the list.

<img src="https://mintcdn.com/qualcomm-prod/ZhwPHeig5GFrMRIg/Linux/images/update-software/iq8275-launcher-select-kit.png?fit=max&auto=format&n=ZhwPHeig5GFrMRIg&q=85&s=5b7e9846bbd7fd17ed02cba830368be9" alt="Select Development Kit dialog" width="1440" height="1264" data-path="Linux/images/update-software/iq8275-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 **Qualcomm Linux** card.
2. Leave **Official** selected and choose the image 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/jy6NQT2Y7J_sAxdX/Linux/images/update-software/iq8275-launcher-choose-os.png?fit=max&auto=format&n=jy6NQT2Y7J_sAxdX&q=85&s=271a74015aeeb64202d36f97deb12990" alt="Qualcomm Linux selected on the Choose OS screen" width="1439" height="1300" data-path="Linux/images/update-software/iq8275-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/jy6NQT2Y7J_sAxdX/Linux/images/update-software/EDL_mode_dipSwitch.png?fit=max&auto=format&n=jy6NQT2Y7J_sAxdX&q=85&s=6de979ba0cbd239bd475db7e4d470fe4" alt="SW2-3 DIP switch location" width="1131" height="318" data-path="Linux/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/ZhwPHeig5GFrMRIg/Linux/images/update-software/iq9075-flashsetup.png?fit=max&auto=format&n=ZhwPHeig5GFrMRIg&q=85&s=10f1fada572b2d0ac2592cf1da9b2292" alt="Flash setup: USB and power connections" width="926" height="672" data-path="Linux/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/ZhwPHeig5GFrMRIg/Linux/images/update-software/iq8275-launcher-flash-ready.png?fit=max&auto=format&n=ZhwPHeig5GFrMRIg&q=85&s=e574354cbaa518c37ffc832e369c73b2" alt="Flash button active once the device is detected" width="1431" height="1100" data-path="Linux/images/update-software/iq8275-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/jy6NQT2Y7J_sAxdX/Linux/images/update-software/iq8275-launcher-edl-reprompt.png?fit=max&auto=format&n=jy6NQT2Y7J_sAxdX&q=85&s=c03cfb7d402a26051ec1e3fe5d5dd17b" alt="Put Device in EDL Mode to Continue prompt" width="1440" height="1300" data-path="Linux/images/update-software/iq8275-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 writes the operating system image. Keep power and USB connected throughout. 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/ZhwPHeig5GFrMRIg/Linux/images/update-software/iq8275-launcher-os-flash.png?fit=max&auto=format&n=ZhwPHeig5GFrMRIg&q=85&s=c5747a23d709b76fd829039bbec9d1ed" alt="OS image flash in progress" width="1435" height="1100" data-path="Linux/images/update-software/iq8275-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/jy6NQT2Y7J_sAxdX/Linux/images/update-software/iq8275-launcher-flash-complete.png?fit=max&auto=format&n=jy6NQT2Y7J_sAxdX&q=85&s=05e96e87fe2e62198b61e2c844d52283" alt="Flash completed successfully" width="1436" height="1100" data-path="Linux/images/update-software/iq8275-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/jy6NQT2Y7J_sAxdX/Linux/images/update-software/iq8275-launcher-configure-login.png?fit=max&auto=format&n=jy6NQT2Y7J_sAxdX&q=85&s=54493170f2231c9f1a3cfd675ec8a5aa" alt="UART connected, create a new password" width="1438" height="1350" data-path="Linux/images/update-software/iq8275-launcher-configure-login.png" />

<Note>
  This flow replaces the default `root` / `oelinux123` 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/ZhwPHeig5GFrMRIg/Linux/images/update-software/iq8275-launcher-wifi.png?fit=max&auto=format&n=ZhwPHeig5GFrMRIg&q=85&s=d326595a1f9883a3767d977b63c43861" alt="Wi-Fi network selection" width="1438" height="1050" data-path="Linux/images/update-software/iq8275-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/ZhwPHeig5GFrMRIg/Linux/images/update-software/iq8275-launcher-setup-complete.png?fit=max&auto=format&n=ZhwPHeig5GFrMRIg&q=85&s=e12d3e1409b121257d6a83c5a1acc689" alt="Setup complete: configuration summary" width="1436" height="1500" data-path="Linux/images/update-software/iq8275-launcher-setup-complete.png" />

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

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

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

## Next steps

* [**Set up the device**](../set-up-the-device). If you skipped the UART/Wi-Fi setup above, follow the manual instructions there.
