GStreamer Based Image Signal Processor - User Guide - Installation

Introduction

The following guide pretends to ease the installation process of all the dependencies necessary to execute Ridgerun's GStreamer Based Image Signal Processor plugin.

OpenCL

Desktop

Intel OpenCL Support Ubuntu

1. Install lsb-core OpenCL prerequisite

sudo apt-get install -y lsb-core

2. Download the required OpenCL Runtime for Intel Core according to your platform

Intel Runtime download Site

For example for Ubuntu 18.04/20.04 the following commands can be used (obtained from latest release):

mkdir tmp-opencl && cd tmp-opencl

wget https://github.com/intel/compute-runtime/releases/download/20.42.18209/intel-gmmlib_20.3.2_amd64.deb
wget https://github.com/intel/intel-graphics-compiler/releases/download/igc-1.0.5186/intel-igc-core_1.0.5186_amd64.deb
wget https://github.com/intel/intel-graphics-compiler/releases/download/igc-1.0.5186/intel-igc-opencl_1.0.5186_amd64.deb
wget https://github.com/intel/compute-runtime/releases/download/20.42.18209/intel-opencl_20.42.18209_amd64.deb
wget https://github.com/intel/compute-runtime/releases/download/20.42.18209/intel-ocloc_20.42.18209_amd64.deb
wget https://github.com/intel/compute-runtime/releases/download/20.42.18209/intel-level-zero-gpu_1.0.18209_amd64.deb

3. Install all the required packages

sudo dpkg -i *.deb

4. Install headers

sudo apt install opencl-headers

Intel OpenCL Support Ubuntu 22.04

As alternative you can follow the next steps for installing OpenCL for intel in ubuntu 22.04

1. Get the Intel GPU key & repo for Jammy

wget -qO - https://repositories.intel.com/gpu/intel-graphics.key | \
  sudo gpg --yes --dearmor --output /usr/share/keyrings/intel-graphics.gpg

echo "deb [arch=amd64,i386 signed-by=/usr/share/keyrings/intel-graphics.gpg] \
https://repositories.intel.com/gpu/ubuntu jammy unified" | \
  sudo tee /etc/apt/sources.list.d/intel-gpu-jammy.list

2. Install OpenCL for Intel GPU

sudo apt update
sudo apt-get install -y \
  libze-intel-gpu1 libze1 \
  intel-opencl-icd clinfo

3. Make sure you can open the render node

groups | grep -qw render || sudo usermod -aG render "$USER"

4. Verify the installation with clinfo

sudo clinfo

The expected output would be similar to the following.

  Number of platforms                               1
  Platform Name                                   Intel(R) OpenCL Graphics
  Platform Vendor                                 Intel(R) Corporation
  Platform Version                                OpenCL 3.0

i.MX based

When building the system for i.MX platforms the MetaRidgerun layer contains the required recipes for gst-isp and gst-opencl which will install all the required dependencies.

Qualcomm RB5/RB6

The Linux Ubuntu (LU) image is already equipped with OpenCL. You don't need additional steps and you can compile on host.

GStreamer Plugin

RidgeRun will provide the sources required to build the project.

To compile and install for Desktop run the following commands:

Gst-opencl

cd gst-opencl
./autogen.sh --libdir=/usr/lib/$(uname -m)-linux-gnu
./configure --libdir=/usr/lib/$(uname -m)-linux-gnu
make
sudo make install

Gst-isp

cd gst-isp
./autogen.sh --libdir=/usr/lib/$(uname -m)-linux-gnu
make
sudo make install

Previous: User Guide

Index

Next: Getting Started

❯