GStreamer Based Image Signal Processor - Troubleshoot

GStreamer Image Signal Processor
Image Signal Processor Basics
Docs
User Guide Installation
Getting Started
Evaluating GStreamer Image Signal Processor Getting the code Building GStreamer Image Signal Processor
Examples
IMX8 Pipelines x86 Pipelines
Performance
i.MX6 i.MX8
Troubleshoot
Contact Us

Black output image

If when trying to use the plugins you are getting a black output image like the following:

It may be due to two possible reasons:

1. Incompatible version with OpenCL runtime libraries

Please refer to our installation guide.

2. Mismatch in device/platform configuration for plugin

Usually, this is the most common problem and it is related to the device the plugin is using to compute the output result. Please use the following command to inspect the element and the available devices and platforms available on your system.

gst-inspect-1.0 ispcldebayer

Please notice the device and platform elements in the command output and make sure you are using the output device that has the correct OpenCL runtime. For example, if the GPU device 0 is used (selected by default) the exact same result as a black output image is obtained because the runtime installed is for the Intel platform.

.
.
.
Element Properties:
  device              : OpenCL device
                        flags: readable, writable
                        Enum "GstOclDevicesEnum" Default: 0, "NVIDIA Corporation GPU"
                           (0): NVIDIA Corporation GPU - GeForce GTX 1050 Ti
                           (1): Intel(R) Corporation GPU - Intel(R) Graphics Gen9 [0x3e9b]
  name                : The name of the object
                        flags: readable, writable
                        String. Default: "ispcldebayer0"
  parent              : The parent of the object
                        flags: readable, writable
                        Object of type "GstObject"
  platform            : OpenCL platform
                        flags: readable, writable
                        Enum "GstOclPlatformsEnum" Default: 0, "NVIDIA CUDA"
                           (0): NVIDIA CUDA      - NVIDIA CUDA OpenCL 1.2 CUDA 11.1.70
                           (1): Intel(R) OpenCL HD Graphics - Intel(R) OpenCL HD Graphics OpenCL 3.0 
  qos                 : Handle Quality-of-Service events
                        flags: readable, writable
                        Boolean. Default: true

Add the properties in the pipeline to select the required device and platform. For example:

gst-launch-1.0 videotestsrc is-live=true ! "video/x-bayer, format=(string)bggr, width=$WIDTH, height=$HEIGHT,framerate=(fraction)30/1" ! queue ! ispcldebayer device=1 platform=1 ! videoconvert ! fpsdisplaysink