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

# Run using QDemo Application

> Run sample applications on the Qualcomm Dragonwing IQ-8275 Evaluation Kit using preinstalled Qdemo GUI.

<Note>
  Currently, the Qdemo application isn't supported through the GUI launcher icon. Launch the Qdemo application from the device terminal using `sudo`.
</Note>

The Qualcomm<sup>®</sup> Dragonwing<sup>TM</sup> IQ-8275 Evaluation Kit (EVK) is preinstalled with Qdemo, a graphical user interface (GUI) application designed to run sample applications without a host setup. The Qdemo application allows you to experience the AI and multimedia capabilities of the development kit with just a few clicks.

Qualcomm Linux<sup>®</sup> provides the following types of sample applications for use cases such as retail, Qualcomm Edge AI Box Solutions, and IP camera:

* **Multimedia sample applications**, which show camera, video, and audio functionalities.
* **AI sample applications**, which show AI and machine learning (ML) capabilities.

The following table lists the sample applications that you can run using Qdemo. For the complete list of available applications, see [Sample applications](https://imsdkdocs.qualcomm.com/sample-application/ai-sample-applications).

**Table: List of applications supported in Qdemo**

| Application                 | Description                                                                                                                                                                                                                                              |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Multimedia applications** |                                                                                                                                                                                                                                                          |
| DashCamera                  | Streams from two camera sensors simultaneously and displays the feeds side by side on a screen. This application is suitable for dash cameras or stereo camera use cases, which require capturing videos from multiple cameras for viewing or archiving. |
| Record live video           | Records camera feed and saves videos up to 30 sec. This application uses a single camera that supports outputs such as preview and encoding.                                                                                                             |
| VideoWall                   | Plays MP4 AVC (H.264) videos concurrently and composes them on a video wall display. Before running this application, ensure that you have a recorded video or record one using the evaluation kit.                                                      |
| **AI applications**         |                                                                                                                                                                                                                                                          |
| Daisychain Pose             | Performs cascaded object detection and classification on the images streamed from a camera.                                                                                                                                                              |
| FaceDetection               | Processes inputs from a camera and uses the Qualcomm<sup>®</sup> AI Hub detection model to produce a preview.                                                                                                                                            |
| Multistream                 | Shows AI inference (object detection) on input streams from a camera or a file.                                                                                                                                                                          |
| ObjectDetection             | Detects objects in camera streams.                                                                                                                                                                                                                       |
| Parallel-AI-Fusion          | Detects and classifies objects, detects poses, and segments images from a camera input stream.                                                                                                                                                           |

* **Qualcomm Linux multimedia image**: The device must be flashed with the prebuilt Qualcomm Linux multimedia image (`qcom-multimedia-image`), which includes Qdemo and the Qualcomm IM SDK.
* **HDMI monitor**: Connect to the device to view Qdemo output.
* **Mouse and keyboard**: Required to interact with the Weston desktop and the Qdemo application.
* **Wi-Fi connection**: Required for AI sample applications to download models and labels from GitHub. Not required for multimedia applications.
* **USB camera (optional)**: Required for camera-based sample applications. If connected, select it from the `Source` list in Qdemo.
  To use a camera, enable `camx` on the device by running the following commands on the target device:
  ```shell theme={null}
  echo -n "camx" > /var/data
  efivar -n 882f8c2b-9646-435f-8de5-f208ff80c1bd-VendorDtbOverlays -w -f /var/data
  efivar -n 882f8c2b-9646-435f-8de5-f208ff80c1bd-VendorDtbOverlays -p
  sync
  reboot
  ```

## Run sample applications using Qdemo

To run sample applications using Qdemo, do the following:

<Steps>
  <Step title="Connect peripherals to the device">
    Connect the mouse, keyboard, camera, monitor, and power cable to the device.

    The following figure shows the display ports, USB ports, Ethernet port, power supply port and power on-off switch. Connect the peripheral devices to these ports, including a USB or MIPI camera. For display, connect one end of the Mini DisplayPort cable to **DisplayPort0** on the Dragonwing IQ-8275 device, and the other end to your monitor.

    <Note>
      To connect the EVK to a display through HDMI, use an HDMI cable and adapter, then connect it to an active DisplayPort on the EVK. The HDMI cable and adapter aren't included with the EVK.
    </Note>

    <Frame>
      <img src="https://mintcdn.com/qualcomm-prod/jy6NQT2Y7J_sAxdX/Linux/images/run-sample-applications/iq8-backview-ports.png?fit=max&auto=format&n=jy6NQT2Y7J_sAxdX&q=85&s=777f00fe9e47e8eee3d753d3b927252f" alt="IQ-8275 back view showing ports" width="690" height="547" data-path="Linux/images/run-sample-applications/iq8-backview-ports.png" />
    </Frame>
  </Step>

  <Step title="Power on the device">
    Toggle the power switch to the On position.

    After the device powers on, the following screen appears on the monitor.

    <Frame>
      <img src="https://mintcdn.com/qualcomm-prod/jy6NQT2Y7J_sAxdX/Linux/images/run-sample-applications/startup-screen.png?fit=max&auto=format&n=jy6NQT2Y7J_sAxdX&q=85&s=2b1a2b5f2396b585e35909e0adfa5fce" alt="IQ-8275 startup screen" width="1000" height="517" data-path="Linux/images/run-sample-applications/startup-screen.png" />
    </Frame>
  </Step>

  <Step title="Open the device shell">
    Open the device shell by selecting the weston-terminal icon.

    The following figure shows the weston-terminal icon on the screen.

    <Frame>
      <img src="https://mintcdn.com/qualcomm-prod/jy6NQT2Y7J_sAxdX/Linux/images/run-sample-applications/qdemo-icon.png?fit=max&auto=format&n=jy6NQT2Y7J_sAxdX&q=85&s=dfc5577b60ab27be25dcd0edcc366e6f" alt="Qdemo Q icon on screen" width="720" height="480" data-path="Linux/images/run-sample-applications/qdemo-icon.png" />
    </Frame>
  </Step>

  <Step title="Sign in as root user">
    Sign in as a root user by running the following command:

    ```bash theme={null}
    su -p
    ```

    When prompted for a password, enter `oelinux123`.
  </Step>

  <Step title="Launch the Qdemo application">
    Launch the Qdemo application by running the following command in the weston-terminal:

    ```bash theme={null}
    gst-gui-launcher-app.py
    ```

    The **Experience Application Demo** window appears.
  </Step>

  <Step title="Run a sample application">
    Run a sample application from the **Experience Application Demo** window as follows:

    <Steps>
      <Step title="Connect to Wi-Fi">
        Connect to a Wi-Fi network by selecting **Wi-Fi**.

        <Note>
          A Wi-Fi connection is required to run AI sample applications only. If you want to run a multimedia application, skip this step.
        </Note>

        The following figure shows a sample of the **Experience Application Demo** window:

        <Frame>
          <img src="https://mintcdn.com/qualcomm-prod/jy6NQT2Y7J_sAxdX/Linux/images/run-sample-applications/qdemo-wi-fi.png?fit=max&auto=format&n=jy6NQT2Y7J_sAxdX&q=85&s=6d9d5b79d8fec42160841c6f531fa829" alt="Experience Application Demo window with Wi-Fi option" width="605" height="525" data-path="Linux/images/run-sample-applications/qdemo-wi-fi.png" />
        </Frame>
      </Step>

      <Step title="Select the camera source">
        In the **Source** dropdown list, select the required camera.

        The Dragonwing IQ-8275 device doesn't have a built-in camera, and not all applications require a camera. If you've connected an external camera to the device, select it from the **Source** dropdown list. By default, the **On-Device-Camera** option is selected.
      </Step>

      <Step title="Select and start an application">
        In the **Applications** dropdown list, select an application and select **Start**.

        The selected application starts running, and a pop-up window displays the output on the screen.

        When you run a sample application for the first time, it may take a minute or more to run as the device downloads the AI models and labels from GitHub.

        The following figure shows the sample output of the Object Detection application, identifying two objects including a person and a dog.

        <Frame>
          <img src="https://mintcdn.com/qualcomm-prod/jy6NQT2Y7J_sAxdX/Linux/images/run-sample-applications/sample-output-object-detection-app.png?fit=max&auto=format&n=jy6NQT2Y7J_sAxdX&q=85&s=971426d5e62e6b3c26d4afc2367ce4b2" alt="Sample output of the Object Detection application" width="975" height="548" data-path="Linux/images/run-sample-applications/sample-output-object-detection-app.png" />
        </Frame>
      </Step>

      <Step title="Stop the application">
        Stop the sample application by closing the output window.
      </Step>
    </Steps>
  </Step>

  <Step title="Close Qdemo">
    Close the Qdemo application by selecting **Exit**.
  </Step>
</Steps>
