Runtime Software Version 5.6. Release Notes

Transcription

1 Runtime Software Version 5.6 Release Notes

2 Contents 1 Release Notes Runtime New Features Changes and Bug Fixes Available Patches Compatibility with Firmware and Driver Versions Compatible Firmware Compatible Frame Grabber Device Driver Versions Compatibility with Applet Set Versions Included Components Supported Frame Grabbers Supported Operating Systems on Host PC 32 2 Known Issues Runtime Release Version SiliconSoftware Release Notes Runtime Software

3 1 Release Notes Runtime 5.6 This document provides the release notes for the Silicon Software runtime software version 5.6 for Windows and Linux. In the following sections, new features, changes, and compatibility information is provided. 1.1 New Features New Frame Grabber Boards me5 marathon VCLx marathon VCLx is a fully programmable Camera Link frame grabber fit for especially complex image processing as well as deep learning applications based on CNN (Convolutional Neuronal Networks). marathon VCLx is equipped with an extremely powerful FPGA, thus providing extended FPGA ressources. marathon VCLx provides 2 camera ports supporting the Camera Link standard in version 2.0 (Base, Medium, Full, and Full Deca 80 bit configuration). marathon VCLx comes with a free set of standard acquisition applets (version 1.0). You can design custom applets for marathon VCLx in VisualApplets (version: 3.1 or higher), using platform settings and platform library marathon VCLx. SiliconSoftware Release Notes Runtime Software

4 LightBridge 2 ACL LightBridge 2 ACL is a new stand-alone Camera Link frame grabber and the A-Series counterpart of LightBridge 2 VCL. LightBridge 2 ACL links the frame grabber to the host PC via Thunderbolt 2 technology 12. LightBridge 2 ACL provides 2 camera ports supporting the Camera Link standard in version 2.0 (Base, Medium, Full, and Full Deca 80 bit configuration). LightBridge 2 ACL comes with a free set of standard acquisition applets (version 2.1). The applets included in this set offer the same features as the applets in the applet set available for me5 marathon ACL. me5 maraton ACX-DP me5 marathon ACX-DP is a CoaXPress frame grabber. me5 marathon ACX-DP provides 2 camera ports (CXP DIN connectors) supporting the CoaXPress standard in version 1.1. me5 marathon ACX-DP comes with a free set of standard acquisition applets (version 1.0). me5 marathon ACX-DP supports connection to two CXP cameras via one link per camera as well as connection to one CXP camera via one or two links. me5 marathon ACX-SP me5 marathon ACX-SP is a CoaXPress frame grabber. me5 marathon ACX-SP provides 1 camera port (CXP DIN connector) supporting the CoaXPress standard in version 1.1. me5 marathon ACX-SP comes with a free set of standard acquisition applets (version 1.0). 1 Thunderbolt and the Thunderbolt logo are trademarks of Intel Corporation in the U.S. and/or other countries. 2 The Thunderbolt 2 certification of LightBridge 2 VCL is in progress. SiliconSoftware Release Notes Runtime Software

5 Log Message System The Log Message System of the Silicon Software Runtime software has been extended. It contains now about 1,000 log messages. The messages can be received directly in Software (e.g., for GUI programming), in the shell (e.g., for programming command-line applications), in log files, and in all other output channels supported by the Apache Logging Services project 1 (log4j and log4cxx, respectively). Update Feature You can check on new runtime versions via mouse click in microdiagnostics, or configure microdiagnostics to automatically check for newer runtime versions at each program start. Requirements for Windows: Internet connection. Requirements for Linux: Internet connection, installation of OpenSSL on host PC. Runtime Installer for Windows The runtime installer has been completely revised and re-structured. New features include Automatic Update Check: During installation, the installer checks if a newer installer version is already available; on user agreement, the newer version is downloaded and installed. Requirements: Internet connection and SSL support of Windows installation on host PC. Pre-configured installation settings optimized for supporting a specific camera interface standard (Camera Link, CoaXPress, GigE Vision, or Camera Link HS). Clear arrangement of installable components in the "Select Components" section 1by the Apache Software Foundation SiliconSoftware Release Notes Runtime Software

6 3rd Party Interfaces Version 3 Release of Silicon Software Adapter to Cognex Vision Pro The Silicon Software Adapter to Cognex Vision Pro is now available in Version 3. The new version supports all frame grabbers available from Silicon Software, including microenable IV frame grabbers as well as microenable 5 marathon, microenable 5 ironman, and LightBridge frame grabbers. The Silicon Software Adapter to Cognex Vision Pro is now part of the Silicon Software runtime software package and (if selected) installed together with the runtime. Support of GPUDirect for Video Technology A new interface allows to access and control NVIDIA GPUDirect for Video technology 1 via the Silicon Software SDK 2. Either OpenGL (Open Graphics Library) or CUDA 3 can be used for access. The new interface is part of the Silicon Software runtime software package and (if selected) installed together with the runtime. Enabling PoCL - New Command Line Tool For enabling/disabling PoCL support on marathon and LightBride 2 Camera Link frame grabbers, the new command line tool me5boardsettings.exe is available (Silicon Software runtime software installation directory, sub-directory bin). While the tool can be used for all 1 NVIDIA GPUDirect for Video is tailored for systems that use an NVIDIA graphics processing unit (GPU). The technology allows to efficiently transfer video frames into NVIDIA GPU memory at low latencies. It gives you full control to stream video into the GPU at sub-frame transfer times. 2 on host PCs running a Windows Operating System 3 CUDA = Compute Unified Device Architecture, a parallel programming framework by NVIDIA. SiliconSoftware Release Notes Runtime Software

7 mentioned frame grabbers, it is especially helpful when running applets of applet set version 2.0 or higher on me5 marathon ACL, me5 marathon VCL, or LightBridge 2 VCL using runtime version 5.5. (or lower). GenICam Reference Implementation Version 3 The Silicon Software runtime now uses the GenICam GenApi reference implementation in version 3. Version 3 is a completely new implementation which is amongst other things said to be faster, more robust, and throwing more informative error messages. (6892) Applet Sets marathon ACL Applets (A Series) The following new applet set version is available: me5 marathon ACL: Version 2.1 New features: Line Acquisition Applets will now allow mapping of trigger signals to any digital outputs (on GPIO and Front GPIO) and camera trigger outputs (CC signals or CPX/CLHS camera trigger signals). Signal sources can be for example Exsync, Flash, GPIs, LVAL and FVAL. (In earlier versions, the signals were assigned to dedicated GPOs.) (7704) Line Acquisition Applets now include a statistics module to count signal edges and to measure periods. This can be used to monitor the trigger system, to detect encoder signals with jitter and to record lost trigger signals. (7704) The maximum image dimensions have been extended. A minimum image height =1 can be set for line applets now. (7827) SiliconSoftware Release Notes Runtime Software

8 The ROI step size for x is smaller now, allowing a finer definition of ROI. (7347) Changes and bug fixes: The Camera Link formats MEDIUM 10 bit RGB and 12 bit RGB are correctly interpreted now. (In earlier versions, color components green and blue had been swapped. Fixed.) (7477) The applets Acq_SingleFullLineBayer_RB_GG and Acq_SingleFullLineBayer_RG_GB now support the full camera bandwidth. (In earlier versions, the bandwidth was limited. Fixed.) (7940) Bayer pattern applets: If mirroring is activated, the Bayer pattern settings are adapted accordingly. (In earlier versions, you had to adapt the interpretation of a mirrored image. Fixed.) (8113) Acq_SingleFullLineBayer_RB_GG: Applet Acq_SingleFullLineBayer_RB_GG now uses correct color interpolation. (In earlier versions (2.0 or lower), colors red and blue were swapped in double sampling mode. Fixed.) If you used a previous version you will need to correct the Bayer pattern to the correct value. LightBridge 2 ACL Applets (A Series) LightBridge 2 ACL: 2.1 marathon VCL and LightBridge 2 VCL Applets (V Series) The following new applet set versions are available: me5 marathon VCL: Version 2.1 LightBridge 2 VCL: 2.1 (containing the same applets and features as the applet set for me5 marathon VCL) SiliconSoftware Release Notes Runtime Software

9 New features: Line AcquisitionApplets will now allow mapping of trigger signals to any digital outputs (on GPIO and Front GPIO) and camera trigger outputs (CC signals or CPX/CLHS camera trigger signals). Signal sources can be for example Exsync, Flash, GPIs, LVAL and FVAL. (In earlier versions, the signals were assigned to dedicated GPOs.) (7704) Line AcquisitionApplets now include a statistics module to count signal edges and to measure periods. This can be used to monitor the trigger system, to detect encoder signals with jitter and to record lost trigger signals. (7704) The maximum image dimensions have been extended. A minimum image height =1 can be set for line applets now. (7827) The ROI step size for x is smaller now, allowing a finer definition of ROI. (7347) Changes and bug fixes: The Camera Link formats MEDIUM 10 bit RGB and 12 bit RGB are correctly interpreted now. (In earlier versions, color components green and blue had been swapped. Fixed.) (7477) The applets Acq_SingleFullLineBayer_RB_GG and Acq_SingleFullLineBayer_RG_GB now support the full camera bandwidth. (In earlier versions, the bandwidth was limited. Fixed.) (7940) Bayer pattern applets: If mirroring is activated, the Bayer pattern settings are adapted accordingly. (In earlier versions, you had to adapt the interpretation of a mirrored image. Fixed.) (8113) SiliconSoftware Release Notes Runtime Software

10 Acq_SingleFullLineBayer_RB_GG: Applet Acq_SingleFullLineBayer_RB_GG now uses correct color interpolation. (In earlier versions (2.0 or lower), colors red and blue were swapped in double sampling mode. Fixed.) If you used a previous version you will need to correct the Bayer pattern to the correct value. marathon VCLx Applets (V Series) me 5 marathon VCLx: 1.0 CoaXPress marathon QP Applets (A Series and V Series) The following new applet set versions are available: me5 marathon ACX-QP: Version 1.5 me5 marathon VCX-QP: Version 1.2 New features: The applet sets now contain 10 new appets: quad-area applets (Bayer, Gray, and RGB): Acq_QuadCXP6x1AreaBayer Acq_QuadCXP6x1AreaGray Acq_QuadCXP6x1AreaRGB dual-area applets (Bayer, Gray, and RGB): Acq_DualCXP6x2AreaBayer Acq_DualCXP6x2AreaGray Acq_DualCXP6x2AreaRGB SiliconSoftware Release Notes Runtime Software

11 quad-line applets (Gray and RGB): Acq_QuadCXP6x1LineGray Acq_QuadCXP6x1LineRGB dual-line applets (Gray and RGB): Acq_DualCXP6x2LineGray Acq_DualCXP6x2LineRGB The number of links that connect a camera to me5 marathon ACX QP is flexible now: Single cam applets: All applets designed for use with one camera (Acq_Single...) now allow to use 1, 2, or 4 links for connecting the camera to the frame grabber. The maximum number of CXP links between camera and grabber is 4 links (CXPx4). 1 Two cam applets: All applets designed for use with two camera (Acq_Dual...) now allow to use 1 or 2 links for connecting a camera to the frame grabber. The maximum number of CXP links between camera and grabber is 2 links (CXPx2). 2 Applet name Max. number of cameras to be used with applet Allowed number of CXP links per camera to frame grabber Acq_SingleCXP6X4AreaBayer 1 1, 2, or 4 Acq_SingleCXP6X4AreaGray 1 1, 2, or 4 Acq_SingleCXP6X4AreaRGB 1 1, 2, or 4 Acq_SingleCXP6X4LineGray 1 1, 2, or 4 1 In earlier versions, with applets designed for use with one camera (Acq_Single...), four links between camera and frame grabber were obligatory. 2 In earlier versions, with applets designed for use with two cameras (Acq_Dual...), two links between one camera and frame grabber were obligatory. SiliconSoftware Release Notes Runtime Software

12 Applet name Max. number of cameras to be used with applet Allowed number of CXP links per camera to frame grabber Acq_SingleCXP6X4LineRGB 1 1, 2, or 4 Acq_DualCXP6x2AreaBayer 2 1 or 2 Acq_DualCXP6x2AreaGray 2 1 or 2 Acq_DualCXP6x2AreaRGB 2 1 or 2 Acq_DualCXP6x2LineGray 2 1 or 2 Acq_DualCXP6x2LineRGB 2 1 or 2 Line AcquisitionApplets will now allow mapping of trigger signals to any digital outputs (on GPIO and Front GPIO) and camera trigger outputs (CC signals or CPX/CLHS camera trigger signals). Signal sources can be for example Exsync, Flash, GPIs, LVAL and FVAL. (In earlier versions, the signals were assigned to dedicated GPOs.) (7704) Line AcquisitionApplets now include a statistics module to count signal edges and to measure periods. This can be used to monitor the trigger system, to detect encoder signals with jitter and to record lost trigger signals. (7704) The maximum image dimensions have been extended. A minimum image height =1 can be set for line applets now. (7827) The ROI step size for x is smaller now, allowing a finer definition of ROI. (7347) CoaXPress marathon DP and SP Applets (A Series) me5 marathon ACX-DP: Version 1.0 Version 1.0 is the first applet set released for this new frame grabber board. me5 marathon ACX-SP: Version 1.0 Version 1.0 is the first applet set released for this new frame grabber board. SiliconSoftware Release Notes Runtime Software

13 GigE Vision microenable IV Applets (A Series and V Series) microenable 4 AQ4-GE/GPoE: Version 2.5 microenable 4 VQ4-GE/GPoE: Version 2.5 New features: The maximum image dimensions have been extended to 8192 x 8192 pixels for the following LAG applets: Acq_DualGEx2AreaGray12 Acq_DualGEx2AreaBayer8 SiliconSoftware Release Notes Runtime Software

14 1.2 Changes and Bug Fixes Improved Error Reporting The error reports of all SDK libraries have been extended. The content of the error log messages has been formulated more accurately. Timestamp Accuracy under Linux The timestamp accuracy under Linux has been improved by using the new Linux kernel high resolution timer. The new accuracy achieves, depending on kernel configurations and CPU generation, up to 40 nanoseconds. (In earlier versions, the accuracy was between 0,5 to 4 ms depeding on kernel configurations. Fixed.) (4053) Fg_getLastPicNumberBlockingEx(): me5 marathon, ironman, and LightBridge When using SDK function Fg_getLastPicNumberBlockingEx() on me5 marathon, ironman, or LightBridge frame grabbers, long-time tests ended in timeouts. The likeliness of this behaviour had been reduced tremendously in RT release It has now been completely fixed. (6578) Improved Linux Compiler Support Using a recent compiler (gcc, clang) works stable now. (In earlier versions, using a recent compiler resulted in errors while loading applets (error number -51) or setting parameters (error number -2). Fixed.) (8102,8103) SDK Library siso_genicam Error Handling in SDK library siso_genicam has been improved. Saving Camera Array Parameters Function Sgc_SaveCameraParameters now also saves array values. (All array values are saved by iterating over all possible selector values and saving the selector value and all dependent values to file.) When the parameters file is loaded, all parameters of the array (selector and dependent values) are restored. (7158) SiliconSoftware Release Notes Runtime Software

15 SDK C# Wrapper and C# Example The stability of C# Wrapper and C# Example when using callbacks (APC, events, asynchronous notifications) has been improved. (In earlier versions, using callbacks did lead to a crash. Fixed.) (7976) Improved stability of SDK support library display_lib under Error Conditions If you try to display bigger frames than supported by the SDK support library display_lib (up to 2 GB), an according error message is thrown. (In earlier version, this could lead to a crash of the application. Fixed.) (5494) If you try to display 64-bit image formats, an according error message is thrown. (In earlier version, this could lead to a crash of the application. Fixed.) (7886) SDK Python Wrapper: Unification of Return Value Structure The structure of return values has been unified for all functions that have output parameters in the C API: The return value of these functions is a list now containing as first element the error code followed by the output values in the order of occurrence in the C API. For details, refer to the documentation of the Python Wrapper for the Silicon Software runtime. MCF File Handling Improvements MCF File contains Array Content: The entries of an array (i.e., field parameters) are saved now when saving an applet configuration to MCF file 1. Hereby the array values are saved into a separate *.mfs file (which is loaded when loading the MCF file) that has the same file name as the MCF file. This is very helpful when working with operators offering many parameters or parameter sets (like, for example, operator TapGeometrySorter), as configurations of field parameters can be saved now to / loaded from an *.mcf file. (6185) 1 An *.mcf file contains the applet configuration for one frame grabber board (including the configurations for all processes (acquisition channels) of the applet). SiliconSoftware Release Notes Runtime Software

16 When loading mcf files, resolving of parameter dependencies has been improved. (In earlier versions, in some cases error -1 was reported when values depending on other values were contained in the mcf file. Fixed.) (6699) Loading an *.mcf file for a *.dll applet file now also works when the applet has been renamed. (In earlier versions. after renaming an *.dll applet file, an according *.mcf file could be saved but not loaded again. Fixed.) (7084) MicroDisplay Improvements RGB images can be saved in BMP format without altering the image. (In earlier versions, when you saved an acquired RGB image in BMP format, directly after saving the image was rotated by 180. This was visible in the microdisplay display as well as in images saved via SDK support library iolibrt. Fixed.) (7085) When an applet contains parameter translation operators, the max. number of characters of an expression within the operator is no longer restricted for applets built with VisualApplets or higher. For applets built with VisualApplets older than 3.0.6, the max. number of characters has been extended to characters. (In earlier versions, expressions consisting of more than 4096 characters could lead to a crash of microdispay when the applet was loaded. Fixed.) (7449) Closing microdisplay after an applet has been loaded works smoothly now. (In earlier versions, this caused to appear a crash notification (always under Linux, sometimes under Windows). Fixed.) (7716) Loading applets on multiple frame grabbers in microdisplay works stable now. (In earlier versions, when more than one frame grabber were installed in the computer and multiple applets were loaded in microdisplay, under certain circumstances the application would quit unexpectedly when loading applets or pressing "Rescan Applets" button. Fixed. ) (7764) SiliconSoftware Release Notes Runtime Software

17 64-bit image formats are supported. (In earlier versions, under certain circumstances using 64-bit image formats caused microdisplay to crash. Fixed.) (7886) Runtime Installer Installation of selected items: The runtime installer has been completely revised. Only the items checked for installation are installed. (In earlier versions, more items than the selected ones were installed on the host PC. The installation thus needed more memory space than necessary. Fixed.) (7546) Environment variable GENICAM_GENTL{64,32}: During runtime installation, path variable GENICAM_GENTL32_PATH / GENICAM_ GENTL64_PATH is correctly concatenated to environment variable %sisodir5%/bin. 1 (In earlier versions, path variable GENICAM_GENTL{64,32}_PATH was overwritten during runtime installation so that all GenICam GenTL path information was lost. Fixed.) (6968) Marathon VCL/LightBridge VCL applet documentation: For all applets, the according applet documentation is installed. (In earlier versions, for two applets the marathon ACL/LightBridge ACL documentation was displayed. Fixed.) (7999) ClserComWrapper Improvements The frame grabber index number has no impact on the functionality of the ClSerCOM Wrapper. (In former versions, if you re-sorted the boards without assigning a board number 0 or if assigning board numbers with gaps between them, the ClSerCOM Wrapper did not 1 Path variable GENICAM_GENTL{64,32}_PATH holds a list of directories that contain GenTL producers. Each producer registers here via concatenating its own path. SiliconSoftware Release Notes Runtime Software

18 recognize some boards. Fixed.) (7075) After loading a new applet on a me5 frame grabber board (marathon, LightBridge, or ironman), the serial connection is successfully re-established again. (Loading a new applet is setting a new applet as active applet (in microdisplay, microdiagnostics, or using function Fg_ Init) or flashing the active partition.) (In earlier versions, the serial connection was reset. Fixed.) (7256) Improved CMake Support The CMake modules delivered with runtime 5.6 support current Microsoft Visual Studio versions. Adapter to Cognex VisionPro When acquisition was started on GigE Vision grabbers, function StartAcquisition() used a fix image size of 512x256. This has been corrected with Version 3 of the Silicon Software Cognex Adapter. (6856) microdiagnostics Improvements Improved User Interface: Selecting applets for flashing is now very quickly done. As an alternative to using the Load new applet button, you can now most easily Drag & Drop an applet file directly from the file explorer to a partition displayed in microdiagnostics Drag & Drop multiple applet files at once from the file explorer to specific adjacent partitions in microdiagnostics. (6851) Default path to Applets folders: When selecting applets for flashing, after clicking the Load new applet button the DLL folder of the latest runtime installation on the host PC opens. The default path now incorporates the %sisodir5% environment variable that always leads SiliconSoftware Release Notes Runtime Software

19 to the silicon software runtime installation directory that has been installed most recently. (In earlier versions, per default the path that had been used last time for selecting applets did open. Fixed.) (5704) When flashing a new firmware on microenable IV boards, the firmware events are no longer discarded. (In runtime versions 5.5.0, 5.5.1, and , when flashing a new firmware on these boards, the firmware events did no longer work. Fixed.) (7880) Standard Applet MediumLineGray16 for me4 AD4-Cl and me4 AD4-PoCL Starting image acquisition works correctly now in microdisplay as well as via SDK. (In older versions, starting image acquisition on me4 AD4 using this applet sometimes didn't work at the first try. Fixed.) (7080) Extended Documentation on Using Multiple Grabbers in one Host The individual frame grabber manuals now contain a specific section about using multiple frame grabbers in one host PC, dealing with aspects such as maximum number of frame grabbers and cameras, available bandwidth, API handling, and performance tests. You find the section in each marathon and LightBridge frame grabber manual, sections Appendix -> Additional Procedures -> Using Multiple Boards in one Host. SiliconSoftware Release Notes Runtime Software

20 1.3 Available Patches Silicon Software runtime software version 5.6 has been released in July Up to now, no patch for this runtime version has been released. SiliconSoftware Release Notes Runtime Software

21 1.4 Compatibility with Firmware and Driver Versions Compatible Firmware microenable 4: When you are using microenable 4 frame grabbers, you flash only the firmware onto the frame grabber and load the applet separately. To use latest functionality, make sure you use the latest runtime version together with the latest firmware version supported by the runtime. The following me4 firmware versions (and lower) are supported by runtime version 5.6: Frame Grabber Model Firmware Version me4 microenable 4 AS1-PoCL 1.0b (hex) microenable 4 AD1-CL/PoCL 7.92 (hex) microenable 4 AD1-mPoCL 7.92 (hex) microenable 4 VD1-CL 1.4d (hex) microenable 4 AD4-CL/PoCL 1.0d (hex) microenable 4 VD4-CL/PoCL 1.35 (hex) microenable 4 AQ4-GE/GPoE 1.37 (hex) microenable 4 VQ4-GE/GPoE 1.8b (hex) All listed microenable IV firmware is backward compatible to Runtime 5.1. SiliconSoftware Release Notes Runtime Software

22 microenable 5: When you are using microenable 5 frame grabbers, firmware and applet are both incorporated in the *.dll or *.hap file (= applet file) you flash onto your frame grabber. Make sure the runtime version you are using on the host PC supports the applet version you are using on the frame grabber 1. Otherwise, install the latest runtime software (that always supports the latest firmware versions and is downward compatible to older firmware versions). The following me5 firmware versions (and lower) are supported by runtime version 5.6: Frame Grabber Model me5 marathon Firmware Version microenable 5 marathon ACX-SP 1.2 microenable 5 marathon ACX-DP 1.2 microenable 5 marathon ACX-QP 3.3 microenable 5 marathon VCX-QP 1.2 microenable 5 marathon ACL 1.8 microenable 5 marathon VCL 1.7 microenable 5 marathon VCLx 1.0 LightBridge 2 ACL 1.8 LightBridge 2 VCL 1.7 microenable 5 marathon AF2 2.3 microenable 5 marathon VF2: 2.3 1The firmware version that is incorporated in the applet file (*.dll or *.hap file) needs to be supported by the runtime software version installed on your system. In general, it is enough to know which runtime software version supports a specific applet set version. SiliconSoftware Release Notes Runtime Software

23 Frame Grabber Model Firmware Version me5 ironman microenable 5 ironman AQ8-CXP6D 2.11 microenable 5 ironman AQ8-CXP6B 2.11 microenable 5 ironman VQ8-CXP6D 2.11 microenable 5 ironman VQ8-CXP6B 2.11 microenable 5 ironman AD8-PoCL 1.6 microenable 5 ironman VD8-PoCL 1.6 Listed microenable 5 firmware for ironman is backward compatible to Runtime Listed microenable 5 firmware for marathon and LightBridge is backward compatible to Runtime SiliconSoftware Release Notes Runtime Software

24 1.4.2 Compatible Frame Grabber Device Driver Versions microenable IV Windows 32bit: Version Windows 64bit: Version Linux 32 and 64 bit: microenable 5 Windows 32bit: Version Windows 64bit: Version Linux 32 and 64 bit: All listed microenable IV device driver versions are backward compatible to Runtime 5.2. All listed microenable 5 device driver versions are backward compatible to Runtime Matching Runtime, Firmware and Device Driver Versions Incompatibilities between a newer firmware version and an older Runtime Software version cannot be excluded. New features may require the newest firmware and device driver version. To use the newest firmware/applet set version, make sure you install the matching runtime version. We explicitly recommend to use a specific Runtime Software version only together with the corresponding (frame-grabber specific) firmware version/applet set version and device driver version. SiliconSoftware Release Notes Runtime Software

25 me4 Shipment Our me4 frame grabber products are generally shipped with the firmware version released together with the latest Runtime Software version (major release or service release). Nevertheless, during roll-out of a new Runtime Software version it may happen that due to production-technical reasons frame grabbers with the former firmware version are delivered. Exceptions are communicated via the Silicon Software Product Info channel. Special shipment agreements are not affected. Detailed information about the me4 frame grabber and firmware version regarding a certain shipment you find on the specific delivery note. SiliconSoftware Release Notes Runtime Software

26 1.5 Compatibility with Applet Set Versions The following frame grabber specific applet set versions (and lower) are supported by runtime version 5.6 at point of release: microenable 5: Frame Grabber Model Applet Set Version me5 marathon microenable 5 marathon ACX-SP 1.0 microenable 5 marathon ACX-DP 1.0 microenable 5 marathon ACX-QP 1.5 microenable 5 marathon VCX-QP 1.2 microenable 5 marathon ACL microenable 5 marathon VCL microenable 5 marathon VCLx 1.0 LightBridge 2 ACL 2.1 LightBridge 2 VCL If you want to use applets out of applet set version 2.0 or higher in a system using PoCL, you need to install runtime version or higher. 2If you want to use applets out of applet set version 2.0 or higher in a system using PoCL, you need to install runtime version or higher. 3If you want to use applets out of applet set version 2.0 or higher in a system using PoCL, you need to install runtime version or higher. SiliconSoftware Release Notes Runtime Software

27 Frame Grabber Model Applet Set Version microenable 5 marathon AF2 1.8 microenable 5 marathon VF2 custom applets only me5 ironman microenable 5 ironman AQ8-CXP6D 2.7 microenable 5 ironman VQ8-CXP6D 2.6 microenable 5 ironman AD8-PoCL 2.5 microenable 5 ironman VD8-PoCL 2.5 Discontinued applet sets: microenable 5 ironman VQ8-CXP6B microenable 5 ironman AQ8-CXP6B Last distributed applet set version: 2.5 (released together with runtime version 5.5). Last distributed applet set version: 2.5 (released together with runtime version 5.5). SiliconSoftware Release Notes Runtime Software

28 microenable IV: Frame Grabber Model Applet Set Version me4 microenable 4 AD4-CL/PoCL 2.4 microenable 4 VD4-CL/PoCL 2.4 microenable 4 AQ4-GE/GPoE 2.5 microenable 4 VQ4-GE/GPoE Included Components Runtime Software installation 5.6 includes: Acquisition Applets and Advanced Acquisition Applets for all Silicon Software frame grabbers (during installation, you can de-select the applet packages for frame grabbers you are not going to deploy) Software Development Kit (SDK) microdisplay (software tool for acquiring and displaying images and for configuring and monitoring the image acquisition process) microdiagnostics (software tool for frame grabber tests, software tests, performance tests, and for flashing the frame grabber with new applets and firmware) SiliconSoftware Release Notes Runtime Software

29 GenICam Explorer (software tool for controlling and configuring CXP, CLHS, and GigE Vision cameras) clshell (terminal program for Camera Link camera configuration) FirmwareFlasherCLI (command line version) me5boardsettings (terminal program for enabling/disabling Power over Camera Link (PoCL) support) New! Frame grabber device driver Silicon Software network service: "SiSo Generic Service" Microsoft Visual Studio 2005, 2008 (SP1) and 2010 Redistribution Packages (only Windows) Documentation Interface to NI LabView Interface to Cognex Vision Pro New! Interface to NVIDIA GPUDirect for Video technology New! SDK Examples (C++, C++11, C#, and Python) SDK Wrapper C# SDK Wrapper Pyhton SiliconSoftware Release Notes Runtime Software

30 1.7 Supported Frame Grabbers Runtime Version 5.6 supports all available Silicon Software frame grabbers: Camera Link: microenable 5 marathon ACL microenable 5 marathon VCL microenable 5 marathon VCLx New! LightBridge 2 ACL New! LightBridge 2 VCL microenable 5 ironman AD8-PoCL microenable 5 ironman VD8-PoCL microenable IV AD4-CL / -PoCL microenable IV VD4-CL / -PoCL microenable IV AD1-CL / -PoCL / -mpocl microenable IV VD1-CL microenable IV AS1 SiliconSoftware Release Notes Runtime Software

31 CoaXPress: microenable 5 marathon ACX-SP New! microenable 5 marathon ACX-DP New! microenable 5 marathon ACX-QP microenable 5 marathon VCX-QP microenable 5 ironman AQ8-CXP6D microenable 5 ironman VQ8-CXP6D microenable 5 ironman AQ8-CXP6B (discontinued) microenable 5 ironman VQ8-CXP6B (discontinued) Camera Link HS: microenable 5 marathon AF2 microenable 5 marathon VF2 GigE Vision: microenable IV AQ4-GE / -GPoE microenable IV VQ4-GE / -GPoE LVDS: microenable IV AD4-LVDS SiliconSoftware Release Notes Runtime Software

32 1.8 Supported Operating Systems on Host PC Windows: Windows 10 (32bit/64bit) officially certified as WIN 10 compatible Windows 8 (32bit/64bit) Windows 7 (with Security Advisory or higher) (32bit/64bit) Linux 1 : Ubuntu LTS (32bit/64bit) Red Hat Enterprise Linux 7.1 (32bit/64bit) Tested Kernel Versions under Linux Ubuntu: With Ubuntu LTS, the following kernel version has been tested: 4.15 Red Hat: With Red Hat Enterprise Linux 7.x, the following kernel version has been tested: 3.10 Runtime Version 5.6 supports all available Silicon Software frame grabbers. 1All other Linux distributions may require additional configuration work by the user and can be supported by Silicon Software only to a limited extent. SiliconSoftware Release Notes Runtime Software

33 2 Known Issues Runtime Release Version 5.6 Find Latest Version of Known Issues Documentation This document is part of the product documentation delivered with Silicon Software Runtime release 5.6. The latest version of our Known Issues documentation (containing information that might have come up after release of Runtime 5.6) you find in our live documentation: Known Issues Live 1. Under Windows 8 or higher, the option Fast Startup should be turned off. (Option Fast Startup is also known as hybrid boot or hybrid shutdown.) See section How to Turn off Window's Fast Startup. 2. Disabling energy safe mode for PCI Express: For safely running Silicon Software frame grabber applications it is strongly recommended to disable energy safe mode for PCI Express. Concerns Windows XP 32bit, Windows XP 64bit, Windows Vista 32bit, Windows Vista 64bit, Windows 7 32bit and Windows 7 64bit, Windows 8 32bit and Windows 8 64bit. See How to Disable Save Mode for PCIe. 3. Only runtime version 5.5 or higher, due to the new possibility to flash multiple partitions on microenable 5 marathon: Flashing and/or activating an applet on one microenable 5 frame grabber board will result in the following system behavior if the Siso Generic Service (gs) is used to manage camera connections: SiliconSoftware Release Notes Runtime Software

34 The Siso Generic Service (gs) is re-started for all boards in the host PC that use the service. Depending on the number of boards installed in the host, this may take some time. On the frame grabber that is flashed/on which a new applet is activated, the connection to the camera(s) is reset. The camera(s) need to be re-discovered. During restart of the Siso Generic Service (gs), all GUI applications (microdisplay, microdiagnostics, GenICam Explorer) will appear as "Not Responding". 4. Only one process can carry out Fg_Init at a time. If the function Fg_Init is called in multiple threads (for different frame grabber boards) simultaneously, and if the simultaneous calls result in simultaneous live reconfiguration of multiple frame grabber boards: Only one frame grabber board is reconfigured successfully. For all other boards, the error message FG_RECONFIGURATION_DISABLED is returned. However, despite this error message: Frame grabber live reconfiguration is still enabled. Please simply re-start the reconfiguration of the other frame grabber boards one after the other. In very rare cases, this behavior is also visible when working with microdiagnostics: If you reconfiguration of these frame grabber boards starts simultaneously. In this case, you will get the same error message. Please simply re-start the reconfiguration of the frame grabber boards one after the other. 5. Live Configuration of microenable 5 (marathon, ironman, and LightBridge) is not supported by all motherboards. 6. In the two LAGx2 applets Acq_DualGEx2AreaGray12 and Acq_DualGEx2AreaBayer8 (applet sets version 2.4 for me4 AQ4-GE/GPoE and VQ4-GE/GPoE) the support of action commands doesn't work correctly. (6323) SiliconSoftware Release Notes Runtime Software

35 7. The Camera Simulator Module in applet Acq_SingleCXP6x4AreaBayer is malfunctioning. 8. Firmware flashing on microenable 5: At the end of the flashing process on me5 frame grabbers, Runtime 5.4 activates a firmware write protection on the frame grabber. Attention: Older versions of the runtime software are not able to de-activate the firmware write protection during the flashing process. Thus, a frame grabber with activated firmware write protection cannot be re-flashed by an older runtime software (prior to version 5.4.). In this case, microdiagnostics displayes the error message Readback and bitstream don't match.. For resolving the situation, you have two options. Either flash the frame grabber again, this time using the latest version of the runtime, or de-activate the firmware write protection manually, using an additional tool. If you prefer this option, please contact Silicon Software directly. 9. The revised implementation of the DMA900 technology requires an activation of the "Turbo DMA mode" to achieve a maximum DMA transfer performance, when running on PC setups with maximum PCIe payload size of 128 Bytes. In case of doubts run microdiagnostics performance tests in order to get the system specific performance and adjust the Turbo DMA mode setting, accordingly. 10. Frame grabber products, running Advanced AcquisitionApplets: During start-up phase spikes can occur at the trigger outputs. 11. If the grabber is configured to check for DVAL camera signal (which is the default) but the camera does not send DVAL for the whole frame one line of data is still returned. The FullArea and FullLine applets correctly return empty frames (frames of length 0). SiliconSoftware Release Notes Runtime Software

36 12. When very short frames (at most 128 bytes) are transferred on an PCIe x4 frame grabber and the end of the transfer is 4, 8, or 12 bytes before any 128 byte boundary, an additional empty frame is marked as transferred. The frame data of the original frame remains intact. VA processing applets, e.g., applets using the blob operators, are very likely to show this behavior. If you see empty frames, the following example code might help you detect if they have been created because of the behavior described above. int isdmaframeskip(fg_struct *fg, dma_mem *membuf, int dmaport, int picnum) { size_t len; Fg_getParameterEx(fg, FG_TRANSFER_LEN, &len, dmaport, membuf, picnum); if (len!= 0) return 0; Fg_getParameterEx(fg, FG_TRANSFER_LEN, &len, dmaport, membuf, picnum - 1); if (len > 128) return 0; uintptr_t bufaddr = (uintptr_t)fg_getimageptrex(fg, picnum - 1, dmaport, membuf); if (((bufaddr + len) % 128) < 116) return 0; return 1; } 13. IMPORTANT ISSUE concerning operating systems Microsoft Windows 8 32bit/64bit, Microsoft Windows 7 32bit/64bit, Microsoft Windows Vista 32bit/64bit and Microsoft Windows XP 64bit/32bit: Runtime usage stand-alone: No known issues Runtime usage with VisualApplets: It is recommended to choose the user folder (or any other folder with full access rights) as installation folder. At least the folder "hardware applets" needs to have full access rights. 14. When using the Applets for GigE Vision Link Aggregation: The DMA transfer of a certain frame terminates at the next received frame from the camera or when an adjustable timeout occurs. The effect can be seen especially, when the camera acquisition is stopped. SiliconSoftware Release Notes Runtime Software

37 To speed up the point of time of transfer, the timeout therefore can be adjusted. 15. When using older hardware revisions of microenable IV VD4-CL boards (revisions < 2.1 ) in combination with PixelPlant200e errors might occur, even when using the newer firmware. Please contact our support team in such cases. 16. Board detection problems, microenable IV VD1-CL only: Due to a defect within the Phy chip which is built-in into microenable IV VD1-CL, in some computer systems problems with the board dectection of microenable IV VD1-CL may occur. Solution: Deactivation of the Power Save Modi in the Bios of the computer. 17. Sporadically occurring reporting error, all microenable IV frame grabbers with Camera Link Full configuration applets: SDK reports an image size of 0 byte if the image size is = 4 Byte. 18. microenable 5 ironman: Frame grabber is not recognized by microdiagnostics (and Windows Device Manager) when a defective applet has been flashed onto the frame grabber, or when the flashing process has been interrupted. To be fixed by Silicon Software Support. Affected microenable 5 ironman frame grabbers: me5 AD8-PoCL, me5 VD8- PoCL, me5 AQ8-CXP6D, me5vq8-cxp6d, me5aq8-cxp6b, me5aq8-cxp6b. This issue has been addressed in the design of microenable 5 marathon frame grabbers. 19. Camera Simulator: The usage of an applet s internal Camera Simulator may show a lower bandwidth than expected. This does mean that certain overflow conditions may occur when the current simulator is used. When a real camera is used, this behavior doesn't show. The issue is only related to the internal Camera Simulator. It will be solved in the next service release. 20. LightBridge Pre-Production and marathon boards: Flashing may result in the failure message "Readback and bitstream don't match". This happens with the probability of around 1 per flashing times. When this message occurs, simply flashing the board again solves the problem. The same underlying problem may occur (with a probability of 1 per 1.6 billion SiliconSoftware Release Notes Runtime Software

38 times) when activating a partition in microdiagnostics (or using Fg_Init). If partition activation in microdiagnostics normally works fine and you get a message "Please powercycle the computer" after activating a partition, please try again. When the problem occurs when you are activating via Fg_Init, the function returns NULL and function Fg_getLastErrorNumber returns FG_DEVICE_IO_ERROR. Please try again. 21. Line applets for me5 marathon ACL, me5 marathon VCL, and LightBridge VCL: The software trigger cannot be selected via parameter FG_IMGTRIGGERINSRC. (6483) 22. Line trigger module in Line Scan Acquisition Applets for marathon ACL / marathon VCL / LightBridge VCL: The applets show unwanted dependencies between parameters FG_ LINETRIGGERDELAY, FG_LINETRIGGERPERIODE, and FG_LINEEXPOSURE. (6567) 23. Area trigger module in Area Scan Acquisition Applets for marathon ACL / marathon VCL / LightBridge VCL: Parameters FG_TRIGGER_PULSEFORMGEN0_DELAY to FG_TRIGGER_ PULSEFORMGEN3_DELAY do sometimes not accept new values. The actual value range for these parameters is smaller than the stated range of [0, 3.4e+07]. The according slider in microdisplay doesn't work correctly. Workaround for parameter configuration: If you reload the applet in microdisplay (menu File-> Load Applet), parameters FG_TRIGGER_ PULSEFORMGEN0_DELAY to FG_TRIGGER_PULSEFORMGEN3_DELAY are configurable again. (6568) 24. Area trigger module in Area Scan Acquisition Applets for marathon ACL / marathon VCL / LightBridge VCL: The actual value range for parameter FG_TRIGGERFRAMESPERSECOND is smaller than the stated range of [ ,1.25e+07]. 25. Tap geometry mode 5X2 in marathon and LightBridge Camera Link applets: Tap Geometry mode 5X2 might not work correct for some sensor widths. Requirements 1020, 4090, 8190, work as expected. (7217) SiliconSoftware Release Notes Runtime Software

39 26. When using the SDK library display_lib under Windows, to display images with high frame rates (about frames per second) may lead to slow reaction times to user input (keyboard and mouse) of the host PC. 27. Some CXP cameras are not fully supported by the Silicon Software runtime discovery (for example Adimec Q-12A180 series or Miktrotron MC408X series). Some camera models will be connected using a single link only and cannot be configured to use more than one link. (7974) Under certain rare circumstances the discovery fails to detect some camera models. (7257) 28. The current Silicon Software driver for Linux does not work with some Linux distributions (for example Debian 9). On host PCs using such distributions, boards plugged into the host will be detected by the driver, but cannot be accessed by the Silicon Software runtime software and user programs. To work around this issue, try booting the Linux operating system using the boot option iomem=relaxed, or recompile the kernel with configuration CONFIG_ IO_STRICT_DEVMEM set to NO. (7026) 29. Using secure boot (UEFI mode) with Linux requires driver signing. This is currently not supported by the Silicon Software driver out of the box. The user can self-sign the driver by creating their own signature and registering the signature with the UEFI subsystem. 30. Update check (update feature implemented since runtime release RT 5.6) results in error message "Unknown network error": Under Windows: To use the new feature, during runtime installation you need to agree that SSL files are downloaded automatically for update checks. If you get the message when trying to look for newer runtime versions, re-install the runtime and consent to SSL file download by clicking the according disclaimer. Under Linux: To use the update feature, make sure you install OpenSSL on your Linux System. Otherwise, you will receive the above message. SiliconSoftware Release Notes Runtime Software

40 31. Applet Acq_SingleFullLineBayer_RB_GG on microenable 5 ironman AD8-PoCL and microenable 5 ironman VD8-PoCL frame grabbers: Colours red and blue are swapped in double sampling mode. Until the fix of this issue (applet set version 2.6), you will need to correct the Bayer pattern accordingly. SiliconSoftware Release Notes Runtime Software

41 Contact Details Silicon Software GmbH Silicon Software Inc. (USA) Silicon Software America Inc. Steubenstrasse 46 1 Tara Boulevard, Suite St-Martin Blvd., Suite 500 D Mannheim, Germany Nashua, NH 03062, USA Laval, Qc., H7T0J3, Canada Phone: +49(0) Phone: Phone: Ext 101 Fax: +49(0) Fax: Fax: info@silicon.software info@silicon.software americas@silicon.software Web: Web: Web: Document Details Document Version: 1.0, Document Language: English (US), Last Change: July 2018 Disclaimer While every precaution has been taken in the preparation of this manual, Silicon Software GmbH assumes no responsibility for errors or omissions. Silicon Software GmbH reserves the right to change the specification of the product described within this manual and the manual itself at any time without notice and without obligation of Silicon Software GmbH to notify any person of such revisions or changes. Trademarks All trademarks and registered trademarks are the property of their respective owners. Copyright Note Copyright 2018 Silicon Software GmbH. All rights reserved. This document may not in whole or in part, be reproduced, transmitted, transcribed, stored in any electronic medium or machine readable form, or translated into any language or computer language without the prior written consent of Silicon Software GmbH. SiliconSoftware Release Notes Runtime Software