=========================================================================== Vimba for Windows 64 - Release Notes Version: 4.2.0 Date: October 2020 =========================================================================== -------------------------------- Components and Version Reference -------------------------------- Drivers ------ intek 1394 Bus Driver (FireDrv.sys) 2.9.0.7 Vimba GigE Filter Driver (psligvfilter.sys) 1.24.17 (except Windows 10) Vimba GigE Filter Driver (VimbaGigEFilter.sys) 2.5.5* (Windows 10 only) Vimba USB Driver (vimba_usb.sys, vimba_usb_x64.sys) 1.0.0 Vimba GenICam Transport Layer modules ------------------------------------- GigE Transport Layer (VimbaGigETL.cti) 1.8.0* USB Transport Layer (VimbaUSBTL.cti) 1.3.0* 1394 Transport Layer (Vimba1394TL.cti) 1.6.0 CL Config Transport Layer (VimbaCLConfigTL.cti) 1.2.0 APIs ---- Vimba C API (VimbaC.dll) 1.8.3* Vimba C++ API (VimbaCPP.dll) 1.8.2 Vimba .NET API (VimbaNET.dll) 1.8.3* Vimba Python API (VimbaPython.dll) 1.0.1* Image Transform Library (VimbaImageTransform.dll) 1.6.0 Adapters ------- Vimba Cognex Adapter (AdapterVimba32/64.dll) 1.1.6* Tools ----- Vimba Driver Installer (VimbaDriverInstaller.exe) 1.1.9 Vimba Viewer (VimbaViewer.exe) 2.4.0* Vimba Class Generator (VimbaClassGenerator.exe) 1.0.6 Vimba Firmware Updater (VimbaFirmwareUpdater.exe) 1.0.3 Vimba Firmware Updater Console (FWUpdaterConsole.exe) 1.0.1 Third-Party Libraries ---------- TinyXML 2.6.2 Qt 4.7.1 Qwt 6.1.3 libTIFF 4.0.7 OpenCV 3.0.0 * Changed in this release of Vimba --------------------- Hardware Requirements --------------------- PC or laptop with 1 GHz 64-bit x86 processor or better. Allied Vision IEEE 1394 cameras: A built-in IEEE 1394 interface or IEEE 1394 adapter (OHCI) card (one or more) for PCI or PCI Express bus or PC card or ExpressCard with IEEE 1394 port(s) is required. Remark: Testing has been performed on host controllers that are based on OHCI chip sets from Texas Instruments. The driver should run on host controllers that are based on OHCI chip sets from other vendors, too. However, if there are any problems please feel free to contact our Technical Software Support (see below). Allied Vision GigE cameras: A built-in Gigabit Ethernet network interface or Gigabit Ethernet network card (one or more) is required. Note for IP configuration: By default, IP Configuration Mode is set to DHCP. You can also select LLA (link-local address) if you connect just one camera. If multiple cameras are connected at the same time, we recommend using DHCP or Persistent IP Address to enable discovery of all cameras. Allied Vision USB cameras: A built-in USB 3.0 controller for PCI Express bus is required. Remark: Testing has been performed on host controllers that are based on Intel chip sets and Renesas chip sets. The driver may run on host controllers that are based on chip sets from other vendors, too. Nevertheless for best performance we highly recommend Intel chip sets. However, if there are any problems please feel free to contact our Technical Software Support (see below). Allied Vision Camera Link (Goldeye CL) cameras: Please read the document "Usage of Frame grabbers with Goldeye CL Cameras" https://www.alliedvision.com/en/support/technical-documentation/goldeye-gcl-documentation --------------------------- Supported Operating Systems --------------------------- Vimba is designed for the 64-bit operating systems: Windows 7 Windows 10 Windows 10 (tested with versions 1809, 1903 and Windows 10 Pro version 1709) ------------ Installation ------------ Please refer to section "Correlations with other Allied Vision Software Packages" further down in this file if you plan to use other Allied Vision software packages in parallel with Vimba. To install Vimba, simply run the setup by starting the Vimba.exe and follow the instructions shown on the screen. For the installation of Vimba, .NET Framework 2.0 SP2, .NET Framework 3.5 SP1, or .NET Framework 4.x is required. Windows drivers are signed with sha256 due to Microsoft requirements. To use the drivers on Windows 7, install "Security Update for Windows 7 KB3033929" ------------ Known Issues ------------ Setup: - During installation, Vimba setup configures some environment variables that are - among others - used when compiling the examples. In order to use the new environment variables, it might be necessary to restart Microsoft Visual Studio, log off, or even restart the operating system. - When modifying Vimba installation through the setup, it is not possible to change the examples installation folder, even if examples have not been installed before. Please make sure to set the examples installation folder during the first time installation. GigE Filter Driver: - Disabling the Vimba GigE Filter Driver while it is in use might lead to unexpected behavior up to blue screen. - Using other filter drivers additionally to Vimba's GigE Filter Driver may cause issues. GigE Transport Layer: - A change of the available camera access modes cannot be reported for cameras in different subnets or with malconfigured IP addresses. These cameras can be accessed in configuration mode from different hosts simultaneously. Vimba 1394 Transport Layer: - The Vimba 1394 Transport Layer module supports most of the features implemented in Allied Vision's 1394 cameras. Please contact Allied Vision in case you require a feature that is currently not supported. Cognex Adapter: - Under Windows 8, Cognex has to be run as administrator in order to find the Vimba Cognex Adapter. Vimba Viewer: - When multiple opened GigE cameras are disconnected at the same time while no other camera stays connected to the very same NIC, the Vimba Viewer's camera windows stay open. --------------------------- Changes and release history --------------------------- Changes in Vimba 4.2.0: ----------------------- Vimba C - Standard-compliant ForceIP features instead of Allied Vision custom features, Updated VimbaC ForceIP example to use the standard-compliant ForceIP features Vimba .NET - Standard-compliant ForceIP features instead of Allied Vision custom features Vimba Python - Redirected the used Vimba version to the one delivered in this package. GigETL - Standard-compliant ForceIP features instead of Allied Vision custom features (see also Vimba C) - Prepared for use with extended IDs USBTL - Increased default MaxTransferSize value for better performance with current Linux versions - Improved camera detection on Linux systems (plugin event handling) Cognex Adapter - Bug fix: Acquisition timeout with multiple USB cameras - Vimba Cognex Manual: Added information about PoolSize value (change default value for high resolution images or for working with multiple cameras) Vimba Viewer - Added a dialog for enforcing IP settings to a GigE Vision camera Changes in Vimba 4.0.0: ----------------------- Vimba C - Bug fixes Vimba C++ - Bug fixes Vimba .NET - Bug fixes Vimba Python - New API GigETL - Improved resend handling - By default, packet resends are enabled - Other bug fixes USBTL - Improved visibility of USB camera status - Other bug fixes Vimba GigE Filter Driver - Bug fixes Vimba Viewer - Bug fixes Changes in Vimba 3.1.0: ----------------------- Vimba C - Updated for use with GenTL 1.5 Vimba C++ - Updated for use with GenTL 1.5 Vimba .NET - Updated for use with GenTL 1.5 - Bug fixes GigETL - GenTL 1.5 support USBTL - GenTL 1.5 support 1394TL - GenTL 1.5 support CLConfigTL - GenTL 1.5 support Vimba Viewer - Bug fixes Changes in Vimba 3.0.0: ----------------------- Vimba C - Bug fixes - Fix for blue screen during handling of changing camera lists Vimba C++ - Bug fixes - Changes in used components Vimba .NET - Changes in used components Vimba Viewer - Supports Alvium USB cameras - Fixed handling of float increments - Fixed occasional crashes with high frame rates - Several minor bug fixes GigETL - Bug fixes - Changes in used components USBTL - Bug fixes 1394 - New version of intek 1394 Bus Driver - Fixed: OpenCapture returns 1005 FCE_MISSINGBUFFERS Vimba GigE Filter Driver - Windows 10: Improved compatibility and performance with third-party filter drivers. Installer and drivers - New certificates for installer and drivers (Windows 7, Windows 8, and Windows 8.1) Changes in Vimba 2.1.3: ----------------------- Vimba C - Added ActionCommands programming example - Vimba C Manual: Updated documentation of Action Commands - Prepared the API for use with GenTL 1.5 - Bug fixes Vimba C++ - Added ActionCommands programming example - Vimba CPP Manual: Updated documentation of Action Commands - Prepared the underlying C API for use with GenTL 1.5 - Vimba CPP Manual: Added chapter Asynchronous image acquisition - overview - Bug fixes Vimba .NET - Added ActionCommands programming example - Vimba .NET Manual: Updated documentation of Action Commands - Prepared the underlying C API for use with GenTL 1.5 Vimba Viewer - New plugin architecture Vimba Driver Installer - Bug fixes Vimba Setup - Removed Vimba Class Generator desktop symbol Vimba Firmware Updater - Bug fixes Vimba Manual - Integrated Vimba Features Manual, minor changes Changes in Vimba 2.1: --------------------- Vimba Setup - Vimba Viewer and Vimba Firmware Updater 64-bit support on Windows and Linux/ARMv8 systems. - Updated documentation Vimba C - Added functionality for Action Commands - Bug fixes Vimba C++ - Added functionality for Action Commands - Bug fixes Vimba.NET - Added functionality for Action Commands Vimba Image Transform Library - Support for conversion from 10-bit raw source formats to 16 bit color target formats. - Support for conversion from 12-bit raw source formats to 16 bit color target formats. - Support for conversion from 14-bit raw source formats to 16 bit color target formats. - Support for conversion from 10-bit mono source formats to 16 bit mono target formats. - Support for conversion from 12-bit mono source formats to 16 bit mono target formats. - Support for conversion from 14-bit mono source formats to 16 bit mono target formats. Vimba Viewer - Allows now saving of 12-bit and 16-bit images (12-bit images are saved in 16-bit containers). - Added functionality for Action Commands. - Camera list shows now the IP address of each device. - Bug fixes Drivers - New driver signing according to new Microsoft EV signing requirements. GigE Transport Layer - Reworked and improved filter driver for Windows 10 - Added functionality for Action Commands. - Now the parameter BUFFER_INFO_DELIVERED_IMAGEHEIGHT is filled correctly. - Bug fixes Changes in Vimba 2.0: --------------------- Vimba Setup - Support of CL Config Transport Layer - Added Vimba Viewer Guide document - Improved documents, new layout Vimba C - Added functionality of loading and saving camera settings from / to XML - Bug fixes Vimba C++ - Added functionality of loading and saving camera settings from / to XML - Bug fixes Vimba.NET - Added functionality of loading and saving camera settings from / to XML Vimba Image Transform Library - Support for conversion from BayerXX10,12 formats to 2 byte output formats (RGB[A], BGR[A]) - Added interface functions VmbSetImageInfoFromInputParameters and VmbSetImageInfoFromInputImage Vimba Viewer - Enabled making use of load / save settings functionality - Added tabsheet widgets for Brightness, ROI, Autofunction ROI, Trigger IO, Color - Bug fixes Vimba Driver Installer - Included handling for Windows 10 filter driver - Improved Windows 8 compatibility - Bug fixes USB Transport Layer - Minor bug fixes - Driver signing changed to sha256 GigE Transport Layer - Reworked and improved filter driver for Windows 10 - Driver signing changed to sha256 1394 Transport Layer - Minor bug fixes - Driver signing changed to sha256 CL Config Transport Layer - Added Vimba Class Generator - Changes for CL support Vimba Cognex Adapter - Minor bug fixes Changes in Vimba 1.4.1: ----------------------- Vimba Setup - Support of USB Transport Layer - Fixed superfluous dependency of .Net2.0/3.5 runtime - Improved documents Vimba C - Extended camera support (e.g. float increments) - Stability improvements - Improved some examples - Bug fixes Vimba C++ - Extended camera support (e.g. float increments, needs Vimba C 1.4) - Improved error handling - Added and improved examples - Bug fixes Vimba.NET - Added automatic closing of lost cameras - Extended camera support (e.g. float increments) - Added support for PFNC 10p and 12p formats Vimba Image Transform Library - Added support for PFNC 10p and 12p formats - Improved the documentation Vimba Viewer - Added open camera by ID - Added endianness switch in direct register dialog - Many bug fixes Vimba Driver Installer - Added USB support GigE Transport Layer - Improved stability on high traffic networks - Bug fixes for multi-camera usage and incomplete cleanup - Fixed range of GevHeartbeatInterval and GevHeartbeatTimeout - TerminateProcess while using FilterDriver will not block 1394 Transport Layer - Fixed maximum of DeviceRegisterAddress - Omitted some unnecessary "pSelected" links for single-value selectors - Small changes Vimba Class Generator - Small improvements Vimba Cognex Adapter - Changes for USB support Changes in Vimba 1.3.0: ----------------------- Vimba Setup - Added a Vimba Tour document and a Vimba Quickstart Guide - Improved the other documents - Added examples for Vimba C, C++, and .NET - Added an OpenMP version of the Vimba Image Transform Library Vimba C 1.3.0 - Fixed feature access for ancillary data - Made device discovery blocking - Added system feature GeVDiscoveryAllDuration for adjustable waiting time - Fixed issues with mixed feature names - Bug-fixes for improving stability Vimba C++ 1.3.0 - Fixed feature access for ancillary data - Changes caused by bug fixes in Vimba C Vimba.NET 1.3.0 - Fixed feature access for ancillary data - Changes caused by bug fixes in Vimba C and Vimba C++ - Changed default conversion for Mono14 frame data to Mono8Indexed - Added console-based examples for asynchronous and synchronous grabbing - Fixed CameraFactory example for two or more cameras Vimba Image Transform Library 1.2.0 - Allowed more input for VmbSetImageInfoFromString - Corrected return codes - Removed transformations to Mono10/12/14 and big-endian data Vimba Viewer 1.1.3 - Improved handling for GigE camera list changes - Fixed issues around saving images - GUI usage improvements AVT Driver Installer 1.0.5 - Small bug-fixes GigE Transport Layer 1.3.1 - Fixed GenTL compliance: Changed the Device ID from the serial number to a MAC-based ID. This changes the way all APIs (C, C++ and .Net) identify the cameras - Added a document for GigE camera features - Changed the supported GenTL version to 1.3 (e.g. new feature categories BufferHandlingMode and StreamInformation) - Separate features for heartbeat timeout and heartbeat interval - Adjustable device discovery waiting time - Fixed issues with similar serial numbers - Fixed issues with many network interfaces 1394 Transport Layer 1.3.2 - Changed the supported GenTL version to 1.3 - Corrected value of LineStatus, allow AcquisitionStop at all times - Disabled caching of StreamAnnouncedBufferCount, other small fixes Vimba Class Generator 1.0.3 - Minor changes to appearance and documentation Vimba Cognex Adapter 1.0.3 - Fixed flickering under Windows XP - If ExposureAuto is set to 'Once' or 'Continuous', the exposure time from the settings tab is not written to the camera anymore. - Improved synchronization - Refined the documentation Changes in Vimba 1.2.1: ----------------------- Vimba Setup - On Windows XP systems that have an outdated list of trusted Certification Authorities and no internet connection it is no longer vital to update that list with the Microsoft patch from KB931125 Vimba C 1.2.1 - Converted the examples to pure C code - Small changes during parsing of the XML file Vimba C++ 1.2.1 - Added a few security checks - Small improvements around the end of capture Vimba.NET 1.2.1 - Changes in the documentation and in used components - Small improvements around the end of capture Vimba Viewer 1.1.2 - Only design changes Changes in Vimba 1.2.0: ----------------------- Vimba C 1.2.0 - Version 1.2.0 is only compatible to AVT GigE TL Version 1.2.0 onwards - Name independent search for AVT transport layers - Made EnumEntries' "pIsImplemented" condition equivalent to "pIsAvailable" to mimic the behavior of GenICam reference implementation Vimba C++ 1.2.0 - Fix for opening camera by IP address Vimba .NET 1.2.0 - Fix for 64bit version attempting to load 32bit transport layers - Fix for opening camera by IP address Vimba Viewer 1.1.1 - SFNC Features directly beneath the root category get listed - Many new pixel formats available for histogram support GigE Transport Layer 1.2.0 - Improved performance in case of many events - Restriction to eight cameras removed - Corrected Heartbeat feature - Fixed support for small packets 1394 Transport Layer 1.2.0 - Added features: FirmwareVerMajor, FirmwareVerMinor, FirmwareVerBuild, ImageSize, AcquisitionAbort, AcquisitionFrameRateLimit and ExposureAutoAlg for compatibility with GigE cameras - Refined and corrected some tooltips and descriptions - Refined the documentation for categories (now available in PDF) Changes in Vimba 1.1.1: ----------------------- Vimba C 1.1.1 - Slight changes for Linux compatibility (also to some examples) - Fixed error during VmbStartup that appeared if AVT1394TL was installed but no 1394 hardware was present. - Removed additional camera events for AcquisitionStart, AcquisitionEnd, FrameTrigger, ExposureEnd, AcquisitionRecordTrigger, Line1RisingEdge, Line1FallingEdge, Line2RisingEdge, Line2FallingEdge, Line3RisingEdge, Line3FallingEdge, Line4RisingEdge, Line4FallingEdge, PtpSyncLocked, PtpSyncLost which did not work correctly in every case - Changed the feature documentation format to PDF - Extended the programming reference manual - Small bug fixes Vimba C++ 1.1.1 - Slight changes for Linux compatibility (also to some examples) - Extended the programming reference manual - Small bug fixes Vimba .NET 1.1.1 - Renamed many parameters to improve readability - Bugfix: AcquireSingleImage and AcquireMultipleImages did not clean-up after a timeout - Bugfix: invisible features could not be accessed - Changed the feature documentation format to PDF - Small bug fixes Vimba Viewer 1.1 - Renamed from SampleViewer - Added an edit field to allow filtering the displayed features - Many stability bug fixes GigE Transport Layer 1.1 - Added feature DiscoveryBroadcastMode to the interface - Slight changes for Linux compatibility - Changed the documentation format to PDF 1394 Transport Layer 1.1 - Added features: SensorTaps, SensorDigitizationTaps, DeviceStatusLight, SmearReductionEnable, ExposureAutoTarget and GainAutoTarget - Renamed category ShadingControl to ImageQualityControl, moved SensorBits to category ImageFormatControl - Refined some tooltips and descriptions - Extended the documentation for categories (now available in PDF) - Bugfix: Commands UserSetLoad and UsetSetSave were switched - Bugfix: Oscar cameras were always ignored by the AVT1394TL Changes in Vimba 1.0.1: ----------------------- Vimba setup - Setup showed error during driver installation when maximum number of network filter drivers was reached. - Undefined error during driver installion under Windows XP. Sample Viewer 1.0.1 - Fixed issues when multicast is enabled. - Double-click needed to run a command feature. - Application crashed occasionally especially when selecting enum features. - Error handling added when the system does not have enough memory to allocate frame buffers - Histogram now supports BGR AVTDriverInstaller 1.0.1 - Fixed compatibility issues with some Bluetooth adapter and virtual machine software. GigE Transport Layer 1.0.1 - Updated AVTDriverInstaller. - Computer freezed or showed blue screens occasionally when streaming. 1394 Transport Layer 1.0.1 - Updated AVTDriverInstaller. ------------------------------------------------------- Correlations with other Allied Vision Software Packages ------------------------------------------------------- - AVT FirePackage If you plan to use the AVT FirePackage in parallel with Vimba, please make sure to install the AVT FirePackage v3.1 (or higher) first! Removing Vimba might break the AVT FirePackage installation. In that case you should start the AVT FirePackage installer again and click on "Repair". - AVT FirePackage64 If you already installed AVT FirePackage64, please uninstall it before installing Vimba. If you plan to use the AVT FirePackage for 64-bit operating systems please use AVT FirePackage v3.1 (or higher) which is designed for both, 32-bit and 64-bit operating systems. - AVT Universal Package The AVT Universal Package (v2.1) cannot be used in parallel with Vimba. However they can be installed on the same machine, but switching between the two packages requires to issue a "Repair". So if you want to switch to the AVT Universal Package you should start the AVT Universal Package installer and click on "Repair" and switching to Vimba requires to start Vimba installer and click on "Repair". Removing Vimba might break the AVT Universal Package (v2.1) installation. In that case you should start the AVT Universal Package installer again and click on "Repair". ---------------------------------------- Allied Vision Technical Support ---------------------------------------- Contact us: https://www.alliedvision.com/contact