AVT相机arm版本SDK

Vimba_6_0/Documentation/ReleaseNotes.txt

@@ -0,0 +1,605 @@
+===========================================================================
+
+  Vimba for Linux ARMv8 64-bit - Release Notes
+
+  Version: 6.0
+  Date:    January 2022
+===========================================================================
+
+--------------------------------
+Components and Version Reference
+--------------------------------
+
+Vimba GenICam Transport Layer modules
+-------------------------------------
+  CSI Transport Layer (VimbaCSITL.cti)                  1.0.1*
+  GigE Transport Layer (VimbaGigETL.cti)                1.9.0
+  USB Transport Layer (VimbaUSBTL.cti)                  1.4.1*
+
+APIs
+----
+  Vimba C API (libVimbaC.so)                            1.9.1*
+  Vimba C++ API (libVimbaCPP.so)                        1.9.0
+  Vimba Python API                                      1.2.1*
+  Image Transform Library (libVimbaImageTransform.so)   1.6.0
+
+Tools
+-----
+  Vimba Viewer (VimbaViewer)                            2.5.0
+  Vimba Class Generator (VimbaClassGenerator)           1.0.6
+  Vimba Firmware Updater (VimbaFirmwareUpdater.exe)     1.2.0
+  Vimba Firmware Updater Console (FWUpdaterConsole.exe) 1.2.0
+
+Third Party Libraries
+---------------------
+  TinyXML (not shipped with Vimba)                      2.6.2
+  Qt                                                    4.8.5
+  Qwt                                                   6.1.3
+  libTIFF                                               4.0.7
+  OpenCV                                                3.0.0  
+
+* Changed in this release of Vimba
+
+
+---------------------
+Hardware Requirements
+---------------------
+ARM board with ARMv8-compatible 64-bit processor
+
+Allied Vision GigE cameras require a built-in Gigabit Ethernet network interface
+or at least one Gigabit Ethernet network card.
+
+  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 require a built-in USB 3.0 controller for PCI Express bus.
+
+------------------------
+Tested Operating Systems
+------------------------
+Vimba was tested on NVIDIA Xavier NX with: 
+  - JetPack 4.6 (L4T 32.6.1) - GigE and USB cameras
+  - JetPack 4.5.1 (L4T 32.5.1) - CSI-2 cameras
+
+------------------------------------
+Prerequisites for CSI-2 camera users
+------------------------------------
+The driver for Allied Vision CSI-2 is not included in the Linux kernel provided 
+by the manufacturer of the board.
+Before installing Vimba, please install the driver, see:
+https://github.com/alliedvision 
+
+--------------------------------------
+Supported CSI-2 cameras and ARM boards
+--------------------------------------
+Supported CSI-2 camera models and ARM boards are listed in this document:
+https://alliedvision.com/fileadmin/content/documents/products/software/software/embedded/Getting_started_with_GenICam_for_CSI.pdf
+
+------------
+Installation
+------------
+Allied Vision Vimba comes as a tarball. In order to set up Vimba, follow these steps:
+
+  - Uncompress the archive with the command tar -xf ./Vimba.tgz to a
+    directory you have writing privileges for like /opt. Under this directory
+    Vimba will be installed in its own folder. In the following, we will refer
+    to this path as [InstallDir].
+  - Go to [InstallDir]/VimbaGigETL and/or [InstallDir]/VimbaUSBTL and execute the shell
+    script Install.sh with super user privileges (e.g., sudo ./Install.sh). This
+    registers the GENICAM_GENTL32_PATH and/or the GENICAM_GENTL64_PATH environment
+    variable through a startup script in /etc/profile.d so that every GenICam GenTL
+    consumer (such as the examples that ship with Allied Vision Vimba) can access the
+    Allied Vision Gigabit Ethernet and USB Transport Layers. Please note that this is a
+    per-user setting. If transport layers are not found, follow the instructions in this document:
+    https://alliedvision.com/fileadmin/content/documents/products/software/software/Vimba/appnote/Vimba_installation_under_Linux.pdf
+  - Reboot computer
+
+Vimba Viewer:
+Vimba Viewer can be found in, for example, [InstallDir]/Tools/Viewer/Bin/x86_64bit/.
+This program allows you to configure your Allied Vision cameras and capture images.
+Ubuntu 18.04 LTS: 
+  - To build Vimba Viewer, install the libcanberra-gtk-module
+    apt-get install libcanberra-gtk-module
+
+Vimba includes many precompiled examples that can be found in
+Vimba/VimbaC/Examples/Bin and Vimba/VimbaCPP/Examples/Bin.
+If you want to compile these examples yourself, please refer to the user manual
+for instructions and required packages.
+
+For uninstalling Vimba, remove the startup scripts by running the shell scripts
+Uninstall.sh as super user. This prevents any GenTL consumer from loading the
+Vimba and USB Transport Layers. Then simply remove the
+installation directory.
+
+
+------------
+Known Issues
+------------
+  - When experiencing trouble with image acquisition, try to increase the priority
+    of your application with "sudo -E nice -n -20 <command>".
+
+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.
+  - Not all ARM boards come with a GigE network interface. When acquiring images
+    with only 100 Mbit/s, make sure to set the "StreamBytesPerSecond" feature to
+    a reasonable small value (12 400 000). This adjustment is done automatically
+    when the camera is connected directly to a 100 Mbit/s interface.
+
+Tranport layers not found (Error -16):
+  - Please follow the instructions in this document:
+    https://alliedvision.com/fileadmin/content/documents/products/software/software/Vimba/appnote/Vimba_installation_under_Linux.pdf
+
+  - Vimba Firmware Updater and FWUpdaterConsole.exe:
+    Mako-U cameras are not detected after updating the firmware. 
+    To detect the camera, please reboot the board.
+
+Camera detection:
+  -  If multiple IP addresses are configured on one physical Ethernet adapter, 
+     then Vimba 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 Viewer:
+  - If a GigE camera was opened and then closed with Vimba Viewer, 
+    it is displayed as locked and Vimba Viewer does not open it again.
+    Workaround: Close and open 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.
+  - qt error: please install libpng12 if it is missing. See:
+    https://cdn.alliedvision.com/fileadmin/content/documents/products/software/software/Vimba/appnote/libpng-installation.pdf
+  - After streaming several hours, the displayed image is not updated. 
+    Changing camera settings results in a black image. Stopping and starting image acquisition
+    updates the displayed image. The issue affects only the displayed image, not the image itself.
+
+Vimba code examples
+  - qt error: please install libpng12 if it is missing. See:
+    https://cdn.alliedvision.com/fileadmin/content/documents/products/software/software/Vimba/appnote/libpng-installation.pdf
+
+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.
+
+CSI-2:
+  - Please use “alloc and announce” for best performance, see the AsynchrounousGrab example.
+    (C++: Program.Config.h, optional parameter /x, C: Program.c, optional parameter /x, Python: 
+    optional parameter /x). 
+  - Switching the camera from GenICam for CSI-2 to V4L2 or vice versa requires rebooting the board
+  - Exposure times greater than approx. 1 second: Stopping acquisition may cause an error. Please 
+    close and open the camera to start streaming again.
+  - Executing the Device Reset GenICam command leads to camera communication failures.
+  - Not all ROIs work when Mono8 is applied.
+  - When a ROI or a different pixel format is applied and the camera is closed and opened again, image 
+    acquisition doesn’t start in some cases. To enable image acquisition again, open the camera with 
+    Vimba Viewer (even if you set the ROI with a third-party viewer). In some cases, rebooting 
+    the board is necessary.
+  - Issues that may occur occasionally:
+      - AGX Xavier: Camera stays in locked state after camera handle is closed
+
+---------------------------
+Changes and release history
+---------------------------
+
+Changes in Vimba 6.0.0:
+-----------------------
+
+VimbaC
+  - Fixed: Issue with null terminator for zipped XML files
+
+CSITL
+  - First release (supported camera models and ARM boards and known issues: see above)
+
+USBTL
+  - Bug fix (relevant for Windows only)
+
+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
+
+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
+
+USB TL
+-  Updated 3rd-party libraries
+
+
+Changes in Vimba 5.0.0:
+-----------------------
+
+GigETL
+  - New feature: GVSPHostReceiveBufferSize (SO_RCVBUF) replaces GVSPHostReceiveBuffers 
+    (which is still usable in existing applications).
+  - Fixed for 5 GigE cameras: 
+      - Fixed limitations of certain GVSPPacketSize values
+
+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
+
+Vimba Firmware Updater Console
+  - Prepared for CSI-2 support
+
+Vimba Viewer
+  - Prepared for CSI-2 support
+
+
+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 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
+
+Vimba Viewer
+  - 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 Python
+  - Redirected the used Vimba version to the one delivered in this package.
+  - Install.sh suggests compatible Python interpreter versions only
+  - Install.sh and Uninstall.sh: Added support of virtual environments, Added debug flag 
+
+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)
+
+Vimba Viewer
+  - Added a dialog for enforcing IP settings to a GigE Vision camera
+
+
+Changes in Vimba 4.1.0:
+-----------------------
+
+USBTL
+  - Solved conflicts between customers' boost version and the internally used version
+  - Other internal bug fixes
+
+
+Changes in Vimba 4.0.0:
+-----------------------
+Vimba C
+  - Bug fixes
+
+Vimba C++
+  - 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
+
+GigETL
+  - GenTL 1.5 support
+
+USBTL
+  - GenTL 1.5 support
+
+Vimba Viewer
+  - Bug fixes
+
+
+Changes in Vimba 3.0:
+-----------------------
+Vimba C
+  - Bug fixes
+
+Vimba C++
+  - Bug fixes
+
+Vimba Viewer
+  - Supports Alvium USB cameras
+  - Fixed handling of float increments
+  - Fixed occasional crashes with high frame rates
+  - Several minor bug fixes
+
+GigETL
+  - Fixed: GVSPPacketSize now updates as expected
+
+USBTL
+  - Bug fixes
+
+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 Viewer
+  - New plugin architecture
+
+Vima Setup
+   - Removed Vimba Class Generator desktop symbol
+
+Vimba Manual
+   - Integrated Vimba Features Manual
+
+
+Changes in Vimba 2.1:
+---------------------
+Vimba C
+  - Added functionality for Action Commands.
+  - Bug fixes
+
+Vimba C++
+  - Added functionality for Action Commands.
+  - Bug fixes
+
+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 the IP address of each device.
+  - Bug fixes
+
+GigE Transport Layer
+  - The parameter BUFFER_INFO_DELIVERED_IMAGEHEIGHT is filled correctly.
+  - Added functionality of Action Commands.
+  - Bug fixes
+
+
+Changes in Vimba 2.0:
+---------------------
+Vimba Setup
+  - 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 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
+
+USB Transport Layer
+  - Minor bug fixes
+
+GigE Transport Layer
+  - Reworked and improved filter driver
+
+Vimba Class Generator
+  - Changes for Camera Link support (affects Windows only)
+
+Changes in Vimba 1.4.1:
+-----------------------
+Package for ARMv7
+  - Support of USB Transport Layer
+
+Package for other Linux systems
+  - Support of USB Transport Layer
+  - Improved documentation
+
+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
+  - Improved some examples
+  - Added and improved examples
+  - Bug fixes
+
+Vimba Image Transform Library
+  - Added support for PFNC 10p and 12p formats
+  - Improved the documentation
+
+GigE Transport Layer
+  - Improved stability on high traffic networks
+  - Bug fixes for multi-camera usage and incomplete cleanup
+  - Fixed range of GevHeartbeatInterval and GevHeartbeatTimeout
+
+Vimba Viewer
+  - Added open camera by ID
+  - Added endianness switch in direct register dialog
+  - Many bug fixes
+
+Vimba Class Generator
+  - Small improvements
+
+Changes in Vimba 1.3.0:
+-----------------------
+Package for ARMv7 (new)
+  - Support of Vimba C API
+  - Support of Vimba C++ API
+  - Support of GigE Transport Layer
+
+Package for other Linux systems
+  - Added a Vimba Tour document and a Vimba Quickstart Guide
+  - Improved the other documents
+  - Added examples for Vimba C and C++
+  - 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 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
+
+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
+
+Vimba Class Generator
+  - Minor changes to appearance and documentation
+
+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
+
+  
+----------------------------------------
+Allied Vision Technical Support
+----------------------------------------
+Contact us:
+https://www.alliedvision.com/contact