Yocto platform

This section explains how to compile QIM SDK plugins for Yocto platform.

On-host Compilation
On-device Compilation

This section explains how to compile QIM SDK plugins directly on a x86 and Arm host machine running Ubuntu.

Prerequisites

Before you begin, ensure the following:

Internet connectivity for downloading packages and source code.
Sufficient space on the host to download the SDK. Upto ~5GB.

Download and install the sdk.

Download SDK

x86 Host
Arm Host

wget -O sdk.zip https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/meta-qcom/qcom-distro/qcom-armv8a/x64-qli-2.0-qimsdk-2.0.0-standardsdk.zip

wget -O sdk.zip https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/meta-qcom/qcom-distro/qcom-armv8a/arm-qli-2.0-qimsdk-2.0.0-standardsdk.zip

Extract and Install the SDK

unzip sdk.zip && cd images/qcom-armv8a/sdk/

x86 Host
Arm Host

bash qcom-distro-x86_64-qcom-multimedia-proprietary-image-armv8a-qcom-armv8a-toolchain-2.0.sh -d <path_to_install_sdk> -y

bash qcom-distro-aarch64-qcom-multimedia-proprietary-image-armv8a-qcom-armv8a-toolchain-2.0.sh -d <path_to_install_sdk> -y

Source the cross-compilation toolchain environment

source <path_to_install_sdk>/environment-setup-armv8a-qcom-linux

Each time you wish to use the SDK in a new shell session, you need to source the environment setup script in Step 3

Steps to Compile

To download the source code and compile the sample applications, run the following commands.

Clone the sources from github

git clone https://github.com/qualcomm/qimsdk.git
cd qimsdk

Compile base libraries

cmake -B build-base -S . \
  -DCMAKE_INSTALL_PREFIX=/usr \
  -DENABLE_GST_PLUGIN_BASE=1 \
&& cmake --build build-base

Install base libraries to SDK sysroot path

DESTDIR="${SDKTARGETSYSROOT}" cmake --install build-base --prefix /usr

Compile plugins and app builders sample apps with updated base libraries

cmake -B build -S . \
  -DCMAKE_INSTALL_PREFIX=/usr \
  -DENABLE_GST_IMSDK_PLUGINS=1 \
  -DENABLE_GST_PLUGIN_MLTFLITE=1 \
  -DENABLE_GST_PYTHON_EXAMPLES=1 \
  -DENABLE_GST_SAMPLE_APPS=1 \
  -DENABLE_GST_SAMPLE_APPS_CAMERA=1 \
  -DENABLE_GST_PLUGIN_TOOLS=1 \
  -DENABLE_GST_CAMERA_PLUGINS=1 \
  -DENABLE_APP_BUILDER_CPP=1 \
  -DENABLE_APP_BUILDER_PYTHON=1 \
&& cmake --build build

After modifying any part of the source code, re-run step 4 to rebuild your changes. The corresponding libs from build directory can then be copied on to device.

Steps to build custom application

Go through the prerequisites and Steps to Compile section before starting this.

GStreamer Sample App
C++ App Builder

Create a subdirectory in gst-sample-apps

cd qimsdk/gstreamer/gst-sample-apps && mkdir gst-<your_sample_apps>

Build the application

Follow Steps to Compile

Copy the binary to target device

#The application will be found in the below location
qimsdk/build/gstreamer/gst-sample-apps/gst-<your_sample_app>/

Create a subdirectory in cpp reference-apps

cd qimsdk/cpp/examples/reference-apps/ && mkdir <your_sample_app>

Build the application

Follow Steps to Compile

Copy the binary to target device

#The application will be found in the below location
qimsdk/build/cpp/examples/reference-apps/<your_sample_app>/

Overview

Supported AI Models

Plugins

Advanced Topics

Prerequisites

Download and install the sdk.

Steps to Compile

Steps to build custom application

​Prerequisites

​Download and install the sdk.

​Steps to Compile

​Steps to build custom application

Prerequisites

Download and install the sdk.

Steps to Compile

Steps to build custom application