Skip to content

Latest commit

 

History

History
64 lines (41 loc) · 5.16 KB

README.md

File metadata and controls

64 lines (41 loc) · 5.16 KB
Raw

MIT licensed

                       

Pi-VX

OpenVX for Raspberry Pi

Raspberry Pi is an ultra low cost computer popular among the DIY developers. It's used in a myriad of commercial and hobbyist projects. OpenVX™ is an open, royalty-free API standard for cross-platform acceleration of computer vision applications developed by The Khronos Group. The Khronos Group is an open industry consortium of over 150 leading hardware and software companies creating advanced, royalty-free, acceleration standards for 3D graphics, Augmented and Virtual Reality, vision, and machine learning. Khronos standards include Vulkan®, OpenCL™, SYCL™, OpenVX™, NNEF™, and many others.

Application developers may always freely use Khronos Standards when they are available on the target system. To enable companies to test their products for conformance, Khronos has established an Adopters Program for each standard. This helps to ensure that Khronos standards are consistently implemented by multiple vendors to create a reliable platform for developers. Conformant products also enjoy protection from the Khronos IP Framework, ensuring that Khronos members will not assert their IP essential to the specification against the implementation.

The Khronos Group and the Raspberry Pi Foundation have come together to implement an open-source implementation of OpenVX™ 1.3, which passes the conformance on Raspberry Pi. The open-source implementation passes the Vision, Enhanced Vision, & Neural Net conformance profiles specified in OpenVX 1.3 on Raspberry Pi.

OpenVX enables a performance and power-optimized computer vision processing, especially important in embedded and real-time use cases such as face, body, and gesture tracking, smart video surveillance, advanced driver assistance systems (ADAS), object and scene reconstruction, augmented reality, visual inspection, robotics and more. The developers can take advantage of using this robust API in their application and know that the application is portable across all the conformant hardware.

In this project, we will go over how to build and install open-source OpenVX 1.3 library on Raspberry Pi 4 Model B Rev 1.2. We will run the conformance for the Vision, Enhanced Vision, & Neural Net conformance profiles and create a simple computer vision application to get started with OpenVX on Raspberry Pi.

OpenVX 1.3 Implementation for Raspberry Pi

The OpenVX 1.3 implementation is available on GitHub. To build and install the library follow the instructions below.

Build OpenVX 1.3 on Raspberry Pi

  • Git Clone project with the recursive flag to get submodules.
git clone --recursive https://github.com/KhronosGroup/OpenVX-sample-impl.git

Note: The API Documents and Conformance Test Suite are set as submodules in the sample implementation project

  • Use Build.py script to build and install OpenVX 1.3
cd OpenVX-sample-impl/
python Build.py --os=Linux --venum --conf=Debug --conf_vision --enh_vision --conf_nn
  • Build and run the conformance
export OPENVX_DIR=$(pwd)/install/Linux/x32/Debug
export VX_TEST_DATA_PATH=$(pwd)/cts/test_data/
mkdir build-cts
cd build-cts
cmake -DOPENVX_INCLUDES=$OPENVX_DIR/include -DOPENVX_LIBRARIES=$OPENVX_DIR/bin/libopenvx.so\;$OPENVX_DIR/bin/libvxu.so\;pthread\;dl\;m\;rt -DOPENVX_CONFORMANCE_VISION=ON -DOPENVX_USE_ENHANCED_VISION=ON -DOPENVX_CONFORMANCE_NEURAL_NETWORKS=ON ../cts/
cmake --build .
LD_LIBRARY_PATH=./lib ./bin/vx_test_conformance

Sample Application

Use the open-source samples on GitHub to test the installation.

Acknowledgement

  • Raspberry Pi is a trademark of the Raspberry Pi Foundation
  • Images used in this document are used for educational purpose
  • OpenVX is a trademark of the Khronos Group