Device Discovery - Third Party GenTL Producer

<< Device Discovery

Discovering devices using Third Party GenTL Producers can be done using the Cvb::DeviceFactory::Discover.

Depending on the implementation and configuration of the third party GenTL producer, what it reports to the CVB SDK can vary. In some cases, it may appear in a similar manner to the CVB USBTL and GEVTL producers and may even show the same devices as shown by the CVB producers (e.g. if a device uses the Gig-E Vision (GEV) standard, it may be detected by both the CVB GEVTL and a third party producer that also supports GEV).

In the case that multiple devices are connected, or a device can be used via multiple GenTL producers, after discovery, the Cvb::DiscoveryProperties in the Cvb::DiscoveryInformation should be accessed to determine the transport layer used and filter appropriately.

#include <cvb/device_factory.hpp>
 
auto discoveredDevices = Cvb::DeviceFactory::Discover(Cvb::DiscoverFlags::IgnoreVins); // (1)
 
auto chosenDiscoveryInformation = std::find_if(discoveredDevices.begin(), discoveredDevices.end(),
  [](auto discoveryInformation) {
    return discoveryInformation[Cvb::DiscoveryProperties::DeviceTransportLayerType] == "Custom";  // (2)
  });
 
auto device = Cvb::DeviceFactory::Open<Cvb::GenICamDevice>(chosenDiscoveryInformation->AccessToken(), Cvb::AcquisitionStack::PreferGenTL); // (3)
 
// Configure device
 
// Start acquisition and streaming

using Stemmer.Cvb;
using Stemmer.Cvb.Driver;
 
using (var discoveredDevices = DeviceFactory.Discover(DiscoverFlags.IgnoreVins)) // (1)
{
  var chosenDiscoveryInformation = discoveredDevices.First(discoveryInformation => {
    return discoveryInformation[DiscoveryProperties.DeviceTransportLayerType] == "Custom"; // (2)
  });
 
  using (var device = (GenICamDevice)DeviceFactory.Open(chosenDiscoveryInformation, AcquisitionStack.PreferGenTL)) // (3)
  {
 
    // Configure device
 
    // Start acquisition and streaming
 
  }
}

import cvb
 
discoveredDevices = cvb.DeviceFactory.discover_from_root(cvb.DiscoverFlags.IgnoreVins) # (1)
 
chosenDiscoveryInformation = next(filter(lambda discoveryInformation: discoveryInformation.read_property(cvb.DiscoveryProperties.DeviceTransportLayerType) == "Custom", discoveredDevices)) # (2)
 
with cvb.DeviceFactory.open(chosenDiscoveryInformation.access_token, cvb.AcquisitionStack.PreferGenTL) as device: # (3)
 
    # Configure device
 
    # Start acquisition and streaming

Note: Error handling has been omitted from the above example.

1. Discover all GenTL devices. By default all devices are discovered so by using the Cvb::DiscoverFlags::IgnoreVins flag, the legacy VIN drivers are excluded.

2. Filter the found discovery information to use the first that uses the custom GenTL producer.

   Common options are:

   • Mixed - Several supported technologies
   • Custom - Custom technologies
   • GEV - GigE Vision technology
   • CL - Camera Link technology
   • IIDC - IIDC 1394 technology
   • UVC - USB video class devices
   • CXP - CoaXPress
   • CLHS - Camera Link HS
   • USB3 - USB3 Vision Standard
   • Ethernet - Ethernet devices
   • PCI - PCI/PCIe devices
3. Open the device as a Cvb::GenICamDevice using Cvb::AcquisitionStack::PreferGenTL. When using GenTL, these flags are mandatory to ensure that all GenICam features are enabled.