Added/Improved Features

Added and improved features in eGrabber 15.0

eGrabber

eGrabber Gigelink GenTL producer

Added eGrabber Gigelink GenTL producer.

eGrabber Gigelink is an optional library of eGrabber that provides a universal, hardware-independent access to GigE Vision cameras. With Gigelink, programmers can use the EGrabber concepts, objects, and function calls to acquire images from GigE Vision cameras, in the same way as with CoaXPress cameras and the Coaxlink cards. Gigelink is compatible with GenICam as well as the GenICam browser and the eGrabber Studio applications.

eGrabber Gigelink is only available for Windows x86_64.

See also: Gigelink and Programmer's Guide
eGrabber Recorder library 1.0.0

Added eGrabber Recorder library version 1.0.0.

eGrabber Recorder is an optional library of eGrabber that provides video recording services to hard drives. It is compatible with hard disk drives (HDD) as well as solid state drives (SSD). The eGrabber Recorder library is easy to use and relieves the user of having to care about file size, name, or format. Recorder focuses on performance; the library has been highly optimized to exploit the maximum bandwidth of disks. The actual recording throughput will of course depend on the disk capabilities.

eGrabber Recorder is only available for Windows x86_64.

See also: Recorder

Added sample programs:

□ 260-egrabber-recorder
□ 261-recorder-parameters
□ 360-recorder-async-write
□ 361-recorder-async-write-mt

See also: Sample programs

eGrabber Studio 1.2

Updated eGrabber Studio to version 1.2

See also: Starting with eGrabber Studio and Working with eGrabber Studio
Python bindings

Added events to python bindings.
Added new sample200 eGrabber Python sample programs
Added Coaxlink() and Gigelink() helper functions

Coaxlink

Pulse distribution on multiple output lines

Added a function to distribute pulses on multiple output lines.

The LineSourceInitialOffset Interface module GenApi feature defines the offset of the first pulse to drive the selected output line. The LineSourceDivisionFactor Interface module GenApi features defines the interval between each pulse sent on the selected output line. This factor should be equal to the number of output lines over which pulses are distributed.

This function can be used to distribute strobe pulses over multiple output lines.

See also: LineSourceDivisionFactor and LineSourceInitialOffset Interface module GenApi features.
PoCxp status

When CxpPoCxpHostConnectionSelector is set to All, the CxpPoCxpCurrent Interface module GenApi feature reports the sum of currents delivered via PoCXP and the CxpPoCxpVoltage Interface module GenApi feature reports the average voltage delivered via PoCXP.

The total output power delivered by PoCXP is the product of CxpPoCxpCurrent[All] and CxpPoCxpVoltage[All] values.

See also: CxpPoCxpCurrent and CxpPoCxpVoltage Interface module GenApi features.

GenApi

MathParserMode

Added MathParserMode option to configuration file (coaxlink.ini, gigelink.ini) to change GenApi SwissKnife parser behavior.

The default mode (auto) should work in most cases; in case of parsing failure, the parsing mode can be changed to standard, which is a permissive mode that operates like the GenICam reference implementation; the auto mode uses the stricter parsing mode (strict) for Coaxlink and the more permissive mode (standard) for Gigelink.
gentl: added --math-parser-mode flag
genicam-browser: added parser mode option in preferences.

Installers

Linux installer

Linux installer now uninstalls the previous installation before proceeding.

eGrabber

High-frame rate area-scan acquisition
Added BufferPartCount feature to data stream module; this allows packing several images into one buffer

Added related commands to BUFFER_INFO_CUSTOM_CMD_LIST:

□ BUFFER_INFO_CUSTOM_PART_SIZE
□ BUFFER_INFO_CUSTOM_NUM_PARTS
□ BUFFER_INFO_CUSTOM_NUM_DELIVERED_PARTS
□ BUFFER_INFO_CUSTOM_PART_TIMESTAMPS
Added 310-high-frame-rate to eGrabber sample programs
Added 311-high-frame-rate to eGrabber sample programs

Added 312-part-timestamps to eGrabber sample programs
BUFFER_INFO_DATA_SIZE

Added BUFFER_INFO_DATA_SIZE - Size of the data intended to be written to the buffer last time it has been filled

□ This value is reset to 0 when the buffer is placed into the Input Buffer Pool.
□ If the buffer is incomplete the number still reports the full size of the original data including the lost parts.
□ If the buffer is complete and the payload contains no gaps, the number equals to the size reported through BUFFER_INFO_SIZE_FILLED.
□ Note that gaps in payload are possible with certain payload types, such as GenDC or multi-part.
□ Data type: SIZET
Python bindings for eGrabber
Improved support of Python 2: unicode and long types.

Added sample310 to eGrabber Python sample programs

Added live to eGrabber Python sample programs

Automatic Byte Alignment

CxpPortAlignment : Added new default value 0 for automatic mode: 4-byte alignment for bootstrap registers and no alignment constraints for accesses in the manufacturer-specific space.

GenICam Browser

Dark mode on Linux

Added support of dark mode on Linux.

Software Tools

eGrabber Studio

Added eGrabber Studio Graphical User Interface tool to the eGrabber package.

Release 1.0 of the eGrabber Studio provides the following features:

● Test the image acquisition with Coaxlink cards.
● Check and configure the GenApi featuresOptional library of eGrabber that provides video recording services to hard drives of your camera and your frame grabber.
● Save the buffered images into a file after acquisition.

eGrabber Studio is included in the eGrabber package and is consequently automatically installed with the frame grabber driver.

Currently, eGrabber Studio is only available for x86_64 processor architecture!

See also: Starting with eGrabber Studio and Working with eGrabber Studio documentation

eGrabber

Python bindings

Added Python bindings for eGrabber

The Python bindings for eGrabber are provided in a Python wheel installation package (a .whl file) located in the python subdirectory of the eGrabber installation directory1. Depending on your Python setup, installation can be as easy as:

            python -m pip install <PATH_TO_EGRABBER_WHL>

See also: Python in the Programmer's Guide

Added Python sample programs

Sample Description
live-capture-opencv Acquire and convert frames to RGB8 to produce an avi file with opencv and numpy
live-numpy-opencv Create numpy arrays from acquired Mono8 data, transpose arrays and use opencv to show images
live-tkinter-pillow Simple tkinter application showing acquired data processed by a Pillow contour filter
live Image acquisition and display
sample100 Simple Grab N frames using ScopedBuffer class
sample120 Python version of the C++ 120-converter eGrabber sample program
sample130 Simple Grab N frames with manual buffer management
sample140 Queries on GenApi commands
sample200 Grab N frames and get DataStream events with callbacks
sample210 Show available grabbers
sample310 Grab in high frame rate mode for 10 seconds

See also: Sample programs in the Programmer's Guide
Improved data stream stop

The Camera and Illumination Controller is now reset when the data stream has been stopped

This makes AbortSequence unnecessary

Pixel processing

New Bayer to RGB conversion method

Added Method3Bayer CFA Decoding method.

The new method is based on 5 x 5 gradient-based interpolation filter. It significantly reduces the artifacts encountered by the Legacy (Method1) and the Advanced (Method2) methods.

The Method3 is available only on 3602 Coaxlink Octo (1-camera) and 3622 Coaxlink Duo CXP-12 (1-camera) firmware variants.

The Bayer CFA decoder of 3602 Coaxlink Octo (1-camera) decodes lines up to 16,384 pixels at a peak processing rate of 2 billion pixels/s using any of the following decoding methods: Legacy (Method1), Advanced (Method2) and Method3.

The Bayer CFA decoder of 3622 Coaxlink Duo CXP-12 (1-camera) decodes lines up to 8,192 pixels at a peak processing rate of 2 billion pixels/sec using only Method3.

Added Method3 value to data stream feature BayerMethod.

Added IMAGE_CONVERT_OUTPUT_CONFIG_BAYER_METHOD_3 to IMAGE_CONVERT_OUTPUT_CONFIG (see include/EuresysImage.h).

genicam-browser: added Method3 to the Bayer decoding methods in the Image tab of the Preferences window

EGrabber

Added data stream features BufferAllocationAlignmentControl and BufferAllocationAlignment to control the alignment (address and size) of buffers allocated by DSAllocAndAnnounceBuffer.
Added userPointer to GenTLMemory (for announceAndQueue)
Expose tags for integer and float nodes as properties

GenApi: Exposed Unit and Representation tags of integer and float nodes as properties; exposed DisplayPrecision and DisplayNotation tags of float nodes as properties.

GenICam Browser

Enable Bayer decoding option

Added option "Enable Bayer decoding" to the Image tab of the Preferences window.
If disabled, bayer buffers are processed as if they were mono buffers.

Utilities

ImageConvert

Added conversion functions from RGB8 and BGR8 to RGB8_Planar.
gentl ber
Improved handling of broken frames

CoaXPress host interface

Improved CoaXPress device discovery for cameras that are running at CXP-10 or CXP-12

Added CXP-10 to the list of discovery rates for Coaxlink cards that support CXP-10 or higher rates:

□ at CXP-10 or above, the low-speed up-connection is 41.666 Mbps (instead of 20.833 Mbps)
□ adding CXP-10 to the list of discovery rates allows remote devices configured at CXP-10 or above to receive ConnectionReset commands during device discovery
Line-scan acquisition

Improved the internal memory throughput of all line-scan firmware variants of 3602 Coaxlink Octo and 3603 Coaxlink Quad CXP-12.

When operating with Mono8 pixels, the frame grabber is now capable of sustaining continuous image data acquisition from line-scan cameras delivering data at the maximum CoaXPress link data rate.

CoaXPress host interface

CoaXPress 2.0 error counters

Added a set of counters to keep track of errors that the CoaXPress protocol can detect on each individual CoaXPress connection. Namely:

□ Connection lock loss
□ 8b/10b encoding error
□ Duplicated characters mismatch that could be corrected
□ Duplicated characters mismatch that could NOT be corrected
□ CRC error in data packets
□ CRC error in control packets
□ CRC error in event packets

Added new CoaXPressErrorCounters parameters category and new parameters to GenICam Interface module:

CxpLinkLockLossCount and CxpLinkLockLossCountReset
Cxp8b10bErrorCount and Cxp8b10bErrorCountReset
CxpDuplicatedCharactersUncorrectedErrorCount and CxpDuplicatedCharactersUncorrectedErrorCountReset
CxpDuplicatedCharactersCorrectedErrorCount and CxpDuplicatedCharactersCorrectedErrorCountReset
CxpStreamDataPacketCrcErrorCount and CxpStreamDataPacketCrcErrorCountReset
CxpControlPacketCrcErrorCount and CxpControlPacketCrcErrorCountReset
CxpEventPacketCrcErrorCount and CxpEventPacketCrcErrorCountReset

See also: CoaXPress 2.0 Error Counters topic in the Coaxlink Functional Guide.
Discovery

Show IDs of discovered/missing extensions in memento traces at the end of the discovery procedure.

gentl.exe

PCI Express performance evaluation tool

Added dtr command to measure the data transfer rate from the Coaxlink on-board frame store to system memory.

See also: Data Transfer Rate Test Program topic in the Coaxlink Functional Guide.

EGrabber

Sorting the interface list by PCI position

Added an option to sort the interface list by PCI position.

The new ordering is enabled in the coaxlink.ini configuration file next to coaxlink.cti with:

[System]
InterfaceOrder=PciPosition
Improved error reporting for broken frame images

When huge images (e.g., 24000x12000) are acquired and the internal frame store overflows, a new Memento message is now emitted, and the data stream module fires a BrokenFrame event.

GenICam

Bracket LED lamps control

Added the LampMode feature in the interface module to control the bracket LED lamps behavior; the supported values are:

Standard: CoaXPress Standard bracket lamps behavior (default)

Dark: all bracket lamps are turned off

Error: all bracket lamps are turned off unless error conditions are detected

Custom: bracket lamps are controlled either by the LampCustomValue (bitfield) feature or by the LampCustomLedA … LampCustomLedH boolean features
CoaXPress PoCXP detection mode selector

Added CxpPoCxpDetectionMode feature to interface module; this selects either the standard or the extended (default) power over CoaXPress detection mode.
PCI card identification

Added PCIBus, PCIDevice and PCIFunction features to interface module.

Driver Installation

Improved Linux installation scripts
□ Warn when kernel build tools are either missing or built for an inadequate architecture
□ Warn when allow_unsupported_modules 0 is defined (SUSE Linux)
□ Enable PCI_ALLOC_CONSISTENT_TEGRA_WORKAROUND on NVIDIA Tegra releases R31 and higher;
□ Environment variable USE_PCI_ALLOC_CONSISTENT_TEGRA_WORKAROUND=0|1 can be used to disable|force the PCI_ALLOC_CONSISTENT_TEGRA_WORKAROUND

GenICam Browser

GenICam Browser doesn't access CoaXPress 2.0 bootstrap registers that are not implemented by the camera.
C2C-Link for line-scan cameras

Added support of C2C-Link for line-scan firmware variants.

Added C2C-Link Synchronization tool to I/O toolbox and related features to interface module:

● C2CLinkSynchronizationToolSelector: selects a C2C-Link Synchronization Tool:
□ C2C1: C2C-Link Synchronization Tool 1.
□ C2C2: C2C-Link Synchronization Tool 2.
□ C2C3: C2C-Link Synchronization Tool 3.
● C2CLinkSynchronizationToolSource: I/O Toolbox event stream used as input for the selected C2C-Link Synchronization Tool.
□ Possible values for C2C-Link Synchronization Tool 1: CycleTrigger.
□ Possible values for C2C-Link Synchronization Tools 2 and 3: Any I/O Toolbox event stream.
● C2CLinkSynchronizationToolClock: Event used as clock for the selected C2C-Link Synchronization Tool:
□ Immediate: Event is forwarded on the selected C2C-Link Synchronization Tool immediately.
□ CycleTrigger: Event is forwarded on the selected C2C-Link Synchronization Tool upon the following C2C-Link cycle trigger event.
□ StartOfCameraReadout: Event is forwarded on the selected C2C-Link Synchronization Tool upon the following start of camera readout event.
● C2CLinkSynchronizationToolDiscardPendingEvent: Discard an event that has been received but that has not been forwarded yet on the selected C2C-Link Synchronization Tool. This can be useful when C2CLinkSynchronizationToolClock is not set to Immediate.
New values C2C1, C2C2, C2C3 for DelayToolSource1, DelayToolSource2, DividerToolSource, MultiplierDividerToolSource and EventSelector parameters of the interface module.
New values C2C1EventCount, C2C2EventCount, C2C3EventCountfor EventNotificationContext1, EventNotificationContext2 and EventNotificationContext3 parameters of the interface module.

New values C2C1, C2C2, C2C3 for CycleTriggerSource, StartOfSequenceTriggerSource and EndOfSequenceTriggerSource of the device module.
New values C2C1EventCount, C2C2EventCount, C2C3EventCountfor EventNotificationContext1, EventNotificationContext2 and EventNotificationContext3 parameters of the device module.

New values C2C1, C2C2, C2C3 for StartOfScanTriggerSource and EndOfScanTriggerSource of the data stream module.
New values C2C1EventCount, C2C2EventCount, C2C3EventCountfor EventNotificationContext1, EventNotificationContext2 and EventNotificationContext3 parameters of the data stream module.
Timeout on camera readout

Added TriggerToCameraReadoutTimeout and CameraReadoutTimeout features to data stream module, along with related events and counters.

New values for EventSelector parameter of the datastream module:

□ TriggerToCameraReadoutTimeout: Trigger to camera readout timeout.
□ CameraReadoutTimeout: Camera readout timeout.
CoaXPress Device to Host LinkTrigger events

Added notifications of LinkTrigger events sent by CoaXPress devices (cf. EVENT_CUSTOM_CXP_DEVICE, EVENT_DATA_NUMID_CXP_DEVICE_LINK_TRIGGER and EVENT_SPECIFIC_CXP_DEVICE_LINK_TRIGGER in GenTL_v1_5_EuresysCustom.h)
Added EGrabber callback onCxpDeviceEvent (related to EVENT_CUSTOM_CXP_DEVICE) with a new Event DATA type CxpDeviceData.

Added LinkTriggerEventCount value to EventNotificationContext[123] parameters of device and datastream modules.

Added LinkTrigger value to EventSelector parameter of device module.

GenApi

The GenApi module exposes its internal errors from its low level C interface and from both higher level C++ and .NET interfaces

● added GenapiGetLastError to the header include/EuresysGenapi.h,
● added genapi_error exception (deriving from gentl_error) to the header include/EGenTLErrors.h, with getters for retrieving the specific GenApi error code as well as specific error parameters (such as a GenApi node name and/or a value relevant to the particular error),
● added an optional header file include/EuresysGenapiErrorFormats.h that provides a sample function GenapiErrorDescription, which creates an error description (string) from a genapi_error exception; please note that the sample function is only available when EURESYS_GENAPI_ERROR_DESCRIPTION is defined.

Added Euresys::query::xml() to EGenTL header file.

EGrabber

Improved EGrabber::start: try and recover when executing the remote device command AcquisitionStart fails; in such a condition, the command AcquisitionStop is executed prior to executing AcquisitionStart again.

CoaXPress

CoaXPress 2.0 communication with tags

Added advanced CoaXPress control parameters related to CoaXPress revision 2.0:

● CxpControlParameter[CxpVersion20Supported]: to enable/disable the CoaXPress revision 2.0 support in Coaxlink,
● CxpControlParameter[EnableCommunicationWithTag]: to enable/disable the control packets with tag,
● CxpControlParameter[ForceCommunicationWithTag]: to force and use immediately control packets with tag even though CoaXPress revision 2.0 has not been negotiated with the remote device.

To use communication with tag automatically with CoaXPress 2.0 cameras, the parameter CxpControlParameter[CxpVersion20Supported] must be explicitly set to 1
CoaXPress discovery

DeviceConnectionID register values that do not make sense are detected and rejected (values are required to be smaller than 16).
12.1.1: allow cameras reporting a CoaXPress revision 1.1 (and above) to change the connection configuration without first acknowledging the ConnectionConfig write as specified; this allows cameras reporting a revision 1.1 but behaving as described in standard revision 1.0 to be properly discovered.

GenApi

Remote device module registers cache

Enabled cache for registers in remote device modules (the cache has been enabled for the other modules since Coaxlink 6.0).

Should there be any issue with the cache, it can be disabled by setting the virtual feature @portCache to False
pError attribute

Added support for pError attributes.

I/O lines

High value for output lines

Added new LineSource value High.

Sample programs

CUDA sample programs

Added Visual Studio 2010 project and solution files for CUDA 10.0

Linux driver

Dynamic Kernel Module Support

Added Dynamic Kernel Module Support (DKMS) to the Coaxlink Linux driver package.

DKMS automatically re-compiles Coaxlink software modules when a new kernel version is installed. This avoids the need for the re-installation of the Coaxlink driver.

Sample programs

Microsoft Visual Studio 2010

Upgraded windows samples solutions to Visual Studio 2010.

Documentation

Coaxlink programmer's guide
Added a list of available sample programs in the Coaxlink programmer's guide.

Sample programs

ffc-wizard: added line-scan mode to the sample application and improved documentation with screenshots.

CoaXPress Discovery

Official support of CoaXPress 1.1.1

Adapted CoaXPress discovery to change the number of extensions and the CoaXPress rate as two separate steps (previously both changes were done simultaneously).

As stated in CoaXPress 1.1.1 standard, the number of extensions is first changed to discover the extensions then when the discovery procedure is about to complete, the rate is changed according to the register ConnectionConfigDefault.

Preliminary support of CoaXPress 2.0

Adapted CoaXPress discovery to only read ConnectionReset, DeviceConnectionID and MasterHostConnectionID bootstrap registers on extension connections (as stated in CoaXPress 2.0 standard).

the Coaxlink Quad G3 Sublink variants also need to read the ConnectionConfig register on extension connections in order to configure the packet tag handling

1637 Coaxlink Quad 3D-LLE

Dual laser-line extraction

Added support for the extraction of a second laser-line.

When the new data stream feature Scan3dSecondLineROIOffsetY is different from 0 and an extraction method is enabled, two laser-lines are extracted; one for the upper part of the acquired image and another one for the lower part of the acquired image. The split between the upper and lower parts is determined by the value of Scan3dSecondLineROIOffsetY, which defines the offset of the horizontal separation of the image; the feature Scan3dSecondLineROIOffsetY is only available for 3D-LLE variants which implement the extraction of a second line.

GenTL

Implemented DEVICE_INFO_TIMESTAMP_FREQUENCY.
Added BUFFER_INFO_CUSTOM_LLE_LINES_PER_IMAGE to BUFFER_INFO_CUSTOM_CMD_LIST (GenTL_v1_5_EuresysCustom.h)

EGrabber

Added EGrabber::shutdown method to completely shutdown an EGrabber including any pending or executing callbacks; it may be required to call this method in the destructor of any class deriving from EGrabber<CallbackSingleThread> or EGrabber<CallbackMultiThread>.

Memento

Adapted traces and tooltips to use CoaXPress 2.0 naming (bootstrap registers).
Improved traces related to CoaXPress control channel.

genicam-browser

Added option "Show raw bytes" to the view window; when the option is enabled, a hex dump of the raw buffer bytes at the offset corresponding to the pixel under the mouse cursor is displayed over the image (when the current zoom factor allows it).
Ensure file dialog windows open on user writable locations.
Make text fields containing potentially long path expandable.
Added CoaXPress 2.0 bootstrap registers.

Added script to periodically display the status of all I/O lines.

gentl

Added CoaXPress 2.0 bootstrap registers.

Sample programs

Added C++ samples showing how to produce EXIF files from JFIF images produced by the 3620 Coaxlink Quad CXP-12 JPEG.

Image converters

Added RGB8-to-JFIF conversion function to ImageConvert.
Added IMAGE_CONVERT_INPUT and IMAGE_CONVERT_OUTPUT helper macros to initialize ImageConvert structures

CoaXPress

The maximum control packet size supported by the Coaxlink cards has been increased to 1024.

By default the Coaxlink driver limits the control packet size to 128 bytes (which corresponds to a payload of 104 bytes). However it is possible to set the maximum control packet size up to 1024 with the feature CxpControlParameter[ControlPacketSizeMax] (in the category CoaXPressAdvanced).
Bootstrap register ControlPacketSizeMax is read after device discovery to compute the maximum size of the control packets the Coaxlink driver will use in read/write accesses to the camera; the maximum size will always be the minimum between the device register ControlPacketSizeMax and the interface module feature CxpControlParameter[ControlPacketSizeMax].

GenApi

Added properties .Address and .Length to GenICam register nodes to get the address and the length of a register as integer values.

GenICam Browser

Added capability to display JPEG images produced by the 3620 Coaxlink Quad CXP-12 JPEG.
Improved responsiveness.

gentl

Added capability to display JPEG images produced by the 3620 Coaxlink Quad CXP-12 JPEG.
Added --device-access option to most commands.

Image Converters

Added JFIF-to-RGB8 conversion function to ImageConvert

EGrabber

Added support for converted images in Open eVision
Added BufferInfo structure and related functions

A fully functional data stream can now be opened on a device opened with DEVICE_ACCESS_READONLY.

Previously, the data stream was limited to read-only access, and could not be used for image acquisition.

Data Stream

Support of 1X_2YE and 1X_2YM 2-tap geometries

Added DMA engine capabilities to reorder the pixel data delivered by area-scan cameras having a 1X_2YE or a 1X_2YM tap geometry.

See also: Image Data Transfer in the functional guide for more information.

Added data stream feature StripeArrangement values Geometry_1X_2YE and Geometry_1X_2YM.

1X_2YE tap geometry

The area-scan sensor is divided into two regions: top (1) and bottom (2). Each region has one tap. Pixels are extracted from left to right starting from the lines at the top and the bottom ends (E) of the sensor.

The two taps are interleaved on a single CoaXPress data stream.

1X_2YM tap geometry

The area-scan sensor is divided into two regions: top (1) and bottom (2). Each region has one tap. Pixels are extracted from left to right starting from the lines at the middle (M) of the sensor.

The two taps are interleaved on a single CoaXPress data stream.

Coaxlink.cti

Interface list control option

Added an option to control the interface list order exposed by the cti using a configuration file.

The Implemented feature is enabled by creating a .ini configuration file coaxlink.ini next to coaxlink.cti.

To sort interfaces by InterfaceID in ascending order:

[System]
InterfaceOrder=Ascending

To keep interfaces in the system order (default configuration):

[System]
InterfaceOrder=System

Events notification and callback

DEVICE_ERROR event notifications

Added notifications of custom event DEVICE_ERROR

See also: GenTL_v1_5_EuresysCustom for the new Event ID definitions prefixed with EVENT_DATA_NUMID_DEVICE_ERROR_
Added EGrabber callback onDeviceErrorEvent (related to DEVICE_ERROR) with a new Event DATA type DeviceErrorData

Coaxlink documentation

Online documentation

Starting from 10.5.2, the Coaxlink online documentation is available in 4 languages:

□ Default language: US English,
□ 3 translated languages: simplified Chinese, Japanese and Korean.

Each page is fitted with a "change language" button that allows the reader to quickly switch to the desired language.
Offline documentation installers for Windows

Starting from 10.5.2, four offline documentation Windows installers are available:

□ coaxlink-win-offline-documentation-EN-<ma.mi.re.bu>.exe with English language only
□ coaxlink-win-offline-documentation-EN-CN-<ma.mi.re.bu>.exe with English and Chinese languages
□ coaxlink-win-offline-documentation-EN-JP-<ma.mi.re.bu>.exe with English and Japanese languages
□ coaxlink-win-offline-documentation-EN-KO-<ma.mi.re.bu>.exe with English and Korean languages
Offline documentation archives for Linux

Starting from 10.5.2, four offline documentation archives for Linux are available:

□ coaxlink-linux-offline-documentation-EN-<ma.mi.re.bu>.tar.gz with English language only
□ coaxlink-linux-offline-documentation-EN-CN-<ma.mi.re.bu>.tar.gz with English and Chinese languages
□ coaxlink-linux-offline-documentation-EN-JP-<ma.mi.re.bu>.tar.gz with English and Japanese languages
□ coaxlink-linux-offline-documentation-EN-KO-<ma.mi.re.bu>.tar.gz with English and Korean languages

Acquisition Control

Changing Sequence Length While Camera Is Grabbing

Added the capability to change SequenceLength without stopping the data stream

If SequenceLength is changed between start-of-sequence and end-of-sequence events, the new value will be effective for the subsequent sequence. (The value of SequenceLength is latched at the start-of-sequence event.)

Sample Programs

amdDirectGMA sample improvement
Improved amdDirectGMA sample program to make use of the "AMD DirectGMA sync marker" functionality for AMD Direct GMA GPU's to get rid of software latencies.

EGrabber

New action

Added action show-mio-config to dump the current I/O extension module configuration.

GenApi features

Interface Module

Added category IOExtensionModule for dynamic reconfiguration of PC3610 and PC3612 HD26F I/O extension modules:

□ IOExtensionModuleConfiguration to enter/leave configuration mode
□ IOExtensionModuleLineSelector to select a MIO to configure
□ IOExtensionModuleLineFormat, IOExtensionModuleLineMode and IOExtensionModuleLineStatus to configure the selected MIO
□ IOExtensionModuleLineToRepair and IOExtensionModuleErrorCount to help troubleshoot an invalid current configuration

Added category IOExtensionModuleInformation with module details :

□ IOExtensionModuleSerialNumber, IOExtensionModulePartNumber, IOExtensionModuleProductCode
□ IOExtensionModuleRevision, IOExtensionModuleVariant
Device Module

Added CxpPortAlignment feature to control the byte alignment for accessing camera registers.

The default value (4) specifies a 32-bit alignment. Setting this feature to 1 enables unaligned access at any byte boundary.
Data Stream Module

Added SyncMarkerBusAddress, SyncMarkerValue, and SyncMarkerValueIncrement features.

These features allow to configure the "AMD DirectGMA sync marker".

GenICam Browser

Check Configuration action

Added action check-config (coaxlink://check-config) to check:

□ cxpConnection: whether current camera CoaXPress connection configuration corresponds to grabber detected connections;
□ width: whether camera Width meets Coaxlink line pitch alignment requirement;
□ controlMethod: whether grabber CameraControlMethod and current camera operating mode are compatible.
Configurator script

Improved coaxlink://configurator when loading vendor specific scripts.
Export XML action

Added action export-xml (coaxlink://export/xml) to export module features to an XML file.

This feature allows to export all parameters including Remote Device (camera) parameters and their values to an XML file.

I/O Tools

Line Input Tool

Added new LineInputToolActivation enumeration entry AllEdges.

When set to AllEdges, the LIN tool generates an event on each transition of the line signal.

Events

New event notification context

Added new EventNotificationContext enumeration entry LineStatusAllHi.

This allows the high 32-bit part of the LineStatusAll feature to be reported in an event notification context.

GenApi features

Interface Module

Added features CxpControlParameterSelector and CxpControlParameter in the category CoaXPressAdvanced to set CoaXPress control parameters TransactionTimeout and TransactionMaxResendCount.

Firmware Management

CustomLogic firmware management

Improved handling of CustomLogic firmware files in Firmware Manager.

Installer

Un-installation progress indicator

Show waiting message or progress dialog during Coaxlink package installation.

 

GenICam XML

Reading XML file location 4 bytes at time

Improved handling of cameras that require the XML file location to be read 4 bytes at a time.

This fulfills the following notification in the section 11.2.2 of the CoaXPress 1.1.1 specification:
"The Host does not know the length of the string, so it must read it 4 bytes at a time until it sees the NULL terminator."

Data Stream Module

PFNC pixel formats

Added more pixel formats to PixelFormat of data stream module.

□ The standard Bayer 14-bit formats supersede Custom ones.
NOTE
□ All PFNC pixel formats defined in the GenICam PFNC.h file published on 2018-11-12 are included.
□ The obsolete custom Bayer 14-bit formats are still available with the prefix Custom.

GenICam Browser

Enumeration entry description

Show enumeration entry description next to value also for read-only values.

Pixel Processing

Flat Field Correction

Added a hardware flat field correction pixel processing stage to:

□ the 1-camera firmware variant of 1633 Coaxlink Quad G3
□ the 2-camera firmware variant of 3602 Coaxlink Octo

The flat field correction - FFC - applies gain and offset coefficients to each pixel of the captured image.

The FFC stage is inserted before the LUT processing and the BAYER CFA decoder stages in the hardware pixel processing.

See also: Flat Field Correctionin the Functional Guide.

GenApi features

Data Stream Module
Added features FfcCoefficientPartitionBase, FfcCoefficientPartitionSize, FfcControl, FfcBypass, FfcCoefficientsValid in the new category FlatFieldCorrection.
Added feature PixelComponentCount

Added Width.Inc (increment of feature Width) This increment takes into account the pixel format and the Coaxlink firmware line pitch constraints.

See also: Width Increment Step in the Functional Guide.

CoaXPress Host Interface

DataStream Specification

Added the Width Increment Step specification in the Functional Guide

For 1633 Coaxlink Quad G3, 1635 Coaxlink Quad G3 DF and 3602 Coaxlink Octo, reduce the width increment step:

□ to 4 pixels for all 8-bit formats,
□ to 2 pixels for all 10-, 12-, 14- and 16-bit formats,

This improvement is not available when the hardware Bayer CFA decoder is enabled.

When the Widthincrement is not compatible with the current Width value, getting the value of Width raises an error. Because the Width value is required to compute the payload size, the PayloadSize cannot be evaluated and buffers cannot be allocated & announced!

EGrabber Sample Programs

EGrabber Sample Programs

Added C++ ffc-wizard sample application (samples/cpp/ffcWizard) with FFC Wizard Sample Program

Improved "640-mitsubishi-kd6r807cx" sample program
Improved "660-phantom" sample program
Added C# "egrabber-wpf" sample

GenApi

FFC Support
Added action load-ffc to load flat field correction coefficients.
Added coaxlink://ffc/load.js to help load flat field correction coefficients from Euresys configuration script.

Firmware Management

Firmware Update/Install and Firmware Install

Increased the speed of firmware update/install operations by a factor 2 on 1633 Coaxlink Quad G3, 1635 Coaxlink Quad G3 DF and 1637 Coaxlink Quad 3D-LLE cards with serial number above 10,000.

Increased the speed of firmware update/install operations by a factor 4 for 3602 Coaxlink Octo

Events

Camera Connection and Disconnection Events

Added notifications of camera connection/disconnection events: ConnectionDetectedCxpA, ConnectionDetectedCxpB, ..., ConnectionUndetectedCxpA, ConnectionUndetectedCxpB, ..., Device0Ready, Device1Ready, ..., Device0Lost, Device1Lost, ...

GenApi features

Interface Module

Added features CustomLogicControlAddress and CustomLogicControlData in category CustomLogic, available only for "custom-logic" firmware variants.

Added features OnboardMemoryBase and OnboardMemorySize in category OnboardMemory, available for CustomLogic firmware variants.

EGrabber

Improved EGrabbers Helper Class

Added function clear to discard current list of grabbers

Added EGrabberPredicate to instantiate specific grabbers instead of all available grabbers

Added possibility to reposition a grabber in the flat list

 

Improved EGrabber Class

Added function isOpen to EGrabber class to check if a GenTL module has been open

Added EGrabber constructor parameter remoteRequired to indicate whether the remote device is required to create the grabber object

□ Breaking change the grabber classes (based on EGrabber) instantiated by EGrabbers require the additional constructor parameter (bool remoteRequired).

See also: sample "213-egrabbers" for details!

Added functions read and write to all (not only remote device) GenTL port objects exposed in Euresys scripts

Added optional offset argument to read and write functions of the GenTL port objects exposed in Euresys scripts

 

EGrabber Sample Programs

Updated "213-egrabbers" sample

Added "250-using-lut" sample

Added "302-cxp-connector-detection" sample

Updated "660-phantom" sample to use EGrabbers class, to simplify enumeration of available grabbers in the system

Added "501-all-grabbers-cuda-process" sample

Added "egrabber-mfc" sample

GenApi

GenApi Scripts Improvements

Added coaxlink://query to help find grabbers
Added Euresys script functions: system.readFile, system.readBinaryFile, crypto.sha1sum
Added functions read and write to GenTL port objects exposed in Euresys scripts
Added operator % to Euresys script

PIxel Processing

Red/Blue Color Components Swap

Added RedBlueSwap capability to hardware Bayer decoding

Memento

Start-up Time Improvement

Memento trace definition files are now merged and compacted during installation

GenICam Browser

Save Raw Buffer As png, bmp, jpg and tiff

Added support for png, bmp, jpg and tiff to save raw buffer function
Hardware Bayer Decoding

Added support for hardware Bayer decoding to:

● 1-camera firmware variant of 1633 Coaxlink Quad G3,
● 1-df-camera firmware variant of 1635 Coaxlink Quad G3 DF,
● 1-camera firmware variant of 3602 Coaxlink Octo,
● 2-camera firmware variant of 3602 Coaxlink Octo .

The new GenApi feature BayerMethod, in the category Bayer of the datastream module, exposes or not the decoding methods Legacy and/or Advanced depending on the installed firmware capabilities.
CoaXPress Rate Mask

Added features CxpRateMaskCXP1, ..., CxpRateMaskCXP12 to help control the feature CxpRateMask in the category CoaXPressAdvanced
Support 10-, 12-, 14- and 16-bit RGB, BGR and Bayer formats

ImageSaveToDisk, Buffer::saveToDisk, and ScopedBuffer::saveToDisk can now handle 10-, 12-, 14- and 16-bit RGB, BGR and Bayer formats.

gentl grab can now handle 10-, 12-, 14- and 16-bit RGB, BGR and Bayer formats.
EGenTL

Added command and done builders to namespace Euresys::query
EGrabber Sample Programs

Added "130-using-buffer" sample

Added "140-genapi-command" sample

Added "231-script-var" sample

Added "240-user-memory" sample

Image Converters

Improved ImageConvert

Added automatic detection of SSSE3 CPU flag to use optimized image conversion functions only when applicable.

Added IMAGE_CONVERT_OUTPUT_CONFIG_O0 (see include/EuresysImage.h) to disable SSSE3 optimizations (when applicable) while converting an image.

GenICam Browser

CPU optimization control
Added a setting to control CPU optimizations for image conversions in the Preferences window.
Zoom control

Added zoom in and zoom out contextual sub-menus in views.

CoaXPress Discovery

Link Reset

Avoid sending LinkReset commands to connectors in transient state.
Discovery Timing Control

Added CxpDiscoveryTiming feature to the category CoaXPressAdvanced (see ShowCoaXPressAdvancedFeatures), for fine-grained control over CoaXPress discovery timings selected by CxpDiscoveryTimingSelector.

GenApi

Improved GenApi Implementation
Improved @features that now supports an optional category name parameter.
Added @categories, @interfaces, see @help for details.
Added virtual user features: @declare(integer), @declare(float), @declare(string), @declared, @undeclare.
Added @done to check if a command is done.

Added new functions to GenTL port objects exposed in the scripts: featuresOf, categories, categoriesOf, done, interfaces, source, info, declare, undeclare, declared. See coaxlink://scripts/doc/grabbers.js for details.
Advanced CoaXPress Features Control

Added ShowCoaXPressAdvancedFeatures feature to the interface module.

When enabled, the new category CoaXPressAdvanced becomes available and its features (CxpRateMask, CxpDiscoveryTiming and CxpUpConnectionSpeedConfig) become visible.
Remote Device Automatic Setting Control Feature

Added virtual configuration feature @setTLParamsLocked to enable (default) or disable automatic setting of remote device feature TLParamsLocked (when present) before executing command AcquisitionStart and after executing command AcquisitionStop.

EGentl Header

Helper Functions

Added new sets of helper functions to build special @-prefixed commands to EGenTL header file:

● In namespace Euresys::query: builders for EGenTL::genapiGetStringList and EGrabber::getStringList
● In namespace Euresys::action: builders for EGenTL::genapiSetString and EGrabber::setString

EGrabber

New EGrabbers Helper Class

Added EGrabbers helper class to manage all available grabbers in the system (see include/EGrabbers.h and "213-egrabbers" sample program).
EGrabber Sample Programs

Added "212-use-all-grabbers" sample.

Added "213-egrabbers" sample showing how to use the new helper class EGrabbers.

Added "230-script-vars" sample.

Added "660-phantom" sample.

Firmware Manager

Bank Selection Control

Added bank-select command to query or set the firmware bank select.

GenTL

Buffer Management

Improved handling of very large numbers of buffers:

● Increased the speed of buffer announce and revoke operations.
● Added DmaEngineOptimization feature to data stream module, with two values:
□ Default: DMA operations are optimized for low latency and maximum PCIe throughput.
□ LowMemoryUsage: DMA operations are optimized for low memory usage; this may lead to higher latency and reduced PCIe throughput.

Installers

Windows 10 Installers

Added a new installer named coaxlink-win10-9.5.2.131.exe that contains a Windows 10 driver signed by Microsoft.

With this installer, it is no longer necessary to disable Secure Boot.

NOTE
□ The coaxlink-win-9.5.2.131.exe installer embedding drivers signed by Euresys remains available in case of issues with the other installer.
□ Installation on Windows Server 2016 still requires disabling Secure Boot.

Memento

Tooltips

Added tooltips for memento traces that raise frequent questions.

Added tooltips for memento kinds.

Debug and Monitoring

Analyzer probes

Added analyzer probes: Acquisition, Trigger, Strobe, DMA, Scan, Readout, Lock, Rate, Extension, q.Input, q.Output, q.Unqued, and q.Pending.

These probes feed the Memento Analyzer Tool.

Firmware Management

Reduced programming time

Increased the speed of firmware update and firmware install operations on 1630 Coaxlink Mono, 1631 Coaxlink Duo and 1632 Coaxlink Quad and 1638 Coaxlink Quad CXP-3 cards.

Pixel Formats

YCbCr601 4:2:2/YCbCr709 4:2:2/YUV 4:2:2 pixel formats

Added support for:

● YCbCr601_422_8 and YCbCr601_422_10
● YCbCr709_422_8 and YCbCr709_422_10
● YUV422_8 and YUV422_10

Image Converter

YCbCr/YUV 4:2:2 to RGB

Added conversions from YCbCr601 4:2:2, YCbCr709 4:2:2 and YUV 4:2:2 to RGB8 and BGR8

Sample Programs

EGrabber Sample Programs

Added 500-grabn-cuda-process sample to demonstrate image acquisition and processing with a NVIDIA CUDA GPU
Added 620-multiple-camera sample to demonstrate concurrent image acquisition from multiple cameras

Installers

Linux Installer
● Added INSTALL file documenting installation steps.
● Added option -m to install.sh.
This allows to use a previously built driver coaxlink.ko.
● Improved Coaxlink module Makefile.
This allows targeting a specific kernel using the variable KDIR .
● Improved the installation script.
The script suggests system-dependent instructions to install the missing tools or libraries.

EGrabber

EGrabber header files

Improved EGrabber header files to prevent incorrect usage of EGenTL objects (which cannot be copied)

Format Converters

Bayer decoding method selection

Added possibility to select the Bayer decoding method in the FormatConverter

GenICam Browser

Preferences window

Improved the Preferences window:

● Added tabs and tooltips
● Added configuration of Bayer decoding method
● Added configuration of quality for images saved to disk in jpeg format

Firmware Manager

GUI for aarch64 platform

Added the Firmware Manager GUI to aarch64 platforms

CoaXPress Host Interface

4-data-stream Concurrent Acquisition

Added the capability to interface 4-data-stream area-scan cameras.

The new "1-camera, 4-data-stream" firmware variant of 1633 Coaxlink Quad G3 allows to connect one area-scan CoaXPress camera that delivers up to 4 independent data streams.

The frame grabber sorts the incoming CoaXPress data blocks according to the value of the 2 least significant bits of the CoaXPress StreamID and feeds four independent data paths.

Each data path is capable of handling the full CoaXPress link bandwidth, namely 2.5 GBytes/s. It includes:

1. A 250 MB FIFO buffer memory
2. A pixel processor that allows to align 10/12/14-bit data to the LSB or to the MSB of a 16-bit container.
3. A DMA engine that transfers image data directly to the user memory space of the Host PC.

The multistream sample program shows how to create 4 instances of EGrabber and start acquisition on 4 concurrent data streams.

CoaXPress Discovery

When a master loses an extension, the CoaXPress discovery procedure is restarted on the master to make sure host and device configurations match.

GenApi features

Device Module

Added CameraAndIlluminationControllerStream feature.

This feature allows to designate which data stream is used as reference for the Camera and Illumination controller.

Software Tools

Firmware Manager Tool

Added strip command to coaxlink-firmware.exe.

This command allows the user to generate a stripped-down version of coaxlink-firmware.exe by keeping only the firmware variant(s) that need(s) to be redistributed.
CoaXPress Link Validation

Added ber command to gentl.exe.

The ber command allows the user to measure the bit error rate (BER) of a CoaXPress Link.

See also: CoaXPress Link Validationapplication note in the Coaxlink Functional Guide.
Added --enable-dump flag to gentl ber (enable dump of defective surfaces to files)

GenApi features

Data Stream module

Added the possibility to change LineWidth, LinePitch, StripeHeight, StripePitch, and StripeArrangement features of the data stream module after one or more buffers have been announced; this makes it possible to create different sets of buffers with different configurations.
Interface module

Added ProductCode feature to interface module.

GenTL

Buffer Info

Added BUFFER_INFO_CUSTOM_STREAM_LINE_WIDTH, BUFFER_INFO_CUSTOM_STREAM_LINE_PITCH, BUFFER_INFO_CUSTOM_STREAM_STRIPE_HEIGHT, BUFFER_INFO_CUSTOM_STREAM_STRIPE_PITCH, and BUFFER_INFO_CUSTOM_STREAM_STRIPE_ARRANGEMENT to BUFFER_INFO_CUSTOM_CMD_LIST (GenTL_v1_5_EuresysCustom.h).

Sample Programs

EGrabber Sample Programs

Updated "queue-buffer-ranges" sample program to show how to setup 2 sets of buffers, one for grabbing regular (top-down) images, the other for grabbing vertically flipped (bottom-up) images.
GenApi
GenApi Features Range Checking

Added Min/Max(/Inc) range checking to Integer and Float nodes.
Events
Global Event Controls

Added EventNotificationAll and EventCountResetAll to Interface, Device, and Data Stream Modules.

● EventNotificationAll activates or deactivates the notification of all events,
● EventCountResetAll resets all the event counters.
Camera Trigger
CoaXPress Host to Device Trigger Rate

Lowered the minimum bound of CycleMinimumPeriod to 3.36 microseconds.

This allows sending CoaXPress triggers at up to 297.6 kHz.
Events
Context Information

Added QuadratureDecoderToolPosition as possible context information reported in EVENT_DATA_CUSTOM_CONTEXT_x.

This feature allows to report the value of the QDC position counter at the time of occurence of an event.
GenApi features
Device Module

Added ExposureTimeMin and ExposureTimeMax to CameraModel category.

These features specify the limits of the exposure time range allowed by the camera. They are used to validate the ExposureTime value.
I/O Toolbox
I/O Toolbox composition

The I/O toolbox of the 2-camera firmware variant of 1631 Coaxlink Duo, 1632 Coaxlink Quad, 1629 Coaxlink Duo PCIe/104-EMB, and 1634 Coaxlink Duo PCIe/104-MIL has been expanded to include 2 instances of the QDC, DIV, MDV and DEL tools.

With this improvement, the composition of the I/O Toolbox is more uniform:

● All 1-camera and 1-camera, line-scan firmware variants include 8 LIN, 1 QDC, 1 DIV, 1 MDV and 2 DEL tools,
● All 2-camera and 2-camera, line-scan firmware variants include 8 LIN, 2 QDC, 2 DIV, 2 MDV and 2 DEL tools,

● 4-camera and 4-camera, line-scan firmware variants of 1632 Coaxlink Quad and 1633 Coaxlink Quad G3 include 8 LIN, 4 QDC, 4 DIV, 4 MDV and 4 DEL tools.

Sample Programs
EGrabber Sample Programs

Added 640-misubishi-kd6r807cx sample to demonstrate concurrent image acquisition from a Mitsubishi KD6R807CX camera using 2 1633 Coaxlink Quad G3 frame grabbers.

The 8-connection Mitsubishi KD6R807CX embeds two line-scan sensors and exposes one 4-connection CoaXPress device for each.
Tools
Conversion functions
Improved ImageConvert to handle input pitch values for copy operations
EGrabber
Buffer Management

Added EGrabber method getBufferData

Added EGrabber methods queue(range) and resetBufferQueue(range)
Added support of ".raw" extension to saveToDisk : save raw buffer without any prior conversion.
Sample Programs
EGrabber Sample Programs

Added get-announced-handles sample to demonstrate the getBufferData method.
Added queue-buffer-ranges sample to demonstrate queue(range) and resetBufferQueue(range) methods.
GenApi features
Data Stream Module

Added new categories for 1637 Coaxlink Quad 3D-LLE: LinearFilter, Threshold and LaserLineExtractor.
Added feature StripeArrangement with values Geometry_1X_1Y (regular top-down image) and Geometry_1X_1YE (bottom-up image)
Tools
Image Conversion Tools

Added FormatConverter method prepareBuffers to speed up initial image conversions .
Added support of pixel formats Coord3D_C8 and Coord3D_C16.
GenICam Browser

Added support of pixel formats Coord3D_C8 and Coord3D_C16. These formats are displayed respectively as Mono8 and Mono16.
Added option to save raw buffer data to disk.
gentl.exe

Added support of pixel formats Coord3D_C8 and Coord3D_C16. These formats are displayed respectively as Mono8 and Mono16.
The genapi command accepts a new --hex flag to show integer values in hexadecimal.
Added support of ".raw" extension when saving images to disk
I/O Toolbox
1633 Coaxlink Quad G3 - 4-camera firmware variant

Added 4 instances of the QDC, DIV, MDV and DEL tools to the toolkit.

 

 

GenTL
Info commands

Implemented remaining mandatory standard info commands:

● TL_INFO_GENTL_VER_MAJOR, TL_INFO_GENTL_VER_MINOR (GenTL 1.5)
● URL_INFO_FILE_REGISTER_ADDRESS, URL_INFO_FILE_SIZE, URL_INFO_SCHEME, URL_INFO_FILENAME for local URL (GenTL 1.5)
● BUFFER_INFO_CONTAINS_CHUNKDATA (GenTL 1.4)
● URL_INFO_FILE_SHA1_HASH for remote port (GenTL 1.4)
● EVENT_DATA_NUMID for New Buffer event (GenTL 1.3)
CoaXPress Discovery

Allows extensions to be connected after the master discovery completed with missing extensions.

Simplifies discovery on undetected connectors where an extension is expected by using the same rate as the discovered (and configured) master.
Bootstrap Register

The bootstrap register StreamPacketSizeMax:

● is set to the host packet maximum size only when the discovery completes successfully with all the required extensions,
● is reset to zero when changing the link configuration or when an extension is disconnected.
GenApi features
Interface Module

Added interface features about CXP rates supported by the card (CXP1Supported, CXP2Supported, CXP3Supported, CXP5Supported, CXP6Supported, CXP10Supported, CXP12Supported)

 

Coaxlink 7.1

GenICam Browser
Ignore ROI Position
Added "Ignore ROI position" to genicam-browser preferences to draw ROIs at location (0,0)

Coaxlink 7.0.1

ImageConvert

ImageConvert handles conversion paths from packed and/or Bayer pixel formats to RGB8/BGR8 in one step.

User code grabbing packed formats can be simplified by removing the intermediate conversion step.
GenTL Device Module
Feature Name Feature Description
10-/12-/14-bit packed

Added support for 10-/12-/14-bit monochrome and Bayer CFA packed pixel formats (UnpackingMode=Off)
Conversion Functions
Feature Name Feature Description
10-/12-/14-bit packed

Added image conversions for packed 10-/12-/14-bit pixel formats (available in the ImageConvert function)
Extended RGB converter Extended RGBConverter C++/.NET class (now a.k.a. FormatConverter) to also provide conversion to any supported output format (nested class Auto)
GenTL
Feature Name Feature Description
Line Pitch

Added BUFFER_INFO_CUSTOM_LINE_PITCH to BUFFER_INFO_CUSTOM_CMD_LIST (GenTL_v1_4_EuresysCustom.h)
gentl.exe
Feature Name Feature Description
Write command Added write command

 

Coaxlink 7.0

GenTL Interface Module
Feature Name Feature Description
OEM Safety Key Length Control The length of ProgramOemSafetyKey and CheckOemSafetyKey is now limited by a user-configurable MaximumOemKeyLength. The default value is 4096 characters.
GenTL Device Module
Feature Name Feature Description
Toggling Host to Device Trigger messages

Added new value Toggle to CxpTriggerMessageFormat, and related feature CxpTriggerLevel.

When CxpTriggerMessageFormat is set to Toggle, every Camera Trigger generates a single message transaction on the Host to Device I/O Channel alternating rising edge or falling edge trigger messages.

The CxpTriggerLevel feature allows the application to set and/or get the current level of the CoaXPress Host to Device Trigger signal.

CIC end of sequence control

Added new features to the Camera and Illumination Controller:

●EndOfSequenceTriggerSource
●SequenceLength
●StopSequence

The Camera and Illumination Controller provides the following options to stop a sequence:

● When EndOfSequenceTriggerSource is set to SequenceLength, the sequence stops automatically after having executed a number of camera cycles specified by SequenceLength. Any number of cycles ranging from 1 to 16,777,215 is allowed. The sequence can be stopped anticipatively on execution of the StopSequence command.
● When EndOfSequenceTriggerSource is set to StopSequence, the sequence stops only on execution of the StopSequence command.
● When EndOfSequenceTriggerSource is set to <any-event-source>, the sequence stops on the next occurence of an event on the specified event source or on execution of the StopSequence command. Possible event sources include any available LIN*, QDC*, MDV*, DIV*, DEL*, EIN*, User Event* event source.

By default, EndOfSequenceTriggerSource is set to StopSequence and SequenceLength is set to 1.
CIC Pending Triggers Control Added new features to the Camera and Illumination Controller:
●CycleMaxPendingTriggerCount
●CyclePendingTriggerCount

The Camera and Illumination Controller is fitted with a trigger latching mechanism capable of recording triggers that cannot be served immediately and postponing their execution.

The capacity of the latch is configured by CycleMaxPendingTriggerCount:

●When CycleMaxPendingTriggerCount is 0, the trigger latch mechanism is disabled. Any cycle trigger that cannot be served immediately is rejected and increments CycleLostTriggerCount.
●When set to any value ranging from 1 to 7, the trigger latch mechanism is enabled. Providing that CyclePendingTriggerCount is below CycleMaxPendingTriggerCount, any cycle trigger that cannot be served immediately is latched and increments CyclePendingTriggerCount .

By default, CycleMaxPendingTriggerCount is set to 0.
GenICam Features related to the Camera and Illumination Controller are not available when CameraControlMethod is NC or EXTERNAL
Memento Raised level of memento traces regarding camera triggers, strobes, and camera readout
DataStream Module – LUT configuration
Feature Name Feature Description
GenICam

LUT configuration features are locked while grabbing
Sample Programs
Feature Name Feature Description
NIVIDIA CUDA

Adapted nvidia/egrabber-cuda sample program for linux
gentl, EGrabber
Feature Name Feature Description
Open device as read-only

gentlscript command accepts a new --ro flag to open the device as read-only

EGrabber constructor has a new optional argument to open the device as read-only

 

Coaxlink 6.2.1

GenTL Device Module
Feature Name Feature Description
CoaXPress Link Configuration Option

Added custom GenApi feature CxpLinkConfigurationOption to GenTL device module.

This new feature specifies the behaviour of the Coaxlink when the application sets the CxpLinkConfiguration feature:

●When set to AlwaysWrite, the link configuration is always written to the camera. This is the default behaviour.
●When set to WriteIfDifferent: the link configuration is written to the camera only if it is different from the current configuration.

Pixel Processing
Feature Name Feature Description
LUT processor

Added LUT processor for monochrome 8-bit, 10-bit, and 12-bit pixel formats to all product/firmware variants.
Added bit depth reduction to 8-bit for monochrome 10-bit and 12-bit pixels
Added bit depth expansion to 16-bit for monochrome 10-bit and 12-bit pixels
GenTL Data Stream Module
Feature Name Feature Description
LUT Control features

Added new GenApi features category LUTControl

Added category members: LUTConfiguration, LUTLength, LUTMaxValue, LUTSet, LUTIndex, LUTValue, LUTReadBlockLength and, LUTEnable.
Stream Control features Added new GenApi features to the StreamControl category: LineWidth, LinePitch, StripeHeight and, StripePitch.
Scripts
Feature Name Feature Description
Parametric LUT construction Added Euresys configuration scripts for parametric LUT construction
●coaxlink://lut/emphasis
●coaxlink://lut/response-control
●coaxlink://lut/threshold
LUT construction wizard Added new action "lut-builder" (LUT construction Wizard)
Documentation
Feature Name Feature Description
Coaxlink Documentation Added Coaxlink Documentation.

An HTML WebHelp Responsive documentation system collating all Coaxlink-related documentation topics.

Main sections are:

●Coaxlink Programmer's Guide
●EGrabber Reference Manual
●Coaxlink Functional Guide
●GenApi features Reference
●Coaxlink Hardware Manual
●Memento Documentation
Added GenApi features main section.

An exhaustive list of GenApi features sorted by module and category.
Added Coaxlink Documentation Installer for Windows.

Executing coaxlink-win-documentation-<ma.mi.re.bu>.exe installs the Coaxlink HTML Documentation files on your PC.

Functional Guide

Updated the Coaxlink Functional Guide.

Revised Image Data Flow section with new LUT processing sub-section.

 

Coaxlink 6.1.2

Time stamp
Feature Name Feature Description
Clock synchronization

Improved the synchronization of the hardware and system clocks and the related Memento messages.

See also: .

 

Coaxlink 6.1.1

EGrabber
Feature Name Feature Description
Memento

EGrabber classes now use memento kind EGrabber
EGrabber method memento allows specifying verbosity and user kind
GenTL Data Stream Module
Feature Name Feature Description
Pixel Format Enumeration Removed duplicated PixelFormat values from data stream module xml
GenTL
Feature Name Feature Description
IFGetDeviceInfo() Status

Changed status value returned by the GenTL function IFGetDeviceInfo to 

DEVICE_ACCESS_STATUS_UNKNOWN
when the device is not yet open.

 

Coaxlink 6.1.0

 

EGrabber
Feature Name Feature Description
Event handling

Improved EGrabber event handling for CallbackOnDemand and CallbackSingleThread threading models (lighter weight and more efficient event dispatching)
GenTL Device Module
Feature Name Feature Description
Abort CIC Sequence

Added AbortSequence command to device module.
GenTL Interface Module
Feature Name Feature Description
GPIO line sources

Added new LineSource values: Device0Stream0StartOfCameraReadout, Device1Stream0StartOfCameraReadout, Device2Stream0StartOfCameraReadout, Device3Stream0StartOfCameraReadout.
DIV tool

Extended range of DividerToolDivisionFactor from [1..1023] to [1..65535].

Extended range of DividerToolInitialOffset from [0..1023] to [0..65535].
OEM safety key

Added new feature OemSafetyKeyVerification.

When, during the key verification procedure, OemSafetyKeyVerification is set to EncryptedKey, only the encrypted key (i.e., the value read from EncryptedOemSafetyKey during the OEM safety key programming procedure) can be used to verify the OEM safety key.

This improves the security level since the programming key doesn't need to appear anywhere in the end user application. Having only the encrypted key, the end user cannot retrieve the original programming key.
CoaXPress Host Interface
Feature Name Feature Description
Sub-Link Acquisition

Add preliminary support of an 8-connection area-scan camera on 1633 Coaxlink Quad G3 by splitting the CoaXPress Link into 2 sub-links, each with 4 connections.

The first 4-connection sub-link connects to the "sub-link-master grabber": a 1633 Coaxlink Quad G3 fitted with the 1-slm-camera firmware variant.

The next 4-connection sub-link connects to the "sub-link-slave grabber": a 1633 Coaxlink Quad G3 fitted with the 1-sls-camera firmware variant.

Each grabber delivers one-half of the image frame into a GenTL buffer. The application has to reconstruct the whole image frame by merging the contents of the two corresponding buffers. This is shown in the new "320-sublink" EGrabber sample program.

The master grabber controls the camera and manages the system triggers.

Both grabbers are configured to capture all the image data of their respective sub-link.

This feature applies only to 8-connection area-scan cameras having the following characteristics:

●The image header and the image data of the first line are packed together into a single CoaXPress data packet and delivered to CoaXPress Connection 0.
●For the remaining lines of the frame (or ROI), the image data of a single image line are packed into a single packet and delivered to the next CoaXPress Connection. Connections are rotated using the CoaXPress standard packet distribution ordering rule: (0 to 7, then back 0).
●The image frame (or ROI) height must be a multiple of 8 lines to ensure that the last image line is delivered on the last connection (Connection 7).

 

Coaxlink 6.0

Interface Module
Feature Name Feature Description
User Actions Scheduler

Added User Actions Scheduler tool.

The UAS tool allows the user to schedule actions to be executed immediately or at a specified local time, QDC1 position or QDC2 position. Available actions:

● Set, clear, or toggle any User Output Register bit
● Generate any of the four I/O Toolbox User Events

Added GenApi features for using the User Actions Scheduler tool to interface module:

● UserActions, AddUserAction, ClearUserActions
● ExecuteUserActions, ScheduleUserActions
● UserActionsSchedulerReference
● ScheduledUserActionsPoolStatus, DiscardScheduledUserActions
GenApi
Feature Name Feature Description
Performance Improved overall GenApi performance.
Firmware Manager
Feature Name Feature Description
GUI Added gui mode to start the graphical user interface.
Flash Progress Added flash progress reporting in the console mode.
Documentation
Feature Name Feature Description
Coaxlink PCIe/104 Hardware Manual Added Hardware Manual for 1634 Coaxlink Duo PCIe/104.
Functional Guide

Updated the Coaxlink Functional Guide in PDF format.

The version 6.0 of the functional guide describes the functions of all the currently available Coaxlink Products when they are operated with version 6.0 of the Coaxlink.

 

Coaxlink 5.1

Interface Module
Feature Name Feature Description
OEM Safety Key

Added OEM safety key functionality.

This capability allows the application to assign a safety key to a Coaxlink card. The key is encrypted and stored in the non-volatile memory of the card. It can be read back only once for verification after programming. The validity of the key can be checked at any time.

Added ProgramOemSafetyKey, EncryptedOemSafetyKey, and CheckOemSafetyKey GenApi features to interface module.

Device Module
Feature Name Feature Description
Sequence Trigger

Added the capability to trigger the start of an acquisition sequence.

This capability allows the application to trigger the first acquisition of an acquisition burst using a software trigger command or a hardware trigger event issued by the I/O Toolbox.

This capability emulates the "TrigMode=HARD/NextTrigMode=REPEAT" settings of MultiCam.

Added SequenceControl category to device module.

Added StartOfSequenceTriggerSource and StartSequence GenApi features to device module.
External Camera Control

Added the capability to forward a trigger signal applied on any GPIO input port to the camera through the CoaXPress Link using CoaXPress Host to Device trigger messages.

This capability allows an external equipment to control the camera exposure.

Added value EXTERNAL to CameraControlMethod device module GenApi feature.

Added new entry ExternalTriggerReqsTooClose to ErrorSelector enumeration.

Documentation
Feature Name Feature Description
Coaxlink Programmer's Guide

Added a new edition of the Coaxlink Programmer's Guide in HTML format.

The Coaxlink Programmer's Guide describes the components of the Coaxlink.

NOTE The HTML page is automatically installed with the Coaxlink in the \doc folder. It is named coaxlink.html.
NOTE It can be viewed by clicking on the "Coaxlink Programmer's Guide" shortcut in the "Euresys Coaxlink" start menu of Windows.
EGrabber Reference

Updated the EGrabber Reference Documentation in HTML format.

The EGrabber reference manual describes extensively every element of the EGrabber API.

NOTE The HTML fileset is automatically installed with the Coaxlink in the \doc\egrabber-reference\ folder. The main page is named index.html.
NOTE It can be viewed by clicking on the "EGrabber Reference Manual " shortcut in the "Euresys Coaxlink" start menu of Windows.
Functional Guide

Updated the Coaxlink Functional Guide in PDF format.

The version 5.1 of the functional guide describes the functions of all the currently available Coaxlink Products when they are operated with version 5.1 of the Coaxlink.

NOTE The file is available for download on https://www.euresys.com/support/?serie=coaxlink-series.

Coaxlink 5.0

GenICam Browser
Feature Name Feature Description
GenApi Tabs View Improved the way GenApi tabs are displayed when switching from another tab.
Documentation
Feature Name Feature Description
EGrabber Reference

Add first edition of the EGrabber Reference Documentation in HTML format.

The EGrabber reference manual describes extensively every element of the EGrabber API.

NOTE The HTML fileset is automatically installed with the Coaxlink in the \doc\egrabber-reference\ folder. The main page is named index.html.
NOTE It can be viewed by clicking on the "EGrabber Reference Manual " shortcut in the "Euresys Coaxlink" start menu of Windows.
Hardware Manual

Add a new edition of the Coaxlink Hardware Manual in PDF format.

The version 5.0 of the hardware manual is describes the hardware layer of all the currently available Coaxlink Products including the new 1635 Coaxlink Quad G3 DF.

NOTE The file is available for download on https://www.euresys.com/support/?serie=coaxlink-series.
Functional Guide

Add a new edition of the Coaxlink Functional Guide in PDF format.

The version 5.0 of the functional guide describes the functions of all the currently available Coaxlink Products including the new 1635 Coaxlink Quad G3 DF.

NOTE The file is available for download on https://www.euresys.com/support/?serie=coaxlink-series.

 

Coaxlink 4.7

CoaXPress Host Interface
Feature Name Feature Description
Packet Arbiter Reset

Added CxpPacketArbiterReset GenApi command to Device module.

By default, according to the CoaXPress Standard, Coaxlink doesn't reset the packet arbiter every frame. The first packet of a the subsequent frame is expected on the next Connection in ascending order.

Some cameras, incorrectly resets to Connection 0 on every frame.

For such cameras, the CxpPacketArbiterReset GenApi command allows the user to 'manually' resets the Coaxlink packet arbiter at every frame boundary

CoaXPress 1.1.1

Partial support for CoaXPress 1.1.1.

See also: cxp111_discovery.htm

Link Configuration

Added CxpLinkConfiguration GenApi feature to device module.

This feature allows the user application to configure the CoaXPress Link (speed and connections) using always the same GenApi feature name regardless of the camera brand.
CoaXPress Revision

Added CxpRevisionSupport GenApi feature to interface module.

The feature reports the support status of the CoaXPress standard revision selected by the GenApi feature CxpRevisionSelector.
Microsoft Windows
Feature Name Feature Description
Fast Start-up

Added support of Windows fast start-up.
GenICam Browser
Feature Name Feature Description
Save & Restore

Added save/restore state functionality.

A state is a text file containing a list of module ports under which features and their associated values and access rights are listed in a tree like structure.

The “Save State…” button is used to save the selected module or all modules highlighted in blue. At the end of the process, the user can choose a file name to save the state.

The “Restore State” button is used to restore the state of modules.

NOTE When saving all modules highlighted in blue in the GenICam Browser, the user will be asked to save or not the RemotePort state (that is the features from the camera).
Save & Restore Scripts

Saving and restoring state is also accessible from the scripts.

Examples:

var grabber = grabbers[0]; // Select the first grabber from grabbers list
// Save
var withRemote = true;
// Save “all modules” from a grabber
require('coaxlink://save-state.js'). captureGrabbers([grabber], withRemote, ['grabber.es']);
// Save the DevicePort from a grabber
require('coaxlink://save-state.js').captureModules([grabber], 'DevicePort', ['device.es']);
// Restore a previously saved state
require('coaxlink://restore-state.js').restore([grabber], 'state.es');
Enumeration Entry Tooltip

Show Tooltip of enumeration entries when available in the XML file.

Previously, only the Tooltip of the enumerated feature was shown.
Jump to node definition Jump to XML node definition from GenApi feature.
XML View Improvements
● Show GenICam node value as call-tip (including selectors).
● Jump to GenApi tab feature when applicable.
● Jump to node selector from selected node.
● Jump to selected node from node selector.
● Find occurrences of current node.

Find current word or selection.
Sample Programs
Feature Name Feature Description
NVIDIA CUDA

Added egrabber-cuda sample program.

See also: coaxlink-sampleprograms\cpp\nvidia\egrabber-cuda\README.txt file for more info.
Memento
Feature Name Feature Description
xperf command

Added xperf command to Memento.

This command allows recording Memento data and XPerf data to a disk file.

 

Coaxlink 4.6

Area-scan Acquisition
Feature Name Feature Description
Frame store

Improved frame store management in all area-scan firmware variants:

●The effective FIFO capacity is now independent of the image (or ROI) size.
●The sustainable data rate is now independent of the image (or ROI) line size

These improvements mainly benefit to applications using small ROIs.
GenICam Browser
Feature Name Feature Description
Ribbon panel

The usability is improved with a ribbon-like panel containing a set of icons and settings.
Favorites Added a tab for favorite features.
ROI display

Improved image display to support ROI's.

ROI's are displayed at the position offset defined in the image header.

Feature hiding Hide features of "not implemented" categories
Bootstrap registers Improved formatting of bootstrap registers
View control Added view window size persistence
EGrabber API
Feature Name Feature Description
Bus-addressable buffer Added a new set of announceAndQueue methods to EGrabber classes to harmonize the way to announce and queue buffers of different types:
●GenTLMemory: Memory allocated by the GenTL producer
●UserMemory: Memory allocated by the user
●BusMemory: Bus addressable memory
●UserMemoryArray: User memory split into an array of contiguous buffers
Sample programs

Added "line-scan-array" sample program to demonstrate the use of UserMemoryArray with announceAndQueue.

Added "amdDirectGMA" sample program to demonstrate the use of BusMemory with announceAndQueue.

 

Coaxlink 4.5

GenICam Browser
Feature Name Feature Description
Save Image As

Added the possibility to save a copy the displayed image to disk through a right-click button action. Available file formats: BMP, TIFF, PNG, and JPEG.

NOTE The GenICam Browser performs, when necessary, a pixel format conversion to RGB8 to display the image correctly.
I/O Toolbox
Feature Name Feature Description
Quadrature Decoder Tool

Added the Quadrature Decoder tool type to the I/O Toolbox.

A Quadrature Decoder tool, abridged as QDC, is capable of decoding the A/B outputs of a phase-quadrature motion encoder device. It can be sourced by selected pairs of GPIO input lines: It delivers 1, 2, or 4 events every A/B cycle, possibly filtered by the backward motion compensator. The tool implements also a 32-bit position counter and a direction status flag.
Divider Tool

Added the Divider tool type to the I/O Toolbox.

A Divider tool, abridged as DIV, is capable of dividing the rate of incoming events by any integer factor ranging from 1 to 1023. Unlike the MDV tool, the DIV tool delivers the output event with a constant (and negligible) phase delay. It can be sourced by any I/O toolbox event stream.
Delay Tool

Added the Delay tool type to the I/O Toolbox.

A Delay tool, abridged as DEL, is capable of delaying the events of 1 or 2 event streams by a configurable amount of time ticks or encoder ticks ranging from 1 to 16,777,215. Each input can be sourced by any I/O toolbox event stream. The clock source can be:

●Any one of the three time base: 8ns, 200ns, and 1µs for implementing a time delay.
●Any one of the QDC tool output stream for implementing a position offset.

The delay tool is retriggerable: it can manage up to 16 events in the pipe-line.
Toolbox Composition The composition of the I/O Toolbox has been updated and depends on the product/firmware combinations:
●For all 1-camera and 1-line-scan firmware variants on all products: 8 LIN, 1 QDC, 1 DIV, 1 MDV, 2 DEL.
●For the 2-camera and 2-line-scab firmware variants on Coaxlink Quad G3: 8 LIN, 2 QDC, 2 DIV, 2 MDV, 2 DEL.
●For the 2-camera firmware variant on Coaxlink Duo and Coaxlink Quad: 8 LIN, 1 QDC, 1 DIV.
●For the 4-camera firmware variant on Coaxlink Quad G3: 8 LIN.
GenTL
Feature Name Feature Description
Bus-addressable buffer Added EuresysDSAnnounceBusBuffer function which creates a GenTL buffer for a bus-addressable buffer (i.e., a buffer already mapped at a particular address on the PCIe bus)
Image save to disk Added ImageSaveToDisk to coaxlink.cti
EGrabber API
Feature Name Feature Description
Bus-addressable buffer Added announceBusBuffer function.
Image save to disk

Added saveToDisk: function. Available file formats: BMP, TIFF, PNG, and JPEG.

NOTE The function performs, when necessary, a pixel format conversion. For instance:
●Bayer CFA pixel data are converted to RGB8
●Monochrome > 8-bit pixel data are converted to 8-bit when saved in the BMP file format
●Monochrome > 8-bit pixel data are converted to 16-bit when saved in the TIFF file format
Software Helpers – Image Conversion Functions
Feature Name Feature Description
Image save to disk Added saveToDisk to RGBConverter
gentl Tool
Feature Name Feature Description
JPEG format Added "jpeg" format
Camera and Illumination Controller
Feature Name Feature Description
Exposure time The exposure time range is extended: 3.36 up to 562,949,953,421 µs(> 150 hours)
Strobe delay The strobe delay range is extended: -8,589,934.5 up to 8,589,934.5 µs
Strobe duration The strobe duration range is extended: 0 up to 562,949,953,421 µs. (> 150 hours)
Cycle Trigger

Added missing I/O Toolbox events to trigger source features: Any I/O Toolbox event can be used as cycle trigger.
Line-scan Acquisition Control
Feature Name Feature Description
Start-of-scan Trigger

Added missing I/O Toolbox events to trigger source features: Any I/O Toolbox event can be used as Start-of-scan trigger.
End-of-scan Trigger

Added missing I/O Toolbox events to trigger source features:Any I/O Toolbox event can be used as End-of-scan trigger.

 

Coaxlink 4.4.2

EGrabber API
Feature Name Feature Description
.NET Added EGrabber .NET classes
Sample Programs Added egrabber C# sample using the EGrabber interface
Partial EGrabber objects Added partial EGrabber objects (e.g., a grabber with only the interface handle, or a grabber with the interface and device handles but without the datastream) can be created by calling the constructor with interfaceIndex, deviceIndex, or dataStreamIndex set to -1
GenTL
Feature Name Feature Description
Custom Buffer Info Added:
●BUFFER_INFO_CUSTOM_CXP_STREAMID (CoaXPress Header StreamID)
●BUFFER_INFO_CUSTOM_CXP_TAPG (CoaXPress Header TapG)
●BUFFER_INFO_CUSTOM_CXP_FLAGS (CoaXPress Header Flags)
GenApi DataStream Module
Feature Name Feature Description
Stream Reset Added StreamReset GenApi command
GenApi Device Module
Feature Name Feature Description
CoaXPress Category Added CoaXPress GenApi category to device module, with the following new features: CxpTriggerMessageFormat, CxpTriggerAckTimeout, and CxpTriggerMaxResendCount
CXP Trigger Format Added support of single message CoaXPress Trigger
CXP Trigger Ack Timeout Added the controllability of the CoaXPress Trigger Acknowledge timeout
CXP Trigger Resent Added the controllability of the CoaXPress Trigger Resent count
Image Acquisition
Feature Name Feature Description
Variable ROI Size Added support for variable ROI sizes
CoaXPress Host Connector Indicator LED States
Feature Name Feature Description
500 ms red pulses Added indication of "data transfer errors"
Fast red flash Added indication of "system error"

 

Coaxlink 4.3.1 – All firmware variants

EGrabber Application Programming Interface
Feature Name Feature Description
Methods Added resetBufferQueue method
Sample Programs Added "grabn-callbacks" and "events-st-all"
Documentation Improved documentation in header files and sample programs
GenICam Browser
Feature Name Feature Description
GenApi scripts Added the possibility to run Euresys GenApi scripts
Status bar Show frame rate, line rate and data rate in image window status bar
Operation logging Improved logging of operations performed
Configuration script Improved coaxlink://configurator script
Memento traces
Feature Name Feature Description
Camera Detection Decode new traces from FPGA ("Line-scan camera detected")
gentl.exe
Feature Name Feature Description
Report "report" command now gathers more information about Windows systems (msinfo32, power saving modes)

 

Coaxlink 4.3 – All firmware variants

Coaxlink Hardware Custom Event Signaling and Counting
Feature Name Feature Description
Event Sources

Large set of Coaxlink hardware event sources:

Interface Module event sources:

● All I/O Toolbox events
● CRC errors on each CoaXPress connector

Device Module event sources:

● CIC Camera Trigger output signal transition (rising and/or falling)
● CIC Strobe output signal transition (rising and/or falling)
● CIC Trigger input
● CIC internal events (AllowNextCycle, DiscardedTrigger, PendingTrigger)
● CoaXPress Host to Device Trigger message acknowledge
● CoaXPress Host to Device Trigger message resend

Data Stream Module event sources:

● Start of camera readout
● End of camera readout
● Start of scan
● End of scan
● Rejected Frame
● Rejected Scan

Notification control Event notification can be enabled/disabled for each event source
Time-stamp Every event is time-stamped with 1 microsecond accuracy using a system-wide unified time base (same as Memento)
Event Counters 32-bit event counter on each event source.
Counter Control Counters are individually readable and resettable through GenApi
Notification context

Every notification includes three user-configurable 32-bit context words. Possible context includes:

● Logical state of GPIO lines
● Count value of any event source belonging to the same branch of the GenTL hierarchy
Application Programming Interface
Feature Name Feature Description
ImageGetPixelFormat Added ImageGetPixelFormat function to coaxlink.cti
GenTL C++ class Added missing functions devGetInfo, dsGetInfo...
EGrabber C++ Class

Added EGrabber C++ Class (see include/EGrabber.h)

The EGrabber Class is a set of C++ header files providing an easy-to-use application programming interface for Coaxlink products.

Main objects:

● EGrabber
● GenTL
● SharedGenTL

Main methods:

● start, stop
● runScript
● memento
● Various event management methods

RGBConverter C++ class Added RGBConverter C++ class (see include/RGBConverter.h)
Custom Events Notification Added notification of custom events:
●EVENT_CUSTOM_IO_TOOLBOX for I/O Toolbox events
●EVENT_CUSTOM_CIC for Camera and Illumination Controller events
●EVENT_CUSTOM_DATASTREAM for data stream events
●EVENT_CUSTOM_CXP_INTERFACE for CoaXPress events
Custom Events Info Added custom info commands for custom events:
●EVENT_DATA_CUSTOM_TIMESTAMP
●EVENT_DATA_CUSTOM_CONTEXT_1
●EVENT_DATA_CUSTOM_CONTEXT_2
●EVENT_DATA_CUSTOM_CONTEXT_3
Custom Events Time Stamp Added BUFFER_INFO_CUSTOM_EVENT_TIMESTAMP to BUFFER_INFO_CUSTOM_CMD_LIST
Event Control Features Added EventControl GenApi features category to interface, device, and data stream modules: EventSelector, EventNotification, EventNotificationContext1,EventNotificationContext2, EventNotificationContext3, EventCount, EventCountReset
Euresys GenApi Script Added documentation (see scripts/doc)
gentl.exe
Feature Name Feature Description
event command Added "event" command to show event notifications
Sample Programs
Feature Name Feature Description
EGrabber collection Added new collection of EGrabber sample programs
Image Converters Use ImageConvert function to perform image conversions if required
Memento Traces
Feature Name Feature Description
Rejected frame error Decode new traces from FPGA ("Rejected frame" error)
FPGA traces Decode new "Received a CXP packet with unexpected tag" traces from FPGA
FPGA traces Improved "Received a CXP packet with unexpected tag" Memento traces to indicate the tag that was expected, the actual tag received, and the connector on which the packet was received (this also requires Memento 4.3)
General Features
Feature Name Feature Improvement Description
GenICam Browser Improved image buffer bandwidth on Coaxlink Quad G3

 

Version 4.2 – All firmware variants (unless otherwise specified)

CoaXPress Host Interface – CoaXPress Image Stream Pixel Format
Feature Name Feature Description
Bayer 10-bit to 16-bit 10-/12-/14-/16-bit Bayer pixel formats
RGB 10-bit to 16-bit 10-/12-/14-/16-bit RGB pixel formats
RGBA 10-bit to 16-bit 10-/12-/14-/16-bit RGBA pixel formats
CoaXPress Host Interface – Connections Mapping
Feature Name Feature Description
2D22 Connection Map

2-device, 1- or 2-connection camera connection map:

Data Stream Module – Pixel Processing Features
Feature Name Feature Description
Unpacking Mode Controls the unpacking of 10-bit, 12-bit, and 14-bit pixel components.

When unpacking 10-bit, 12-bit, and 14-bit pixel components to 16-bit, the significant pixel data can be aligned to the least significant bit LSB) or to the most significant bit (MSB).

The default alignment option is MSB (i.e., the same behavior as in prior releases).

The default value will be changed (to LSB) in Coaxlink 4.3.

Red / Blue Swap Controls the swapping of the first and the last components of 3-component RGB packed pixel data.

The default setting is "no swap".
Software Helpers – Image Conversion Functions
Feature Name Feature Description
Bayer to RGB conversion Converts:
●8-bit Bayer to 8-bit RGB or 8-bit BGR
●10-/12-/14-/16-bit Bayer to 16-bit RGB or 16-bit BGR

If depth reduction is required, another call to ImageConvert is required (either on the Bayer source or on the RGB/BGR result).
Bit depth reduction Converts:
●10-/12-/14-/16-bit Monochrome to 8-bit Monochrome
●10-/12-/14-/16-bit Bayer to 8-bit Bayer
●10-/12-/14-/16-bit LMN to 8-bit LMN
●10-/12-/14-/16-bit LMNO to 8-bit LMNO

LMN = {RGB, BGR}; LMNO = {RGBa, aBGR, BGRa}
LMN to NML component swap Converts:
●8-bit LMN to 8-bit NML
●10-bit LMN to 10-bit NML or 8-bit NML
●12-bit LMN to 12-bit NML or 8-bit NML
●14-bit LMN to 14-bit NML or 8-bit NML
●16-bit LMN to 16-bit NML or 8-bit NML

Bit depth reduction can be performed at the same time

LMN = {RGB, BGR}
Copy Efficient image copy
Raw 1X_2YE line re-ordering Unscramble a raw 1X_2YE image by properly re-ordering the image lines.

Only useful for the Adimec Q-2A750 special 1X_2YE mode (all lines in one buffer)
GenICam Browser
Feature Name Feature Description
Adimec Q-2A750 unscrambling If the camera vendor is "Adimec" and the model contains "2A750" then the "Raw 1X_2YE line reordering process" is performed on the fly. This can be disabled via the contextual menu in the view window.
Performance Improved GenICam Browser performance

Version 4.1 – Coaxlink firmware variant

CoaXPress Host Interface
Feature Name Feature Description
Rectangular Image with YSize = 0 Support of CoaXPress rectangular image data stream format having YSize = 0
Single stream (1X_1Y) Single stream
1D4 Connection Map 1-device, 1- or 2- or 4-connection camera
Image Acquisition
Feature Name Feature Description
Line-scan acquisition Image acquisition from line-scan cameras.
Acquisition Gating The acquisition gate opens and closes at line boundaries according to the application DSStartAcquisition and DSStopAcquisition function calls and, according to the settings of the Image Acquisition Controller, to the Start-Of-Scan and the End-Of-Scan triggers.
Line Scan Acquisition Control The LineScanAcquisitionControl GenApi features category of the Data Stream module is dedicated to the control of line-scan acquisition.
Line-scan Acquisition Control – Start-of-scan Control
Feature Name Feature Description
Immediate Start Starts immediately after DSAcquistionStart() is called
Software Start Starts on execution of StartScan GenICam command
Hardware Start

Starts on any of the following IO Toolbox event sources (or StartScan command):

● Any Line Input Tool: LIN1, LIN2, LIN3, LIN4
Line-scan Acquisition Control – End-of-scan Control
Feature Name Feature Description
Automatic Stop Stops after having acquired ScanLength lines.
Software Stop Starts on execution of StopScan GenICam command
Hardware Stop Stops on any of the following IO Toolbox event sources (or StopScan command):
●Any Line Input Tool: LIN1, LIN2, LIN3, LIN4
Camera Control – Start Cycle Trigger
Feature Name Feature Description
Immediate Starts immediately after DSStartAcquisition() is called and then repeatedly every CycleMinimumPeriod period.
Software On execution of the StartCycle command
Hardware Starts on any of the following IO Toolbox event sources (or StartCycle command):
●Any Line Input Tool: LIN1, LIN2, LIN3, LIN4
●The Multiplier/Divider Tool: MDV1
I/O Toolbox
Feature Name Feature Description
Multiplier/Divider Tool The MDV tool is capable of converting upwards or downwards the rate of incoming events by any Rate Conversion Ratio ranging from 1.0E-3 up to 1.0E3.

The MDV can be sourced by any Line Input Tool: LIN1, LIN2, LIN3, LIN4

The MDV tool is typically used for generating camera cycle triggers from trigger events delivered by a motion encoder.
Toolbox Composition 4 Line Input Tools, 1 Multiplier/Divider Tool

 

Version 4.1 – All Coaxlink firmware variants

CoaXPress Host Interface – Power over CoaXPress Features
Feature Name Feature Description
Output I/V indicators Reporting of the output voltage and the output current of each connection through GenApi features: CxpPoCxpCurrent and CxpPoCxpVoltage
CoaXPress Host Interface – Connection test
Feature Name Feature Description
Host to Device Connection Test Capable of performing the "Host to Device Connection Test" procedure defined in section 8.7 of the CoaXPress 1.1 standard.
Device to Host Connection Test Capable of performing the "Device to Host Connection Test" procedure defined in section 8.7 of the CoaXPress 1.1 standard.
Image Acquisition – Stream Statistics
Feature Name Feature Description
Stream Statistics Reporting of the average frame rate (area-scan) or line rate (line-scan) and data rate at the level of the PCI Express interface.
StreamStatistics Category GenApi features category of the Data Stream module dedicated to the stream statistics.
I/O Toolbox
Feature Name Feature Description
Common Tool Set 4 Line Input Tools are available in all Firmware variants
Miscellaneous Features
Feature Name Feature Description
Auxiliary 12 V status Reporting of the availability of a valid 12 V on the auxiliary power distribution network
gentl.exe
Feature Name Feature Description
script command  
--setup option New option added to view, play and grab commands

 

Version 4.0

General Features
Feature Name Feature Description
Time base accuracy The hardware timers of the Coaxlink card are now using a more accurate time base. This leads to a significant improvement of the time accuracy for the Camera and Illumination Controller signals:
●Camera Trigger (period and pulse width)
●Strobe (duration and delay)
GenICam Browser Features
Feature Name Feature Description
Zoom control Capability of controlling the zoom factor of the displayed image
CoaXPress Host Interface – Host to Device Trigger Features
Feature Name Feature Description
Latency compensation Trigger messages includes the delay information enabling the Device to compensate the variable trigger latency.
PCI Interface – PCI Express Gen 3 x 4 Features
Feature Name Feature Description
Image data output rate Up to 3,200 Megabytes/sec effective image data transfer rate to Host PC memory
Link speed Support of PCIe Gen 2 (5.0 GT/s) and PCIe Gen 3 (8.0 GT/s) link speeds
Miscellaneous Features
Feature Name Feature Description
FPGA temperature Reporting of the FPGA temperature
Fan status Reporting of the fan rotation status

 

Version 3.2

CoaXPress Host Interface Features
Feature Name Feature Description
2-camera Capability of connecting 2 cameras having 1 connection on 1631 Coaxlink Duo
Camera Control and Illumination Control Features
Feature Name Feature Description
Camera cycle triggering Capability of triggering camera cycles using software commands or I/O Toolbox events
C2C-Link Capability of synchronizing multiples devices attached to one or more Coaxlink cards belonging to the same PC.
GPIO Features
Feature Name Feature Description
Polarity control Capability to select the polarity of all I/O ports
Glitch-removal filter Configurable glitch-removal filter on all input-capable I/O ports
Direction control Configurable direction on TTLIO GPIO ports
Driver control Configurable output driver on TTLIO GPIO ports (TTL, open-emitter, open-collector)
Global port state readout Capability to read the state of all ports in a single operation
Line source selection Any output-capable GPIO port can be sourced by:
●Any bit of the user output register
●The strobe output of the CIC
●The camera trigger output of the CIC
I/O Toolbox Features
Feature Name Feature Description
LINE Tool Capability of detecting transitions on any input-capable GPIO line
Firmware Manager tool
Feature Name Feature Description
Install Command Add install command to upload a different firmware variant.