Troubleshooting

Error codes

Error codes

Error Code

Value

Description

VmbErrorSuccess

0

No error

VmbErrorInternalFault

-1

Unexpected fault in Vmb or driver

VmbErrorApiNotStarted

-2

VmbStartup was not called before the current command

VmbErrorNotFound

-3

The designated instance (camera, feature, etc.)
cannot be found

VmbErrorBadHandle

-4

The given handle is not valid

VmbErrorDeviceNotOpen

-5

Device was not opened for usage

VmbErrorInvalidAccess

-6

Operation is invalid with the current access mode

VmbErrorBadParameter

-7

One of the parameters is invalid (usually an illegal pointer)

VmbErrorStructSize

-8

Given struct size is not valid for this API version

VmbErrorMoreData

-9

More data available in a string/list than space is provided

VmbErrorWrongType

-10

Wrong feature type for this access function

VmbErrorInvalidValue

-11

The value is not valid; either out of bounds or not an
increment of the minimum

VmbErrorTimeout

-12

Timeout during wait

VmbErrorOther

-13

Other error

VmbErrorResources

-14

Resources not available (e.g., memory)

VmbErrorInvalidCall

-15

Call is invalid in the current context (e.g. callback)

VmbErrorNoTL

-16

No transport layers are found

VmbErrorNotImplemented

-17

API feature is not implemented

VmbErrorNotSupported

-18

API feature is not supported

VmbErrorIncomplete

-19

The current operation was not completed (e.g. a multiple
registers read or write)

VmbErrorIO

-20

There was an error during read or write with devices
(camera or disk)

General issues

Transport layer not found

If the transport layer cannot be found:

Feature not usable

  • Install the latest camera firmware.

  • Vimba X only supports GenICam-compliant features, see About Vimba X.

Payloadsize issue

Stream features may contain additional Payloadsize information. For proper handling, use convenience function VmbPayloadSizeGet().

Vimba system functions

Vimba - Vimba X migration: To ensure GenICam compliance of Vimba X, most system functions of the Vimba SDK (such as GEV discovery, ForceIP, and Action Commands) are now TL (system) functions in Vimba X.

Issues by camera interface

GigE cameras

To use your GigE camera with best possible performance, follow the instructions in the User Guide of your camera.

We recommend using the Filter Driver of Vimba X. To check if the correct Filter driver is in use:

  1. Open your camera with Vimba X Viewer.

  2. Open the All tab and expand Stream 0.

  3. In the Settings, check that GVSP Driver Selector uses Filter.

  4. Expand Info and check that GVSP Filter Compatibility is “Matching”. If it is not Matching, use Vimba Driver Installer in the Vimba X install directory to install the latest Fiter Driver.

5 GigE Vision cameras

To get your 5 GigE Vision camera up and running, see the user guide/manual for your camera.

PacketSize

Make sure to set the PacketSize feature of GigE cameras to a value supported by your network card. If you use more than one camera on one interface, the available bandwidth has to be shared between the cameras.

  • GVSPAdjustPacketSize configures GigE cameras to use the largest possible packets.

  • DeviceThroughputLimit enables to configure the individual bandwidth if multiple cameras are used.

  • The maximum packet size might not be available on all connected cameras. Try to reduce the packet size.

Other issues

  • Access Mode “Config” is not available in this SDK. Please use IP Config instead.

  • By default, the Allied Vision GigE TL is set to Broadcast (instead of Discovery Once), which constantly consumes bandwidth. For a higher bandwidth, use Discovery Once every time you connect a GigE camera.

  • If the GigE Filter Driver installation via Driver Installer is not possible, please install it manually to your NIC.

USB cameras

Under Windows, make sure the correct driver is applied.

MIPI CSI-2 cameras

Compatible boards and driver

The camera driver must be installed before using Vimba. It is available for selected ARM boards and SOMS at https://github.com/alliedvision

Camera list

MIPI CSI-2 is not a plug and play interface. To update the cameras list, reboot the board.

Image acquisition

Make sure you use the latest firmware version. If you already have installed Vimba, you can use the included Firmware Updater. Or download it from https://www.alliedvision.com/en/support/software-downloads/

Typical Linux issues

Installation

Installation instructions are listed in the release notes for your operating system.

To install Vimba X for Linux, you need tar and the C runtime library glibc6 (version 2.27 or higher).

Transport layers not found

In most cases, Install.sh automatically registers the GENICAM_GENTL64_PATH environment variables in /etc/profile.d, so that every GenICam GenTL consumer can access the Vimba transport layers. If the transport layers are not found:

  • If multiple users work with the system, make sure all users can access /etc/profile.d.

  • If your display manager doesn’t support the install script (for example, lightdm and wdm): Please add the required environment variables to the /etc/environment file.

  • If login shell support is not supported, Install.sh in /etc/profile.d will not be loaded for X-Session. In this case, please copy the following line into the ~/.bashrc file and reboot. export GENICAM_GENTL64_PATH=$GENICAM_GENTL64_PATH: "/PATH_TO_VIMBAXFOLDER/VimbaGigETL/CTI/x86_64bit/"

Compiling

To compile the examples and the C++ API, you need:

  • CMake (>= 3.21)

  • make

  • g++ (>= 8.4.0)

  • Qt (5.15.x)

Technical support

Allied Vision provides technical support if you use Allied Vision cameras. We don’t offer technical support if a non-Allied Vision camera is used.

To get technical support, please go to:

https://www.alliedvision.com/en/about-us/contact-us/technical-support-repair-/-rma/