Main Content

Linux Video Hardware

Device Discovery for Linux Video Devices

If you have trouble using the Image Acquisition Toolbox™ with a supported Linux® Video acquisition device, try the following:

  1. Install the Image Acquisition Toolbox OS Generic Video Interface Support Package. It includes the necessary files to use the linuxvideo adaptor.

    Starting with version R2014a, each adaptor is available separately through MATLAB® Add-Ons. See Image Acquisition Support Packages for Hardware Adaptors for information about installing the adaptors.

  2. Verify that you have a supported GStreamer version on the Third-Party Requirements section on the MathWorks® website (

    To find the version of GStreamer drivers installed on your system, run this command:

    dpkg -l libgst* | grep ^i

    If you had the GStreamer 1.0 libraries, it would return results similar to the following examples.

    GStreamer development files for libraries from the "bad" set:

    ii libgstreamer-plugins-bad1.0-0:amd64 1.4.4-2.1+b1 amd64

    GStreamer libraries from the "base" set:

    ii libgstreamer-plugins-base1.0-0:amd64 1.4.4-2 amd64

    GStreamer development files for libraries from the "base" set :

    ii libgstreamer-plugins-base1.0-dev 1.4.4-2 amd64

    Core GStreamer libraries and elements:

    ii libgstreamer1.0-0:amd64 1.4.4-2 amd64

    Core GStreamer libraries and elements:

    ii libgstreamer1.0-0-dbg:amd64 1.4.4-2 amd64

    Core GStreamer development files:

    ii libgstreamer1.0-dev 1.4.4-2 amd64
  3. Verify that your camera can be detected and images can be acquired by running applications such as Cheese or guvcview. If you can start the utility, run the utility, and close it without encountering any errors, the toolbox should be able to operate with your image acquisition device. If you encounter errors, resolve them before attempting to use the toolbox with the device.

  4. If the camera has a USB interface, make sure lsusb on a Linux terminal can detect your camera.

  5. For releases R2017a and later, MathWorks supports the GStreamer 1.0 drivers.


The Linux Video driver is a generic interface, and you should only use it if you do not have a more specific driver to use with your device. If your device is an IEEE® 1394 IIDC compliant device, use the DCAM (dcam) adaptor. If your device is GigE Vision® compliant, use the GigE (gige) adaptor. If your device manufacturer provides a GenTL producer, use the GenTL (gentl) adaptor. Use the Linux Video driver only if there is no more specific option for your device.