Common Vision Blox 15.0
•All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Events Friends Modules Pages
USB3 Vision - U3V

Table of Contents

Introduction

USB3 Vision is a machine vision standard, a protocol along with additional device condition, for discovering, controlling and streaming data from USB3 vision devices. USB3 Vision is based on USB3.0 standard and is compliant to GenICam standard. It defines the data package layout (protocol) and a bootstrap register map. It requires that the USB3 Vision devices include a description of the registers in XML format. USB3 Vision uses the GenICam GenApi device description for camera control.

USB3 Vision covers the following areas:

  •    Device detection
  •    Register access
  •    Streaming data
  •    Event handling

Furthermore USB3 Vision provides an interface to GenICam.

Driver

On Windows a device is automatically connected with the appropriate driver, and the user can begin working with it. On Linux there is a standard OS driver available. An optimized kernel module (driver) is available on request.

Connection to the USB3 Vision Device

System Requirements

  • USB external or on-board Host controller card with USB 3.0 or later ports.
  • USB 3.0 cable (maximum length 5m).
  • On Windows USB3 host controllers run using a Microsoft driver. No vendor driver should be required.

Device Connection

Device Connection and Hardware Information

The camera should be connected to an available USB 3.0 port on your local device. To verify the connection you can open GenICam Browser. If it shows the camera in green everythink is correct. If not you can use lsual.exe tool to check the device. It shows the device even if connected but not to a USB 3.x port or the wrong/no driver is installed.

Correctly recognized USB3 Vision cameras shown in GenICam Browser.




@indexedkeyword

lsual command tool USB3 Vision U3V

@endindexedkeyword

The lsual-command-tool can be used to access useful hardware informations and for troubleshooting problems. It shows:

  • a list of all connected devices.
  • device informations like device name, device model.
  • connection data like bus, address, port, connection speed.
  • takes actions like reseting the bus for the given device or uninstalling the driver.

This tool is available on Windows in the folder %CVB%Hardware\StemmerImaging\Utilities\lsual.exe.



The example below displays information when a JAI USB GO is connected.



Here the camera is using super speed (USB 3.0 / USB 3.1 Gen1) visible by the "super speed" output after the ID.

Troubleshooting with USB connection

If there are problems conneting to the device, lsual.exe tool can help checking the connection.

  1. Verify that the port you choose is indeed a USB 3.x port, as certain cameras may encounter difficulties when connected to USB 2.0 ports.
  2. Verify with lsual.exe if the speed is correct.

  3. Verify if the driver setup is correct. On Windows multiple drivers may be installed. Drivers are selected based on the hierarchy, and the CVB driver may not be chosen automatically.

    Check if the correct driver is installed. If no driver is shown in device manager select the one from Stemmer Imaging %CVB%Hardware\StemmerImaging\siu3v and install it. If another driver is listed in device manager, unistall it and install the correct one.

    @indexedkeyword

download driver USB U3V

USB U3V

@endindexedkeyword

Expand for a guide on how to load the driver in Windows

a. There is no driver currently selected







Browse to your CVB Install Path: %CVB%Hardware\StemmerImaging\siu3v





b. There is an incorrect driver selected

To resolve this issue, you should begin by uninstalling the device along with its driver. Once you have done so, disconnect reconnect the device to your computer, and it should automatically select the best suitable driver available. This may be the Stemmer Imaging driver, a Windows one or a third-party driver. If the wrong driver is selected, repeat the procedure until the Stemmer Imaging driver is chosen.






Stemmer-Imaging driver selected
Stemmer-Imaging driver

Once you have opened the Device Manager, proceed to locate your camera within the list of devices. If it is correctly recognized as “U3V Device via STEMMMER IMAGING GmbH using libusbK”, you can find the camera in the GenICam Browser.

Configuration

There are no user-configurable parameters available.

Performance Limitations

  • USB3 should be as near as possible to the mainboard (onboard).
  • Cable length is recommended no longer than 5m.
  • When the cable is not plugged in completely it might be recognized as USB2 since not all pins are connected.
  • For cameras with higher bandwidth a modern mainboard with a newer PCI Express version is needed.
  • Refer also the USB3 Vision System Requirements.