GenICam GenTL Hardware

Device Discovery

If you are having trouble using the Image Acquisition Toolbox™ with a GenICam™ GenTL camera driver using the toolbox's gentl adaptor, try the following:

  1. Install the Image Acquisition Toolbox Support Package for GenICam Interface.

    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 the gentl adaptor loads. You can use the imaqhwinfo command to list installed adaptors. The gentl adaptor should be included on the list.

    If it does not load, make sure that GenICam is configured correctly using the imaqsupport function.

    For information on installing GenICam, see Software Configuration.

  3. Install the manufacturer-provided GenTL producer.

  4. Make sure your environment variables are set. For example, depending on the GenTL producers you have installed, on a 64-bit Windows® system, it could be something like:

    GENICAM_GENTL64_PATH=C:\Program Files\LeutronVision\Simplon\bin\cti;C:\Program 
        Files\MATRIX VISION\mvIMPACT acquire\bin;C:\XIMEA\GenTL Producer\x86
    
  5. Each directory that you list in the environment variables must contain a DLL file that has a .cti extension and that exports the standard C functions that are expected for a GenTL producer. The Image Acquisition Toolbox gentl adaptor scans these directories for all the CTI files and then checks whether they export the correct minimum set of functions.

  6. Test the connectivity of your device separately from using the Image Acquisition Toolbox. Use the vendor program included with your device to see if you can detect and acquire images from the camera.

  7. If you are using the GenICam GenTL adaptor with a GigE Vision camera, it may be that the producers for GigE Vision cameras do not send a ForceIP command. So sometimes, after plugging in a new camera, it is not found. Using the toolbox’s gige adaptor first can resolve this.

  8. You can also look at producers in other vendor software.

    For example, Leutron Vision uses a program called Simplon Explorer. Using this program, you can see what producers are installed and what cameras are connected. You can double-click on a camera within the Simplon Explorer to control it. For AVT cameras, use the Vimba Viewer.

    Note that with Matrix Vision, if a device is configured for DirectShow, it is not available to GenTL.

  9. Run the imaqsupport function for further troubleshooting information.