=========================================================================== Vimba for Windows - Release Notes Version: 6.0 Date: January 2022 =========================================================================== -------------------------------- Components and Version Reference -------------------------------- Driver ------ 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.7 (Windows 10 and Windows 11) Vimba USB Driver (vimba_usb.sys, vimba_usb_x64.sys) 1.0.0 Vimba GenICam Transport Layer modules ------------------------------------- GigE Transport Layer (VimbaGigETL.cti) 1.9.0 USB Transport Layer (VimbaUSBTL.cti) 1.4.1* 1394 Transport Layer (Vimba1394TL.cti) 1.6.0 CL Config Transport Layer (VimbaCLConfigTL.cti) 1.2.0 APIs ---- Vimba C API (libVimbaC.so) 1.9.1* Vimba C++ API (libVimbaCPP.so) 1.9.0 Vimba .NET API (VimbaNET.dll) 1.8.5 Vimba Python API (VimbaPython.so) 1.2.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.5.0 Vimba Class Generator (VimbaClassGenerator.exe) 1.0.6 Vimba Firmware Updater (VimbaFirmwareUpdater.exe) 1.2.0 Vimba Firmware Updater Console (FWUpdaterConsole.exe) 1.2.0 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 32-bit or 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 for Windows 64-bit: Windows 10 (version 21H2 and GigE, USB, 1394, and Camera Link cameras) Windows 11 (version 21H2 and GigE, USB, and 1394 cameras) Vimba for Windows 32-bit: Windows 10 (version 21H2 and GigE, USB, 1394, and Camera Link cameras) ------------ 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 including the .NET API, .NET Framework 4.x is required. Windows drivers are signed with sha256 due to new Microsoft requirements. To use the driver 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. 5 GigE Vision cameras: - Unplugging an USB device while the camera is streaming may cause lost frames, especially when the socket driver is used. 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. - Cognex VisionPro version 10 is not supported. 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. Vimba Documentation: - Some apps and browsers currently don't support relative links from one document to another document. We have successfully tested relative links with Adobe Acrobat. Vimba APIs: - When API startup and shutdown is performed excessively within the same process, camera initialization may fail sporadically, which may cause exceptions. We recommend to have only one API session during one process. --------------------------- Changes and release history --------------------------- Changes in Vimba 6.0.0: ----------------------- Note: The Vimba version was incremented to 6.0.0 because Vimba for ARM64 contains a CSI-2 transport layer. VimbaC - Fixed: Issue with null terminator for zipped XML files USBTL - Fixed: software trigger for multiple cameras VimbaPython: - Less restrictive C API version check Changes in Vimba 5.1.0: ----------------------- VimbaC - New feature: Support for Alloc And Announce frame allocation mode - Feature endianess related fixes (corresponding to GigE TL) VimbaCPP - New feature: Supports Alloc And Announce frame allocation mode VimbaNET - New target framework version: .NET 4.7.2 VimbaPython - New feature: Supports Alloc And Announce frame allocation mode Vimba Viewer - Supports Alloc And Announce frame allocation mode - Chinese localization - Supports changes of GigE TL and VimbaC - Fixed: IP labels not updated after changing the IP via GevCameraForceAddressSend - Fixed: Auto ROI tab always resets ROI at startup Firmware Updater - Supports Git hash representation Firmware Updater Console - Supports Git hash representation GigETL - Changed behaviour of endianess handling (values must match host endianness in little-endian), for better compatibility with third-party software. Affected features that now have a changed byte order: - Config Mode - IP-related features including MulticastIPAddress - Action Commands - New feature DeviceUpdateTimeout (only applicable if GigE discovery is switched to Broadcast) - New GVSPMaxLookBack default value (0 instead of 1) for improved packet resend handling - Fixed: High memory usage during performance bottleneck (Nonpaged pool growing with multiple GigE cameras) - Fixed: Action commands caused an error message in the console log - Fixed: Multicast IP address range, better compatibility with third-party software GigE Filter Driver - Reduced memory allocations - Hidden statistics USB TL - Fixed: Reset cameras streaming state when opened (Endpoint Halt) - Updated 3rd-party libraries Changes in Vimba 5.0.0: ----------------------- GigETL - New feature: GVSPHostReceiveBufferSize (SO_RCVBUF, usable with the socket driver only) replaces GVSPHostReceiveBuffers (which is still usable in existing applications). GigETL and GigE Filter Driver for Windows 10 - Fixed for 5 GigE cameras: - Vimba Viewer did not show single frame acquisitions - Improved timeout handling - Fixed limitations of certain GVSPPacketSize values (5 GigE) VimbaC - Fixed: Callbacks after stopping image acquisition caused exceptions in the Python API. - Fixed: ListAncillaryDataFeatures example (error "Could not queue frame") Vimba Firmware Updater - Prepared for CSI-2 support (supported ARM boards only) Vimba Firmware Updater Console - Prepared for CSI-2 support (supported ARM boards only) Vimba Viewer - Prepared for CSI-2 support (supported ARM boards only) Changes in Vimba 4.3.0: ----------------------- GigETL - Prepared for use with 5 GigE Vision cameras VimbaC - Prepared for use with 5 GigE Vision cameras VimbaCPP - Preparations for use with 5 GigE Vision cameras in the underlying VimbaC API Vimba NET - Preparations for use with 5 GigE Vision cameras in the underlying VimbaC API Vimba Python - Updated for use with new VimbaC version - Fixed: read_memory now returns all 0_bytes Vimba Firmware Updater - Preparations for use with 5 GigE Vision cameras Vimba Firmware Updater Console - Preparations for use with 5 GigE Vision cameras 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