Skip to main content
This section describes how to enable OpenCV library and run OpenCV test application Getting started workflow

​
Prerequisites

  • Set up your infrastructure as described in the Qualcomm Linux Build Guide
  • Flash the latest software release to the development board.
  • Set up SSH connection: Enable SSH in Permissive mode by performing the steps mentioned in Use SSH
  • Confirm that the libopencv_fastcv library is present /usr/lib on the target. Occasionally, downloading the fastcv_linux_aarch64_2025_07_09.tgz fails, resulting in the libopencv_fastcv libraries not being generated. If the library is missing, download the latest bitbake file (opencv_4.13.0.bb) and recompile the build. After flashing the build, confirm that the libopencv_fastcv library is present in /usr/lib.
NoteBy default, test apps are enabled in builds due to https://github.com/qualcomm-linux/meta-qcom/blob/master/dynamic-layers/openembedded-layer/recipes-support/opencv/opencv_%25.bbappend

​
Enable the OpenCV library and test package

  1. To retain test bins, include the following code in the <WORKSPACE>/dynamic-layers/openembedded-layer/recipes-support/opencv/opencv_%.bbappend recipe file: 
    RM_WORK_EXCLUDE += "opencv"
  2. When the build is already compiled, OpenCV must be cleaned before compilation. To clean OpenCV, run the following command: 
    bitbake -fc cleanall opencv
    During compilation no code is modified, so a direct compilation doesn’t generate the corresponding bins.
  3. To compile OpenCV, run the following command: 
    bitbake opencv
The path to the libraries is tmp-glibc\sysroots-components\armv8-2a\opencv\usr\lib. The path to the bins is tmp-glibc\work\armv8-2a-qcom-linux\opencv\4.13.0\build\bin.

​
Run the existing test application

To invoke the OpenCV API, native OpenCV test examples can reference sample applications. Use the following procedure to invoke applications on the Snapdragon target. Compile the full build image to ensure that all libraries are part of the application images.
  1. Flash the images on the device as described in the Qualcomm Linux Build Guide. OpenCV libraries are on the device at /usr/lib.
  2. For test data, clone the projects at https://github.com/opencv/opencv_extra/tree/4.13.0. 
    git clone https://github.com/opencv/opencv_extra.git -b 4.13.0
  3. To avoid read only errors while trying to push test data and bins to the device, use the device IP address to log in to an SSH terminal and run the following command to remount the device. 
    mount -o remount,rw /usr
  4. Use the scp command to push the test data to a preferred host location. For example: scp -r {[file]} root@{[IP-ADDR]}:/tmp
  5. Use the scp command to push the required test bin to /usr/bin. For example: scp -r {[test]} root@{[IP-ADDR]}:/usr/bin/
  6. Sign in to an SSH terminal and run the following commands. 
    chmod 777 /usr/bin/<opencv_test_bin>
cd /usr/bin
export OPENCV_LOG_LEVEL=DEBUG
export OPENCV_VIDEOIO_DEBUG=1
export OPENCV_TEST_DATA_PATH=/tmp
./<opencv_test_bin> --gtest_output=json:/tmp/results.json
exit
    Results are stored in /tmp/results.json. To change the results filename, modify the --gtest_output=json:/tmp/{results.json} argument.