Using the GenTL Interface#
- Configure GenICam compatible cameras of diverse standards via the same (GenApi) interface. Supported standards are Camera Link, and CoaXPress.
- View the hierarchical structure of an image acquisition system.
- Develop generic applications (GenTL consumers) without considering the used camera standard.
The implemented GenTL producer provides GenTL 1.5.
The Basler Framegrabber SDK contains two GenTL Producers ProducerCXP.cti (for CXP frame grabbers) and ProducerCL.cti (for Camera Link frame grabbers).
The GenTL Producer saves configuration files for each discovered frame grabber into the following directory:
- Under Windows: %Appdata%\basler
- Under Linux: ~/.config/basler
If you delete the *.config files, the GenTL Producer is reset to a default configuration.
The interface module XML contains information about the applets in the category node
InterfaceApplets. In the node
InterfaceApplet you can select a different applet or .hap file than the currently loaded applet. An applet change is saved in the persistent GenTL configuration file, but it will only be effective after closing all the devices and updating the device list or after closing and reopening the interface. After you have selected an applet and updated the devices, you need to wait some seconds, then you can confirm with the parameter
InterfaceAppletStatus whether the applet was loaded.
When is an applet available?
- On imaWorx frame grabbers, an applet is available as soon as it is available in the file system of your computer (Framegrabber SDK installation directory, sub-directories DLL or Hardware Applets). If the applet isn't there, run the applet installer that contains the applet you want to use, or, if you need an applet created with VisualApplets, copy the applet file (*.hap) into the Hardware Applets folder of your Framegrabber SDK installation (e.g.,
- On marathon frame grabbers, an applet is available as soon as it is flashed onto the frame grabber. If the applet you want to use isn't flashed on the frame grabber yet, flash it according to the instructions in Flashing Applets onto marathon Frame Grabbers.
For details on how to manage applets in microDiagnostics, see Managing Applets (microDiagnostics).
UserSetControl category in the interface module, you can load and save the configuration file for the currently selected applet. To do this, write a path to an existing or non-existing *.mcf file into the
UserSetFile parameter and execute the
UserSetSave commands. If you leave the path empty or use a different file extension than *.mcf, the commands
UserSetSave are not available.
The *.mcf configuration files save the configuration of the applet, while the *.config files save the configure of the GenTL Producer. The configuration loaded from an *.mcf file isn't persisted after an applet change or a system close. If the currently loaded applet doesn't match the applet in the loaded *.mcf file, the GenTL Producer first tries to set the
InterfaceApplet to the one in the configuration file. In this case, you must close the devices and update the device list (without closing the system) for the configuration to be effective.
In the interface module under the category
TransportLayerControl, you find the
DiscoveryMethod enumeration node. This node contains the values
CameraDiscovery is the default value for CXP frame grabbers, and
EmulationDiscovery is the default value for Camera Link frame grabbers. The emulated devices are specifically important for Camera Link frame grabbers and for working with **.hap files.
If you select
EmulationDiscovery, then emulation devices are detected automatically and a minimal remote device XML is generated. If the applet contains an image generator, the image generator is activated by default. You can deactivate the image generator inside the remote device nodes, to receive images from a camera link camera. There are always as many emulation devices as acquisition channels for the applet.
MixedDiscovery discovers real cameras, but fills the empty acquisition channels with emulated devices. Use this value for .hap files of CXP frame grabbers.
Automatic ROI and FORMAT#
Under the Device
ImageFormatControl category, you find the nodes
AutomaticROIControl are active, the GenTL Producer tries to set the correct format and ROI in the applet to match the one in the camera. This is relevant for applets of the microEnable 6 frame gabbers.