Vimba X for Linux x86_64 Release Notes
Version: 2023-4
Summary
Main changes in this release:
New Vimba X Viewer feature: Sequencer tab (for firmware 13 and higher)
USB TL: Event support
Event example
Transport Layer |
Version |
---|---|
GigE Transport Layer (VimbaGigETL.cti) |
1.9.5* |
USB Transport Layer (VimbaUSBTL.cti) |
1.4.6* |
APIs |
Version |
---|---|
VmbC API (libVmbC.so) |
1.0.5* |
VmbCPP API (libVmbCPP.so) |
1.0.5* |
VmbPy API |
1.0.4* |
Image Transform Library (libVmbImageTransform.so) |
2.0.1* |
Tools |
Version |
---|---|
Vimba X Viewer |
1.3.0* |
Vimba X Firmware Updater |
2.0.3* |
Hardware requirements
PC or laptop with 64-bit x86 processor or better.
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 use the IP Configuration dialog of Vimba X Viewer to apply changes or to force the IP address.
Allied Vision USB cameras
A built-in USB 3.0 (or higher) controller for PCI Express bus is required.
Testing has been performed on host controllers that are based on Asmedia chip sets. The driver may run on host controllers that are based on chip sets from other vendors, too. If there are any problems please feel free to contact our Technical Support.
Tested platforms and cameras
Vimba X was tested with:
Ubuntu 22.04.3 LTS
Debian 12.2
Installation
To install Vimba X:
Uncompress the archive with the command tar -xf ./VimbaX.tgz to a directory you have writing privileges for like /opt. Under this directory, Vimba X will be installed in its own folder. In the following, we will refer to this path as [InstallDir].
Go to [InstallDir]/cti/and call (as needed, using sudo) VimbaGigETL_Install.sh and VimbaUSBTL_Install.sh.
Reboot your system.
If you have issues, see the Developer Guide, section Troubleshooting.
Vimba X Viewer: Vimba X Viewer can be found in[InstallDir]/bin.
Examples: Vimba X includes precompiled examples that you can find in: [InstallDir]/bin. Uncompiled examples are located in: [InstallDir]/api/examples.
Uninstalling Vimba X: To uninstall Vimba X, go to [InstallDir]/bin and run the uninstall scripts as super user. This prevents any GenTL consumer from loading the Vimba Transport Layers. Then remove the installation directory.
Known issues
The following issues are known:
When experiencing trouble with image acquisition, try to increase the priority of your application with “sudo -E nice -n -20
”.
Camera detection:
If multiple IP addresses are configured on one physical Ethernet adapter, then Vimba X sends GVCP discovery requests only to the last added IP address. Therefore, the camera is detected only if its IP address was added last.
Vimba X Viewer:
With some camera models, the message “Vimba X Viewer is not responding” appears for a few seconds when the camera is opened.
If the IP address is changed within the same network, the camera list doesn’t update automatically. Please click the Refresh button.
Sporadic issue: If a GigE camera was opened and then closed with Vimba X Viewer, it is displayed as locked and Vimba X Viewer does not open it again. Workaround: Close and open Vimba X Viewer.
Goldeye cameras: No inputs and outputs are shown on the Trigger IO tab.
Firmware Updater:
With some Alvium camera models, the firmware update may take up to 5 minutes.
Vimba X 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.
Load/Save Settings: Not all LUT settings are saved.
GigE Transport Layer:
GigE cameras may be listed on a wrong Ethernet interface.
If many dropped frames occur especially with a small ROI, set GVSP Timeout to a higher value.
Examples:
If a camera is already open, sometimes a misleading error message occurs (“Bad parameter”).
The ListFeatures example does not list all Interface features.
Sporadic issue of the AsynchronousGrab and Chunk example: stopping the stream causes an exception.
Changes and release history
Changes in Vimba X 2023-4
VmbC:
Added macOS support
VmbCPP:
Added macOS support
VmbPy:
Added macOS support
ImageTransform:
Added macOS support
USBTL:
Added macOS support
Added Event support
Vimba X Viewer:
Added macOS support
Added Sequencer tab
Vimba X Firmware Updater:
Added macOS support
GigETL:
Improved Adjust PacketSize
Changes in Vimba X 2023-2
VmbC:
Fixed: Open camera by IP may take 15s
Added Exclusive Access mode
VmbCPP:
Fixed: Open camera by IP may take 15s
VmbPy:
Fixed: Open camera by IP may take 15s
Fixed type hints for Python <=3.7.5 and =3.8.0
Updated AccessMode enum for consistency with VmbC
Added option for visibility level to list_features.py
Changes in Vimba X 2022-1
VmbC:
New API (similar, but not compatible to VimbaC)
VmbCPP:
New API (similar, but not compatible to VimbaCPP)
VmbPy:
New API (similar, but not compatible to VimbaPython)
Image Transform:
Added supported transformations (supports pixel formats of NET cameras)
Renamed VmbGetVersion to VmbGetImageTransformVersion
VmbSetImageInfoFromString: removed stringLength parameter
Vimba X Viewer:
New Viewer (based on Vimba Viewer)
Additional features: Chunk support, 5x5 Matrix, Scheduled Action commands
GigETL:
Display name: AVT GigE TL (instead of Vimba GigE TL)
Scheduled Action Commands support
Chunk support
USBTL:
Improved: standard conformity of resend for control channel commands
Display name: AVT USB TL (instead of Vimba USB TL)