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:
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.
Verify that you have a supported GStreamer version on the Third-Party Requirements section on the MathWorks® website (
www.mathworks.com/hardware-support/gstreamer.html
).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
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.
If the camera has a USB interface, make sure
lsusb
on a Linux terminal can detect your camera.For releases R2017a and later, MathWorks supports the GStreamer 1.0 drivers.
Note
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.